# BACH Schnellstart

**Version:** v3.9.1-tiramisu

## In 5 Minuten zum ersten BACH-Workflow

### 1. Installation (2 Minuten)

```bash
# 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

```bash
bach --startup
```

#### Tasks erstellen und verwalten

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

# Aufgaben anzeigen
bach task list

# Aufgabe erledigen
bach task done 1
```

#### Wissen speichern und abrufen

```bash
# 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

```bash
bach status
```

#### BACH beenden

```bash
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.

```bash
bach setup full-install
```

### Multi-System (OneDrive-Sync)
BACH in OneDrive, lokale Datenbank pro System, synchronisiert ueber ProSync.

```bash
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.

```bash
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/](system/skills/workflows/)

---

## Konfiguration

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

# Einstellungen anzeigen
bach config list

# Connectors auflisten
bach connector list
```

---

## Weiterfuehrende Dokumentation

- **[README.md](README.md)** - Vollstaendige Uebersicht
- **[Benutzerhandbuch](BACH_USER_MANUAL.md)** - Umfassendes Handbuch
- **[Skills-Katalog](SKILLS.md)** - Alle verfuegbaren Skills
- **[Agenten-Katalog](AGENTS.md)** - Alle verfuegbaren Agenten
- **[Installationsanleitung](system/docs/help/install.txt)** - Detaillierte Install-Doku

---

## 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

```bash
# Allgemeine Hilfe
bach --help

# Handler-spezifische Hilfe
bach help <handler>

# Dokumentation durchsuchen
bach docs search "suchbegriff"
```

---

English version: [QUICKSTART.md](QUICKSTART.md)
