Skip to content

Latest commit

 

History

History
177 lines (122 loc) · 3.67 KB

File metadata and controls

177 lines (122 loc) · 3.67 KB

BACH Schnellstart

Version: v3.9.1-tiramisu

In 5 Minuten zum ersten BACH-Workflow

1. Installation (2 Minuten)

# Repository klonen
git clone https://github.com/ellmos-ai/bach.git
cd bach

# Pre-Flight-Check ausfuehren
bach setup preflight

# Vollstaendige Installation (MCP-Server, Hooks, Secrets, User-Profil)
bach setup full-install

Hinweis: bach ist der CLI-Einstiegspunkt (system/bach.py). Falls bach nicht im PATH ist, stattdessen python system/bach.py verwenden.

2. Erste Schritte (3 Minuten)

BACH starten

bach --startup

Tasks erstellen und verwalten

# Neue Aufgabe anlegen
bach task add "Erstes BACH-Experiment"

# Aufgaben anzeigen
bach task list

# Aufgabe erledigen
bach task done 1

Wissen speichern und abrufen

# Fakt speichern
bach mem fact "API-Endpoint: https://api.example.com/v2"

# Fakten abrufen
bach mem read facts

# Wiki-Notiz schreiben
bach wiki write "bash-tricks" "Nuetzliche Bash-Befehle"

Systemstatus pruefen

bach status

BACH beenden

bach --shutdown

Wichtigste Kommandos

Kommando Beschreibung
bach --startup Session mit allen Subsystemen starten
bach --shutdown Sauberes Herunterfahren
bach status System-Gesundheitscheck
bach task list Offene Aufgaben anzeigen
bach mem read facts Gespeicherte Fakten durchsuchen
bach help <thema> Themenspezifische Hilfe
bach setup check Installation validieren

Deployment-Szenarien

BACH hat einen Installer. Die Konfiguration bestimmt den Deployment-Modus:

Einzelsystem (Standard)

Normales Setup, keine Synchronisation noetig.

bach setup full-install

Multi-System (OneDrive-Sync)

BACH in OneDrive, lokale Datenbank pro System, synchronisiert ueber ProSync.

bach setup full-install
bach setup prosync --multi-system

Server / Headless

BACH auf einem 24/7-Server (z.B. Mac Studio), Zugriff ueber Telegram, Web-UI oder Tray.

bach setup full-install
# Services starten:
# Telegram-Bot:  python hub/_services/chat/telegram_chat.py
# Web-GUI:       python gui/server.py --host 0.0.0.0
# System Tray:   python hub/_services/chat/chat_tray.py

Naechste Schritte

  1. Dokumentation erkunden: bach help list
  2. Agenten kennenlernen: bach agent list
  3. Skills durchsuchen: cat SKILLS.md
  4. Eigenen Workflow erstellen: Siehe skills/workflows/

Konfiguration

# Partner registrieren (Claude, Gemini, Ollama)
bach partner register claude

# Einstellungen anzeigen
bach config list

# Connectors auflisten
bach connector list

Weiterfuehrende Dokumentation


Tipps

  1. Kontextuelles Arbeiten: BACH merkt sich sessionuebergreifend, woran gearbeitet wird
  2. Automatisierung: Workflows fuer wiederkehrende Aufgaben nutzen
  3. Integration: Verbindung mit Claude, Gemini, Ollama oder OpenAI
  4. Backup: bach backup create fuer manuelle Sicherung (automatisch bei Shutdown)
  5. Hilfe: bach help <thema> fuer jeden Handler oder jedes Konzept

Hilfe bekommen

# Allgemeine Hilfe
bach --help

# Handler-spezifische Hilfe
bach help <handler>

# Dokumentation durchsuchen
bach docs search "suchbegriff"

English version: QUICKSTART.md