# BACH User Manual

Version: unknown Generiert: 2026-02-22 Lizenz: MIT

BACH ist ein textbasiertes Betriebssystem fuer KI-Assistenten. Es verbindet Mensch und KI durch eine persistente Middleware mit Gedaechtnis, Werkzeugen, Workflows und Multi-LLM-Support.

Dieses Handbuch beschreibt Installation, Nutzung und Erweiterung von BACH.

## 2. Uebersicht

# BACH - Textbasiertes Betriebssystem für LLMs

Version: unknown Status: Production-Ready Lizenz: MIT

## Überblick

BACH ist ein textbasiertes Betriebssystem, das Large Language Models (LLMs) befähigt, eigenständig zu arbeiten, zu lernen und sich zu organisieren. Es bietet eine umfassende Infrastruktur für Task-Management, Wissensmanagement, Automatisierung und LLM-Orchestrierung.

### Kernfunktionen

- 🤖 5 KI-Agenten - Spezialisierte Agenten für verschiedene Aufgabenbereiche
- 🛠️ 420 Tools - Umfangreiche Tool-Bibliothek für Dateiverarbeitung, Analyse, Automation
- 📚 940 Skills - Wiederverwendbare Workflows und Templates
- 🔄 0 Workflows - Vorgefertigte Prozess-Protokolle
- 💾 Wissensspeicher - 138 Lessons + 248 Facts

## Installation

#

#

#

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

    Abhängigkeiten installieren
    pip install -r requirements.txt

    BACH initialisieren
    python system/setup.py

## Quick Start

#

#

#

#

    BACH starten
    python bach.py --startup

    Task erstellen
    python bach.py task add "Analysiere Projektstruktur"

    Wissen abrufen
    python bach.py wiki search "Task Management"

    BACH beenden
    python bach.py --shutdown

## Hauptkomponenten

### 1. Task-Management

Vollständiges GTD-System mit Priorisierung, Deadlines, Tags und Context-Tracking.

### 2. Wissenssystem

Strukturiertes Memory-System mit Facts, Lessons und automatischer Konsolidierung.

### 3. Agenten-Framework

Boss-Agenten orchestrieren Experten für komplexe Aufgaben (Büro, Gesundheit, Produktion, etc.).

### 4. Bridge-System

Connector-Framework für externe Services (Telegram, Email, WhatsApp, etc.).

### 5. Automatisierung

Scheduler für wiederkehrende Tasks und Event-basierte Workflows.

## Dokumentation

- [Getting Started](docs/getting-started.md) - Erste Schritte mit BACH
- [API Reference](docs/reference/) - Vollständige API-Dokumentation
- [Skills Katalog](SKILLS.md) - Alle verfügbaren Skills
- [Agents Katalog](AGENTS.md) - Alle verfügbaren Agenten

## Lizenz

MIT License - siehe [LICENSE](LICENSE) für Details.

## Support

- Issues: [GitHub Issues](https://github.com/ellmos-ai/bach/issues)
- Discussions: [GitHub Discussions](https://github.com/ellmos-ai/bach/discussions)

Generiert mit `bach docs generate readme`

## 3. Schnellstart

# BACH Quickstart Guide

Version: unknown

## 🚀 In 5 Minuten zu Ihrem ersten BACH-Workflow

### 1. Installation (2 Minuten)

#

#

#

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

    Abhängigkeiten installieren
    pip install -r requirements.txt

    BACH initialisieren
    python system/setup.py

### 2. Erste Schritte (3 Minuten)

#### BACH starten

    python bach.py --startup

#### Task erstellen und verwalten

#

#

#

    Neue Aufgabe anlegen
    python bach.py task add "Erstes BACH-Experiment"

    Aufgaben anzeigen
    python bach.py task list

    Aufgabe erledigen
    python bach.py task done 1

#### Wissen speichern und abrufen

#

#

    Notiz ins Wiki schreiben
    python bach.py wiki write "bash-tricks" "Nützliche Bash-Befehle sammeln"

    Wissen suchen
    python bach.py wiki search "bash"

#### Memory-System nutzen

#

#

    Wichtigen Fakt speichern
    python bach.py mem write fact "Projekt-Deadline: 2024-12-31"

    Facts abrufen
    python bach.py mem read facts

#### BACH beenden

    python bach.py --shutdown

## 📚 Wichtigste Kommandos

## 🎯 Nächste Schritte

1. Dokumentation erkunden

       python bach.py docs list

2. Agenten kennenlernen

       python bach.py agent list

3. Skills durchsuchen

       cat SKILLS.md

4. Eigenen Workflow erstellen - Siehe: [Skills/_workflows/](skills/_workflows/) - Beispiele für wiederkehrende Aufgaben

## 🔧 Konfiguration

BACH passt sich automatisch an, aber Sie können anpassen:

- Partner konfigurieren: `python bach.py partner register claude`
- Settings ändern: `python bach.py config list`
- Connector einrichten: `python bach.py connector list`

## 📖 Weiterführende Dokumentation

- [README.md](README.md) - Vollständige Übersicht
- [API Reference](docs/reference/api.md) - Programmier-Interface
- [Skills Katalog](SKILLS.md) - Alle verfügbaren Skills
- [Agents Katalog](AGENTS.md) - Alle verfügbaren Agenten

## 💡 Tipps

1. Kontextuelles Arbeiten: BACH merkt sich, woran Sie arbeiten 2. Automatisierung: Nutzen Sie Workflows für wiederkehrende Aufgaben 3. Integration: Verbinden Sie BACH mit Claude, Gemini oder Ollama 4. Backup: Regelmäßig `python bach.py backup create`

## ❓ Hilfe bekommen

#

#

#

    Allgemeine Hilfe
    python bach.py --help

    Handler-spezifische Hilfe
    python bach.py  --help

    Dokumentation durchsuchen
    python bach.py docs search "keyword"

Generiert mit `bach docs generate quickstart`

Viel Erfolg mit BACH! 🎵

## 4. Befehle & Handler

## Befehle & Handler

BACH verfuegt ueber 97 Handler:

- bach abo -- Abo Handler - Abonnement-Verwaltung (Expert Agent)
- bach agents -- Agents Handler - Agenten-Verwaltung
- bach apibook -- Copyright (c) 2026 BACH Contributors
- bach ati -- ATI Handler - Advanced Tool Integration Agent
- bach bach_paths -- Copyright (c) 2026 BACH Contributors
- bach backup -- Backup Handler - Backup-Verwaltung
- bach bericht -- bericht.py - Foerderbericht-Handler
- bach calendar_handler -- Copyright (c) 2026 BACH Contributors
- bach chain -- Chain Handler - Ausfuehrung von verketteten Tool-Befehlen
- bach claude_bridge -- Copyright (c) 2026 BACH Contributors
- bach connections -- Connections Handler - Verbindungen und Actors-Model
- bach connector -- Copyright (c) 2026 BACH Contributors
- bach consolidation -- Consolidation Handler - Memory-Konsolidierung
- bach contact -- ContactHandler - Kontaktverwaltung CLI
- bach context -- Context Handler - Kontext-Suche und Longterm-Memory
- bach cookbook -- Copyright (c) 2026 BACH Contributors
- bach cv -- Copyright (c) 2026 BACH Contributors
- bach daemon -- Daemon Handler - Daemon-Service Verwaltung
- bach daily_agent -- Copyright (c) 2026 BACH Contributors
- bach data_analysis -- BACH Data Analysis Handler
- bach db -- DB Handler - Datenbank-Operationen (ersetzt Supabase MCP)
- bach db_sync -- Copyright (c) 2026 BACH Contributors
- bach denkarium -- Denkarium Handler - Logbuch + Gedanken-Sammler
- bach dist -- BACH Distribution Handler
- bach doc -- Copyright (c) 2026 BACH Contributors
- bach docs -- Docs Handler - Hauptdokumentation (Markdown + Legacy)
- bach docs_search -- Copyright (c) 2026 BACH Contributors
- bach email -- Copyright (c) 2026 BACH Contributors
- bach extensions -- Copyright (c) 2026 BACH Contributors
- bach folders -- BACH Folders CLI Handler
- bach fs -- Copyright (c) 2026 BACH Contributors
- bach gesundheit -- GesundheitHandler - Gesundheitsassistent CLI
- bach gui -- GUI Handler - Web-Server Verwaltung
- bach haushalt -- HaushaltHandler - Haushaltsmanagement CLI
- bach health -- Copyright (c) 2026 BACH Contributors
- bach help -- Help Handler - Zeigt Hilfe-Texte aus .txt Dateien
- bach hooks -- Copyright (c) 2026 BACH Contributors
- bach inbox -- BACH Inbox Handler v1.0
- bach inject -- Inject Handler - Injektor-Steuerung und Aufgaben-Zuweisung
- bach integration -- Integration Handler - LLM-Partner-Brücke
- bach lang -- Copyright (c) 2026 BACH Contributors
- bach lesson -- Lesson Handler - Lessons Learned Management
- bach logs -- Logs Handler - Log-Verwaltung
- bach maintain -- BACH Maintain Handler
- bach mem -- Mem Handler - Memory-Verwaltung
- bach memory -- Memory Handler - DB-basiertes Memory-Management
- bach messages -- Messages Handler - Nachrichtensystem CLI
- bach mount -- BACH Mount Handler
- bach multi_llm_protocol -- Multi-LLM Protocol Handler - Koordination paralleler Agenten
- bach news -- Copyright (c) 2026 BACH Contributors
- bach newspaper -- Copyright (c) 2026 BACH Contributors
- bach notify -- Copyright (c) 2026 BACH Contributors
- bach obsidian -- Copyright (c) 2026 BACH Contributors
- bach ollama -- Ollama Handler - Lokale AI-Interaktion
- bach partner -- Partner Handler - Partner-Verwaltung
- bach partner_config_manager -- PartnerConfigManager - LLM-Partner-Konfiguration
- bach path -- Copyright (c) 2026 BACH Contributors
- bach pipeline -- Pipeline-Handler für BACH
- bach plugins -- Copyright (c) 2026 BACH Contributors
- bach press -- Copyright (c) 2026 BACH Contributors
- bach profile -- Copyright (c) 2026 BACH Contributors
- bach profiler -- Copyright (c) 2026 BACH Contributors
- bach recurring -- BACH Recurring Tasks Handler v1.0.0
- bach reflection -- Copyright (c) 2026 BACH Contributors
- bach restore -- File Restore Handler (SQ020/HQ6)
- bach routine -- RoutineHandler - Household Routine Management CLI
- bach sandbox -- Copyright (c) 2026 BACH Contributors
- bach scan -- Scan Handler - Scanner-Verwaltung
- bach seal -- Kernel Seal Handler (SQ021)
- bach search -- SearchHandler - Unified Search CLI for BACH
- bach secrets -- secrets_handler.py — Secrets-Management Handler (SQ076)
- bach session -- SessionHandler - Session-Verwaltung fuer BACH
- bach settings -- Settings Handler - Systemeinstellungen verwalten
- bach shared_memory -- Shared Memory Handler - Multi-Agent Memory-Verwaltung (SQ043
- bach shutdown -- Shutdown Handler - Session beenden (DB-basiert)
- bach skills -- Skills Handler - Skill-Verwaltung (v2.0 Architektur)
- bach smarthome -- Copyright (c) 2026 BACH Contributors
- bach snapshot -- Snapshot Handler - Session-Snapshot-Verwaltung
- bach sources -- Sources Handler - Kontextquellen-System
- bach startup -- Startup Handler - Session starten (DB-basiert)
- bach status -- Status Handler - Schnelle System-Uebersicht
- bach steuer -- Steuer Handler - Steuerbelegs-Verwaltung
- bach sync -- Sync Handler - Dateisystem zu DB Synchronisation
- bach task -- TaskHandler - Task-Verwaltung fuer BACH
- bach test -- BACH Test Handler
- bach time -- Time Handler - CLI fuer Zeit-System
- bach tokens -- Tokens Handler - Token-Tracking
- bach tools -- Tools Handler - Tool-Verwaltung
- bach trash -- BACH Trash Handler
- bach tuev -- TUeV Handler - Workflow-Qualitaetssicherung
- bach update -- Copyright (c) 2026 BACH Contributors
- bach upgrade -- Copyright (c) 2026 BACH Contributors
- bach versicherung -- Copyright (c) 2026 BACH Contributors
- bach watcher -- Copyright (c) 2026 BACH Contributors
- bach web_parse -- Copyright (c) 2026 BACH Contributors
- bach web_scrape -- Copyright (c) 2026 BACH Contributors
- bach wiki -- Wiki Handler - Wiki-Artikel aus wiki/ anzeigen

## 5. Skills & Protokolle

# BACH Skills-Katalog

Anzahl: 940 Skills Generiert: Automatisch aus der Skills-Datenbank

## Übersicht

Dieser Katalog listet alle verfügbaren Skills auf, gruppiert nach Typ.

### Skills nach Typ

- agent: 24 Skills
- definition: 2 Skills
- expert: 28 Skills
- extension: 38 Skills
- file: 711 Skills
- os: 1 Skills
- profile: 9 Skills
- protocol: 25 Skills
- service: 48 Skills
- skill: 46 Skills
- template: 8 Skills

## AGENT (24)

### `agent/README`

### `agent/ati/ATI`

Kategorie: ati >

### `agent/ati/ATI_PROJECT_BOOTSTRAPPING`

Kategorie: ati >

### `agent/ati/README`

Kategorie: ati

### `agent/ati/_policies/POLICIES_README`

Kategorie: ati

### `agent/ati/modules/README`

Kategorie: ati

### `agent/ati/prompt_templates/analysis_prompt`

Kategorie: ati

### `agent/ati/prompt_templates/review_prompt`

Kategorie: ati

### `agent/ati/prompt_templates/task_prompt`

Kategorie: ati

### `agent/ati/session/DEPRECATED`

Kategorie: ati

### `agent/bewerbungsexperte`

>

### `agent/bueroassistent`

>

### `agent/entwickler`

>

### `agent/förderplaner`

>

### `agent/gesundheitsassistent`

>

### `agent/haushaltsmanagement`

### `agent/persoenlicher-assistent`

>

### `agent/production`

>

### `agent/psycho-berater`

### `agent/research`

### `agent/steuer-agent`

>

### `agent/test-agent`

### `agent/versicherungen`

>

### `test-agent-x`

BACH agent: test-agent-x

## DEFINITION (2)

### `SKILL_AGENT_OS_DEFINITIONS`

Kategorie: core Core skill definition: SKILL_AGENT_OS_DEFINITIONS

### `SKILL_ANALYSE`

Kategorie: core Core skill definition: SKILL_ANALYSE

## EXPERT (28)

### `aboservice`

Kategorie: _experts aboservice

### `data-analysis`

Kategorie: _experts data-analysis

### `expert/_mediaproduction/musik`

Kategorie: _mediaproduction

### `expert/_mediaproduction/podcast`

Kategorie: _mediaproduction

### `expert/_mediaproduction/video`

Kategorie: _mediaproduction

### `expert/_textproduction/pr`

Kategorie: _textproduction

### `expert/_textproduction/storys`

Kategorie: _textproduction

### `expert/_textproduction/text`

Kategorie: _textproduction

### `expert/aboservice/CONCEPT`

Kategorie: aboservice

### `expert/aboservice/README`

Kategorie: aboservice

### `expert/data-analysis/CONCEPT`

Kategorie: data-analysis

### `expert/financial_mail/CONCEPT`

Kategorie: financial_mail

### `expert/foerderplaner/foerderplaner`

Kategorie: foerderplaner >

### `expert/gesundheitsverwalter/CONCEPT`

Kategorie: gesundheitsverwalter

### `expert/haushaltsmanagement/CONCEPT`

Kategorie: haushaltsmanagement

### `expert/haushaltsmanagement/aufgaben`

Kategorie: haushaltsmanagement

### `expert/mr_tiktak/CONCEPT`

Kategorie: mr_tiktak

### `expert/psycho-berater/CONCEPT`

Kategorie: psycho-berater

### `expert/psycho-berater/rolle`

Kategorie: psycho-berater

### `expert/report_generator/report_generator`

Kategorie: report_generator >

### `expert/steuer/steuer-agent`

Kategorie: steuer >

### `expert/wikiquizzer/CONCEPT`

Kategorie: wikiquizzer

### `financial_mail`

Kategorie: _experts financial_mail

### `gesundheitsverwalter`

Kategorie: _experts gesundheitsverwalter

### `health_import`

Kategorie: _experts health_import

### `mr_tiktak`

Kategorie: _experts mr_tiktak

### `test-tool-demo`

... (3483 weitere Zeilen, siehe SKILLS.md)

## 6. Agenten & Experten

# BACH Agents & Experts

Generiert: 2026-02-22 13:53 Quelle: bach.db (bach_agents, bach_experts) Generator: `bach export mirrors` oder `python tools/agents_export.py`

## Boss-Agenten (Orchestrierer)

Boss-Agenten orchestrieren komplexe Workflows und delegieren an Experten.

### Entwickler Agent (ATI)

- Name: ati
- Typ: Expert
- Kategorie: None
- Pfad: `None`
- Status: active
- Version: 1.2.0
- Beschreibung: Spezialisiert auf Tool-Ueberwachung und Software-Entwicklung.

### Bueroassistent

- Name: bueroassistent
- Typ: boss
- Kategorie: beruflich
- Pfad: `agents/bueroassistent.txt`
- Status: active
- Version: 1.0.0
- Beschreibung: Steuern, Foerderplanung, Dokumentation

### Finanzassistent

- Name: finanz-assistent
- Typ: assistant
- Kategorie: beruflich
- Pfad: `None`
- Status: active
- Version: 1.0.0
- Beschreibung: Financial Mails, Abos, Versicherungen

### Gesundheitsassistent

- Name: gesundheitsassistent
- Typ: boss
- Kategorie: privat
- Pfad: `agents/gesundheitsassistent.txt`
- Status: active
- Version: 1.0.0
- Beschreibung: Medizinische Dokumentation und Gesundheitsverwaltung

### Persoenlicher Assistent

- Name: persoenlicher-assistent
- Typ: boss
- Kategorie: privat
- Pfad: `agents/persoenlicher-assistent.txt`
- Status: active
- Version: 1.0.0
- Beschreibung: Terminverwaltung, Recherche, Organisation

## Experten (Spezialisierte Ausführer)

Experten führen spezifische Aufgaben aus und werden von Boss-Agenten delegiert.

### Abo-Service

- Name: aboservice
- Domain: finanzen
- Pfad: `None`
- Status: active
- Version: 1.0.0

### Bewerbungsexperte

- Name: bewerbungsexperte
- Domain: karriere
- Pfad: `None`
- Status: active
- Version: 1.0.0

### Daten-Analyse

- Name: data-analysis
- Domain: analytik
- Pfad: `None`
- Status: active
- Version: 1.0.0

### Decision-Briefing

- Name: decision-briefing
- Domain: None
- Pfad: `agents\_experts\decision-briefing\CONCEPT.md`
- Status: active
- Version: 1.0.0
- Beschreibung: Der Decision-Briefing-Experte ist das zentrale System für ausstehende Entscheidungen und User-Aufgaben in BACH. Er:

### Finanz-Mails

- Name: financial_mail
- Domain: finanzen
- Pfad: `None`
- Status: active
- Version: 1.0.0

### Foerderplaner

- Name: foerderplaner
- Domain: paedagogik
- Pfad: `agents/_experts/foerderplaner/`
- Status: active
- Version: 1.0.0
- Beschreibung: ICF-Foerderplanung, Material-Recherche

### Gesundheitsverwalter

- Name: gesundheitsverwalter
- Domain: gesundheit
- Pfad: `agents/_experts/gesundheitsverwalter/`
- Status: active
- Version: 1.0.0
- Beschreibung: Arztberichte, Laborwerte, Medikamente

### Haushaltsmanagement

- Name: haushaltsmanagement
- Domain: haushalt
- Pfad: `agents/_experts/haushaltsmanagement/`
- Status: active
- Version: 1.0.0
- Beschreibung: Haushaltsbuch, Inventar, Einkaufslisten

### Health-Import

- Name: health_import
- Domain: gesundheit
- Pfad: `None`
- Status: active
- Version: 1.0.0

### Termin-Optimierer

- Name: mr_tiktak
- Domain: zeit
- Pfad: `None`
- Status: active
- Version: 1.0.0

### Psycho-Berater

- Name: psycho-berater
- Domain: psychologie
- Pfad: `agents/_experts/psycho-berater/`
- Status: active
- Version: 1.0.0
- Beschreibung: Therapeutische Gespraeche, Sitzungsprotokolle

### Bericht-Generator

- Name: report_generator
- Domain: dokumentation
- Pfad: `None`
- Status: active
- Version: 1.0.0

### Steuer-Experte

- Name: steuer-agent
- Domain: finanzen
- Pfad: `agents/_experts/steuer/`
- Status: active
- Version: 1.0.0
- Beschreibung: Steuerbelege, Werbungskosten

### Transkriptions-Service

- Name: transkriptions-service
- Domain: medien
- Pfad: `agents/_experts/transkriptions-service/`
- Status: active
- Version: 1.0.0
- Beschreibung: Audiodateien und Gespraeche transkribieren, Sprecher erkennen, bereinigen, exportieren

### Wiki-Lernhilfe

- Name: wikiquizzer
- Domain: bildung
- Pfad: `None`
- Status: active
- Version: 1.0.0

## Status-Kategorien

- FUNCTIONAL: Voll funktionsfähig, produktionsbereit
- PARTIAL: Grundfunktionen vorhanden, aber unvollständig
- SKELETON: Struktur vorhanden, aber Implementierung fehlt weitgehend

## Charakter-Modell (ENT-41)

Jeder Boss-Agent hat eine `## Charakter` Section in seiner SKILL.md:

- Ton: Wie kommuniziert der Agent?
- Schwerpunkt: Woran orientiert er sich?
- Haltung: Welche Werte vertritt er?

Siehe: BACH_Dev/MASTERPLAN_PENDING.txt → SQ049 Agenten-Audit & Upgrade

## Arbeitsprinzipien

Alle Agenten folgen den globalen Arbeitsprinzipien aus Root-SKILL.md:

- Unterscheiden was eigen, was fremd
- Text ist Wahrheit
- Erst lesen, dann ändern
- Keine Duplikate erzeugen
- Flexibel auf User-Korrekturen reagieren

## Nutzung

#

#

#

#

    Boss-Agent starten (mit Partner-Delegation)
    bach agent start bueroassistent --partner=claude-code

    Experten direkt aufrufen (falls erlaubt)
    bach expert run bewerbungsexperte --task="Anschreiben für Stelle X"

    Agent-Liste anzeigen
    bach agent list

    Expert-Liste anzeigen
    bach expert list

## Datei-Synchronisation

Diese Datei wird automatisch generiert aus:

- `bach_agents` (Tabelle für Boss-Agenten)
- `bach_experts` (Tabelle für Experten)

Trigger:

- `bach --shutdown` (via finalize_on_idle)
- `bach export mirrors` (manuell)

dist_type: 1 (TEMPLATE) - resetbar, aber anpassbar

## Siehe auch

- PARTNERS.md - LLM-Partner und Delegation
- USECASES.md - Anwendungsfälle
- WORKFLOWS.md - 25 Protocol-Skills als Index
- CHAINS.md - Toolchains

## 7. LLM-Partner

# BACH Partners

Automatisch generiert aus der Datenbank (delegation_rules, partner_recognition, interaction_protocols). Letzte Aktualisierung: 2026-02-22 13:53

## Delegation Rules

Total: 4 Regeln

### Zone: zone_1

- zone_1_full_access ⭐⭐⭐

- Voller Zugang: Alle Partner verfuegbar, optimale Qualitaet - Preferred: Claude

### Zone: zone_2

- zone_2_moderate ⭐⭐⭐

- Moderate Sparsamkeit: Bevorzuge kostenguenstige Partner - Preferred: Ollama

### Zone: zone_3

- zone_3_conservative ⭐⭐

- Konservativ: Nur lokale Partner (Ollama) bevorzugt - Preferred: Ollama

### Zone: zone_4

- zone_4_emergency ⭐

- Notfall: Nur Eskalation oder lokale Verarbeitung - Preferred: Human

## Partner Recognition

Total: 10 Partner

- Claude (api) ✓

- Zone: zone_1 | Cost: $$$ | Priority: 100 - Capabilities: ["general", "coding", "analysis", "writing"]

- Ollama (local) ✓

- Zone: zone_3 | Cost: $ | Priority: 80 - Capabilities: ["coding", "general"]

- Gemini (api) ✓

- Zone: zone_1 | Cost: $$ | Priority: 70 - Capabilities: ["general", "research", "coding"]

- Copilot (api) ✓

- Zone: zone_2 | Cost: $$ | Priority: 60 - Capabilities: ["coding", "completion"]

- ChatGPT (api) ✓

- Zone: zone_1 | Cost: $$$ | Priority: 50 - Capabilities: ["general", "writing"]

- Perplexity (api) ✓

- Zone: zone_2 | Cost: $$ | Priority: 40 - Capabilities: ["research", "search"]

- Mistral (api) ✓

- Zone: zone_2 | Cost: $$ | Priority: 30 - Capabilities: ["coding", "general"]

- Anthropic-Local (local) ✗

- Zone: zone_4 | Cost: $ | Priority: 20 - Capabilities: ["general"]

- Custom-Agent (local) ✗

- Zone: zone_4 | Cost: $ | Priority: 10 - Capabilities: ["custom"]

- Human (human) ✓

- Zone: zone_4 | Cost: $ | Priority: 5 - Capabilities: ["review", "decision", "escalation"]

## Interaction Protocols

Total: 10 Protokolle

### confirmation

#### receipt

Empfangsbestaetigung

- Timeout: 60s | Retries: 3 | Priority: 50

### delegation

#### task_delegation

Aufgabe an Partner delegieren

- Timeout: 300s | Retries: 3 | Priority: 90
- Applicable Partners: ["Claude", "Ollama", "Copilot"]

### discovery

#### compare

Vergleich: Was hat der Partner was ich nicht habe

- Timeout: 60s | Retries: 3 | Priority: 50

#### handshake

Gegenseitige Erkennung zwischen Instanzen

- Timeout: 60s | Retries: 3 | Priority: 50

### escalation

#### human_escalation

Eskalation an Benutzer

- Timeout: 60s | Retries: 3 | Priority: 50
- Applicable Partners: ["Human"]

### query

#### simple_query

Einfache Frage-Antwort

- Timeout: 30s | Retries: 2 | Priority: 100
- Applicable Partners: ["Claude", "Ollama", "Gemini", "ChatGPT", "Mistral"]

#### code_review

Code-Review anfordern

- Timeout: 120s | Retries: 2 | Priority: 80
- Applicable Partners: ["Claude", "Copilot", "ChatGPT"]

#### research_query

Recherche-Anfrage

- Timeout: 180s | Retries: 3 | Priority: 70
- Applicable Partners: ["Perplexity", "Claude", "Gemini"]

### transfer

#### request

Import-Anfrage an Partner

- Timeout: 60s | Retries: 3 | Priority: 50

#### transfer

Datenuebertragung zwischen Partnern

- Timeout: 60s | Retries: 3 | Priority: 50

## 8. Workflows

# BACH Workflows

Automatisch generiert aus dem Dateisystem (skills/workflows/). Letzte Aktualisierung: 2026-02-22 13:53

Total: 29 Workflows

## Analysis

### Workflow: Dokumenten-Anforderungsanalyse

Version: 1.2.0

Datei: `skills/workflows/analysis\docs-analyse.md`

### Workflow: Help-Expert-Review

Version: 1.4.0

Datei: `skills/workflows/analysis\help-expert-review.md`

### Workflow: Help-Forensik

Version: 1.0.0

Datei: `skills/workflows/analysis\help-forensic.md`

### Skill-Abdeckungsanalyse Workflow

Zweck: Systematische Analyse der BACH Skill-Abdeckung im Vergleich zu Industrie-Standards.

Datei: `skills/workflows/analysis\skill-abdeckungsanalyse.md`

### Workflow: Wiki-Autoren

Version: 2.0.0

Datei: `skills/workflows/analysis\wiki-author.md`

## Dev

### Bugfix-Protokoll für Python/PyQt6 Projekte

> Ziel: Systematisches Vorgehen bei Bugs, um Zeit zu sparen und bekannte Probleme schnell zu erkennen.

Datei: `skills/workflows/dev\bugfix-protokoll.md`

### CLI-Änderungs-Checkliste

Version: 1.0

Datei: `skills/workflows/dev\cli-aenderung-checkliste.md`

### BACH Entwicklungszyklus (Dev-Zyklus)

> Ziel: Strukturierter Ablauf von Feature-Wunsch bis validiertem System.

Datei: `skills/workflows/dev\dev-zyklus.md`

### Workflow: Datei-Umbenennung mit Wrapper (Evolutionaere Migration)

Version: 1.0.0

Datei: `skills/workflows/dev\migrate-rename.md`

### MCP Server Release Protokoll (NPM + GitHub)

> Ziel: Strukturierter Ablauf fuer das Veroeffentlichen von BACH MCP Servern auf GitHub und NPM.

Datei: `skills/workflows/dev\npm-mcp-publish.md`

### Workflow: Ordner-Flattening

Ziel: Verschachtelte Ordnerstrukturen in eine flache, maschinenlesbare Struktur überführen.

Datei: `skills/workflows/dev\ordner-flattening.md`

### Self-Extension Workflow

> Ziel: BACH autonome Selbsterweiterung durch KI-Partner (Claude, Gemini, etc.)

Datei: `skills/workflows/dev\self-extension.md`

### Service/Agent Validator Workflow

Qualitätsprüfung für neue Services, Agents und Experts im BACH-System.

Datei: `skills/workflows/dev\service-agent-validator.md`

## Integration

### Agent/Skill Finder Workflow

Finde den passenden Agenten, Experten oder Skill für eine Benutzeranfrage.

Datei: `skills/workflows/integration\agent-skill-finder.md`

### Gemini Delegation Workflow

> Delegiere ressourcenintensive Tasks an Google Gemini

Datei: `skills/workflows/integration\gemini-delegation.md`

### Google Drive Delegation Workflow - SKILL v1.0

Multi-AI Kollaboration via Google Drive als Shared Workspace.

Datei: `skills/workflows/integration\google-drive.md`

## System

### Claude-Bach-Vernetzung

name: claude-bach-vernetzung

Datei: `skills/workflows/system\claude-bach-vernetzung.md`

### Cross-System-Sync

name: cross-system-sync

Datei: `skills/workflows/system\cross-system-sync.md`

### System-Anschlussanalyse: Integration & Konsistenz

Version: 1.0

Datei: `skills/workflows/system\system-anschlussanalyse.md`

### System-Aufräumen: Wartung und Archivierung

Version: 1.0

Datei: `skills/workflows/system\system-aufraeumen.md`

### System-Mapping: Kartographie und Feature-Erfassung

Version: 1.0

Datei: `skills/workflows/system\system-mapping.md`

### System-Synopse: Vergleichende Analyse

Version: 1.0

Datei: `skills/workflows/system\system-synopse.md`

### System-Testverfahren: B/O/E-Tests

Version: 1.0

Datei: `skills/workflows/system\system-testverfahren.md`

### Trampelpfadanalyse & Schwarm-Verfahren (Elephant Path / Swarm Ops)

Version: 2.0

Datei: `skills/workflows/system\trampelpfadanalyse.md`

## Workflows

### Cv-Generierung

name: cv-generierung

Datei: `skills/workflows/cv-generierung.md`

### 🧠 Model-Switching Strategie V2

> Version: 2.0.0

Datei: `skills/workflows/ing-strategie.md`

### Standardaufnahmeverfahren für neue Software-Projekte

Version: 1.0

Datei: `skills/workflows/projekt-aufnahme.md`

### Synthese-Workflow: Neues System aus Best-of

Version: 1.0

Datei: `skills/workflows/synthese.md`

### Batch-Übersetzung mit Haiku (EN/DE/Multi-Language)

> Ziel: Systematische Übersetzung von BACH-Komponenten (help, wiki, skills) in mehrere Sprachen mit Claude Haiku (kostengünstig, schnell).

Datei: `skills/workflows/translate_haiku.md`

## 9. Anwendungsfaelle

# BACH Usecases

Automatisch generiert aus der Datenbank (usecases). Letzte Aktualisierung: 2026-02-22 13:53

Total: 50 Usecases

## ASSISTENT

### ○ Charaktersheet ueber User pflegen ⭐⭐⭐⭐

Lernende Praeferenzen, Eigenheiten, Beduerfnisse des Users dokumentieren und beruecksichtigen.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Dossier oder Briefing erstellen ⭐⭐⭐⭐

Vor Meetings: Person/Thema recherchieren und strukturiert aufbereiten.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Kalender fuehren ⭐⭐⭐⭐

Termine, Aufgaben, Orte, Personen, Buchungen verwalten und aktuell halten.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Tagesablauf-Briefing Morgens ⭐⭐⭐⭐

Termine des Tages, offene Themen, wichtige Briefings bei besonderen Terminen praesentieren.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Location Restaurant Hotel suchen ⭐⭐

Orte mit Kontaktdaten und Oeffnungszeiten finden. Passende Locations vorschlagen.

Letzter Test: 2026-02-21 22:36:11 | Score: 50/100

### ○ Reiseroute planen ⭐⭐

Zugverbindungen, Hotels suchen und zusammenstellen. Buchungslinks bereitstellen.

Letzter Test: 2026-02-21 22:36:11 | Score: 50/100

## CARE-MODUL

### ○ Arzttermine und Erinnerungen verwalten ⭐⭐⭐⭐

Termine bei Aerzten speichern und auf Nachfrage zurueckgeben. Erinnerungsfunktion.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Medikamentenplan aktuell halten ⭐⭐⭐⭐

Aktueller Medikationsplan aus Berichten + User-Korrektur. Name, Wirkstoff, Menge, Tageszeit, Wirkung.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Vorsorgeplan verwalten ⭐⭐⭐⭐

Vorsorgeuntersuchungen mit Status tracken: Hautscreening, Zahnarzt, Impfungen, Blutuntersuchung, Check-Up.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

## DATENMODUL

### ○ Diagnosen und Hypothesen verwalten ⭐⭐⭐⭐

Diagnosen kategorisieren: gesichert/Verdacht/Hypothese/widerlegt mit Belegen. Belegsammlungen fuehren.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Medikamentationsverlauf fuehren ⭐⭐⭐⭐

Medikamente tracken: Start, Ende, Dosierung, Grund, Wirkung, Nebenwirkungen ueber Zeit.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Untersuchungsplan erstellen ⭐⭐⭐⭐

Ausstehende/empfohlene Diagnostik aus Diagnosen und Verdachtsdiagnosen ableiten. Priorisiert nach Wichtigkeit.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Symptomabdeckung analysieren ⭐⭐

Welche Diagnosen erklaeren welche Symptome? Ueberschneidungen? Rest-Symptome ohne Erklaerung? Prozentsatz.

Letzter Test: 2026-02-21 22:36:11 | Score: 50/100

### ○ Symptomverlauf dokumentieren ⭐⭐

Symptome ueber Zeit tracken: Auftreten, Verschwinden, Verbesserung, Verschlechterung. Aktiv/Inaktiv Status.

Letzter Test: 2026-02-21 22:36:11 | Score: 50/100

## DOKUMENTENMODUL

### ○ Medizin-Dokumentenverzeichnis aktualisieren ⭐⭐⭐⭐

Neue PDFs erkennen, kategorisieren (Wissen/Patient), ins Verzeichnis aufnehmen. Pruefen ob Dokumente hinzugekommen oder geloescht wurden.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

## FINANZEN

### ○ Wiederkehrende jaehrliche Kosten planen ⭐⭐⭐⭐

Monatliche Uebersicht irregularer jaehrlicher Kosten (KFZ, TUeV, Uni, Versicherungen, Rundfunk). Quelle: Wiederkehrende Kosten Uebersicht.docx

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

## GESUNDHEIT

### ○ Medikamente Uebersicht fuehren ⭐⭐⭐⭐

Aktuelle Medikation mit Dosierung, Einnahmezeit, Wirkung. Aus Arztberichten extrahieren. Quelle: Medikamente Uebersicht.pdf

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

## HAUSHALT

### ○ Haushaltsaufgaben nach Turnus verwalten ⭐⭐⭐⭐⭐

Taeglich/woechentlich/monatlich/vierteljaehrlich/halbjaehrlich/jaehrlich - Aufgaben tracken mit Status zuletzt erledigt. Quelle: Haushaltsaufgaben von taeglich bis jaehrlich.docx

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

## KARRIERE

### ○ Berufsziele und Kernkomplexe verfolgen ⭐⭐⭐⭐

3 Kernkomplexe: Lerntherapie-Praxis, Lehramt Sonderpaedagogik, Software-Nebenerwerb. Qualifikationswege tracken. Quelle: Berufsziele_Kernkomplexe.docx

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Fortbildungen und Selbststudium dokumentieren ⭐⭐⭐⭐

Weiterbildungen, Zertifikate, Kurse mit Datum und Status erfassen. Quelle: Dokumentation Fortbildungen.docx

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

## SELBSTMANAGEMENT

### ○ ADHS-Strategien anwenden ⭐⭐⭐⭐⭐

Wiederverwendbare Listen, Body Doubling, Planungsphase verkuerzen. Quelle: adhs strategien.docx

Letzter Test: 2026-02-06T14:53:52.135262 | Score: 100/100

### ○ Lebenskreise-Bereiche Balance pruefen ⭐⭐⭐⭐

7 Lebensbereiche mit Aktivitaeten-Pool. Rotation statt Ueberforderung. Beruf vs Hobby Zuordnung. Quelle: Lebenskreise_Bereiche.docx

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

## SOFTWARE

### ○ FormBuilder Formulare erstellen ⭐⭐⭐⭐⭐

Mit A3 FormBuilder Formulare erstellen und exportieren.

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ HausLagerist Datenbank auslesen ⭐⭐⭐⭐⭐

Datenbank hauslagerist.db auslesen: Haushaltsgegenstaende, Lagerort, Inventar.

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ MediPlaner Datenbank nutzen ⭐⭐⭐⭐⭐

mediplaner.db auslesen: Medikamentenplaene, Einnahmezeiten, Dosierungen.

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ ProFiler Wissen indizieren ⭐⭐⭐⭐⭐

ProFiler komplett integrieren: PDFs scannen, OCR, Wissensindizierung, Datenbanken erstellen und nutzen.

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ RPG-Agent Spielleitung fuehren ⭐⭐⭐⭐⭐

RPG integrieren: Als Spielleiter in Rollenspielen fungieren, Welten verwalten, Sessions leiten.

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ MasterRoutine Datenbank nutzen ⭐⭐⭐⭐

routine_master.db auslesen: Routinen, Aufgaben, Turnus-basierte Erinnerungen.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ MetaWiki erstellen und exportieren ⭐⭐⭐

MetaWiki-Struktur (hierarchische Markdown-Wikis) erstellen und als Funktion in BACH exportieren.

Letzter Test: 2026-02-21 22:36:11 | Score: 70/100

### ○ FinancialProof Dashboard integrieren ⭐⭐

Finanz-Analyse App mit KI-Tiefenanalysen (ARIMA, Monte Carlo, ML) als Dashboard im Finanzagenten bereitstellen.

Letzter Test: 2026-02-21 22:36:11 | Score: 50/100

### ○ MediaBrain Datenbank nutzen ⭐⭐

media_brain.db auslesen: Medien-Sammlung, Kategorien, Metadaten.

Letzter Test: 2026-02-21 22:36:11 | Score: 50/100

## THERAPIE

### ○ Arbeitsblaetter fuer Autismus-Foerderung erstellen ⭐⭐⭐

Aus Wissensdatenbank recherchieren, nach Klientenbeschreibung spezifische Arbeitsblaetter und Uebungen generieren.

Letzter Test: 2026-02-21 22:36:11 | Score: 70/100

### ○ Arbeitsblaetter fuer psychologische Beratung erstellen ⭐⭐⭐

Wissen aus Datenbank fuer Beratung nutzen, Uebungen und Arbeitsblaetter erstellen.

Letzter Test: 2026-02-21 22:36:11 | Score: 70/100

## WISSEN

### ○ Wissensdatenbank navigieren und nutzen ⭐⭐⭐⭐

Wissen aus Wissensdatenbank-Ordner abrufen, strukturieren, verknuepfen.

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

## docs-analyse

### ○ ASCII Lebenslauf erstellen ⭐⭐⭐⭐⭐

Claude erstelle mir einen aktuellen textbasierten ASCII Lebenslauf aus meinen Arbeitgeber-Dokumenten

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ Aerzte-Kontakte exportieren ⭐⭐⭐⭐⭐

Claude gib mir einen uebersichtlichen Textauszug aller Telefon und Mailadressen meiner hinterlegten Aerzte

Letzter Test: 2026-02-06T14:54:07.470400 | Score: 100/100

### ○ Wichtiges Dokument suchen ⭐⭐⭐⭐⭐

Claude suche mir das Dokument heraus indem meine Steuernummer steht

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ Arztberichte zusammenfassen ⭐⭐⭐⭐

Claude lese alle Berichte zum Thema Schilddruese. Gib mir ein Verzeichnis (Name, Fachrichtung, Arzt, Kontakt, Befund) und fasse zusammen

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

### ○ Meine Versicherungen auflisten ⭐⭐⭐⭐

Liste meiner abgeschlossenen Versicherungen mit Police, Tarif, Kosten, Kontakt, Abdeckungsanalyse

Letzter Test: 2026-02-21 22:53:52 | Score: 80/100

### ○ Versicherungs-Verzeichnis abfragen ⭐⭐⭐⭐

Was fuer Versicherungen gibt es? Regeln wann sinnvoll? Tabelle mit Uebersicht

Letzter Test: 2026-02-21 22:53:52 | Score: 80/100

### ○ Versicherungsberatung ⭐⭐⭐⭐

Claude sollte ich eine bestimmte Versicherung abschliessen? Analyse basierend auf vorhandenen Policen

Letzter Test: 2026-02-21 22:53:52 | Score: 80/100

## ordner-flattening

### ○ Office Lens Auto-Kategorisierung ⭐⭐⭐⭐

Automatisch neu fotografierte und hochgeladene Dokumente scannen, kategorisieren und auf Dateisystem oder User in BACH verteilen

Letzter Test: 2026-02-21 22:36:11 | Score: 80/100

## reflection_status

### ○ Reflection Status

bach reflection status zeigt Performance-Report

Letzter Test: 2026-02-21T05:53:30.950266 | Score: 0/100

## system-synopse

### ○ Abo-Abgleich mit Mails ⭐⭐⭐⭐⭐

Vergleiche erkannte Financial-Mails mit hinterlegten Abos. Zeige Differenzen

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ Abo-Status aendern ⭐⭐⭐⭐⭐

Claude stelle Abo 1,3,5 auf inaktiv und 2 auf aktiv. Zeige erwartete Monatskosten

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ Abo-Uebersicht anzeigen ⭐⭐⭐⭐⭐

Claude gib mir eine Uebersicht meiner Abos und wiederkehrenden Kosten mit aktuellem Status

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ Irregulaere Kosten Vorschau ⭐⭐

Finanzagent bitte gib mir eine Uebersicht welche irregulaeren Kosten koennten mich naechsten Monat erwarten?

Letzter Test: 2026-02-06 08:13:06 | Score: 50/100

## system-testverfahren

### ○ Aufgaben als erledigt markieren ⭐⭐⭐⭐⭐

Aufgabe 1, 4, 5 habe ich erledigt - aktualisiere die Datenbank

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ Haushalts-Routine abfragen ⭐⭐⭐⭐⭐

Claude muss ich meine Bettwaesche wechseln? (Routine-Check basierend auf Turnus)

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

### ○ Wochen-Aufgaben abfragen ⭐⭐⭐⭐⭐

Claude welche Aufgaben stehen diese Woche noch an? (aus Routinen: taeglich, woechentlich, monatlich)

Letzter Test: 2026-02-06 08:13:06 | Score: 100/100

## 10. Sicherheit

# Security Policy

## Reporting a Vulnerability

If you find a security vulnerability in BACH, please report it responsibly:

1. Do NOT open a public issue 2. Email: [tbd@example.com] or use GitHub's private vulnerability reporting 3. Include: description, steps to reproduce, potential impact

## Scope

BACH runs locally. The main attack surface is:

- Bridge/Connector endpoints (Telegram, Discord, etc.)
- GUI web server (FastAPI, localhost only by default)
- File system access (bach.db, user data)
- MCP server (localhost only)

## Response

As a solo project, response times may vary. Critical issues will be prioritized. Please allow reasonable time before public disclosure.

## 11. Mitwirken

# Contributing to BACH

BACH is maintained as part of the ellmos project family. Contributions are welcome but there's no guarantee of response time.

## How to contribute

1. Fork the repository 2. Create a feature branch (`git checkout -b feature/my-feature`) 3. Make your changes 4. Run tests (`bach test` or `python -m pytest`) 5. Commit with clear message 6. Open a Pull Request

## Guidelines

- Keep changes focused (one feature/fix per PR)
- Follow existing code style (Python, PEP8-ish)
- Add/update tests if applicable
- Update docs if behavior changes
- Don't break existing functionality

## What gets merged?

- Bug fixes: Almost always welcome
- New features: Open an Issue first to discuss
- Refactoring: Only if it clearly improves something
- New agents/skills: Very welcome as separate modules

## What won't get merged?

- Breaking changes without discussion
- Large refactors without prior agreement
- Features that add complexity without clear benefit
- Changes to CORE (dist_type=2) without good reason

> BACH is a personal project. It's maintained by one person in their free time. > There's no support team, no SLA, no guaranteed response time. > If you like it, use it. If you want to improve it, contribute. > If it doesn't fit your needs, fork it and make it yours.

## 12. Aenderungsprotokoll

# BACH Changelog

Aktuelle Version: unknown Generiert: Automatisch aus dist_file_versions (Delta-Modus)

## Übersicht

Dieses Changelog zeigt Änderungen zwischen Versionen (Delta), nicht alle Dateien.

### Legende

- 🔴 CORE (dist_type=2) - Kernel-Dateien, kritisch für BACH
- 🟡 TEMPLATE (dist_type=1) - Anpassbare Vorlagen
- ⚪ USER (dist_type=0) - Benutzerdaten

## Versionshistorie

### v3.1.6

Änderungen: 234 Dateien (233 geändert, 1 hinzugefügt, 0 entfernt)

#### Geändert (233):

- ⚪ `AGENTS.md` (60d0df76) ← (3f3eb7b5)
- ⚪ `CHAINS.md` (aab8bef5) ← (23a1b56b)
- 🟡 `CHANGELOG.md` (425c2252) ← (d893d280)
- 🟡 `CLAUDE.md` (20411eca) ← (fa4ad3be)
- 🟡 `GEMINI.md` (13079ed6) ← (2ed4b7f2)
- 🟡 `MEMORY.md` (cfd45923) ← (590d73c2)
- 🟡 `OLLAMA.md` (c0dd177a) ← (1248ac62)
- ⚪ `PARTNERS.md` (85035efd) ← (04790b75)
- 🟡 `QUICKSTART.md` (7c6f80ff) ← (b66e6e14)
- 🟡 `QUICKSTART.pdf` (61166b3a) ← (60961281)
- 🟡 `README.md` (3e365688) ← (63bcfe1d)
- 🟡 `SKILLS.md` (04878ebf) ← (e72ed587)
- ⚪ `USECASES.md` (5a1692ba) ← (46d39315)
- ⚪ `WORKFLOWS.md` (c9f972ea) ← (82df479d)
- 🔴 `bach.py` (7c8fed1c) ← (7f0eeb88)
- ... und 218 weitere geänderte Dateien

#### Hinzugefügt (1):

- 🔴 `system/tools/memory_working_cleanup.py` (a3bb8be4)

### v3.1.3

Änderungen: 5 Dateien (5 geändert, 0 hinzugefügt, 0 entfernt)

#### Geändert (5):

- 🔴 `bach.py` (7f0eeb88) ← (3bf7277f)
- ⚪ `system/data/bach.db` (80157bad) ← (3e70d643)
- 🔴 `system/hub/pipeline.py` (03b25825) ← (5fe1f95f)
- 🔴 `system/hub/reflection.py` (f57b113a) ← (39efc250)
- 🔴 `system/tools/rezeptbuch.py` (e396a942) ← (a0f84b48)

### v3.1.2

Änderungen: 229 Dateien (228 geändert, 0 hinzugefügt, 1 entfernt)

#### Geändert (228):

- 🔴 `bach.py` (3bf7277f) ← (b30130f2)
- ⚪ `system/data/bach.db` (3e70d643) ← (87ece3f3)
- 🔴 `system/hub/_services/claude_bridge/__init__.py` (2e956ba8) ← (b7be3d17)
- 🔴 `system/hub/_services/claude_bridge/bridge_daemon.py` (a1ad98e6) ← (6c0dfa37)
- 🔴 `system/hub/_services/claude_bridge/bridge_fackel_wrapper.py` (346055ce) ← (c00c3ab2)
- 🔴 `system/hub/_services/claude_bridge/bridge_tray.py` (cd0dc7da) ← (4c0c6fdd)
- 🔴 `system/hub/_services/claude_bridge/fackel.py` (a0afb919) ← (3fc9b8c4)
- 🔴 `system/hub/_services/claude_bridge/security.py` (89e33e67) ← (64b64275)
- 🔴 `system/hub/_services/claude_bridge/setup_wizard.py` (6420f2ca) ← (d791aacc)
- 🔴 `system/hub/_services/claude_bridge/skill_loader.py` (3f6b89ce) ← (276ea6e2)
- 🔴 `system/hub/_services/claude_bridge/telegram_test.py` (9384707e) ← (2889cb4d)
- 🔴 `system/hub/_services/claude_bridge/test_skills_load.py` (b18a4e8a) ← (42dfd379)
- 🔴 `system/hub/_services/config.py` (ccf8828b) ← (b0343825)
- 🔴 `system/hub/_services/connector/__init__.py` (1b58d7e9) ← (334db53d)
- 🔴 `system/hub/_services/connector/queue_processor.py` (ad148b2d) ← (24646c15)
- ... und 213 weitere geänderte Dateien

#### Entfernt (1):

- 🔴 `system/tools/memory_working_cleanup.py` (2a330fe7)

### v2.6.0

Änderungen: 676 Dateien (0 geändert, 676 hinzugefügt, 0 entfernt)

#### Hinzugefügt (676):

- 🔴 `bach.py` (b30130f2)
- 🟡 `USER.md` (pending-)
- ⚪ `AGENTS.md` (8f8f8a52)
- ⚪ `CHAINS.md` (7e9f44bd)
- 🟡 `CHANGELOG.md` (f652adf7)
- 🟡 `CLAUDE.md` (b010d924)
- 🟡 `CONTRIBUTING.md` (f4c34afd)
- 🟡 `GEMINI.md` (e8ff0089)
- 🔴 `LICENSE` (9697c9d5)
- 🟡 `MEMORY.md` (b80b1262)
- 🟡 `OLLAMA.md` (6e25f14f)
- ⚪ `PARTNERS.md` (82303b39)
- 🟡 `QUICKSTART.md` (b66e6e14)
- 🟡 `QUICKSTART.pdf` (8fc97569)
- 🟡 `README.md` (d9915533)
- ... und 661 weitere hinzugefügte Dateien

## Format

Jeder Eintrag zeigt Delta-Änderungen seit der vorherigen Version:

- Geändert: Dateien mit neuem Hash (alter Hash → neuer Hash)
- Hinzugefügt: Neue Dateien in dieser Version
- Entfernt: Dateien die aus dieser Version entfernt wurden
- Icon: Dist-Type (CORE/TEMPLATE/USER)
- Hash: Kurz-Hash (erste 8 Zeichen)

## Vollständige Historie

Für vollständige Versionshistorie siehe `dist_file_versions` Tabelle:

    bach db query "SELECT * FROM dist_file_versions ORDER BY version DESC"

Generiert mit `bach docs generate changelog` (Delta-Modus seit v3.1.6)

## 13. Lizenzen

# BACH - Third-Party Licenses

This document lists all third-party Python packages used by BACH, their versions (as tested), and their respective licenses.

> SQ072/ENT-32 (2026-02-19): PyMuPDF (fitz) wurde als Core-Dependency entfernt. > Core PDF-Lesen nutzt jetzt pypdf (MIT) + pdfplumber (MIT). > PyMuPDF bleibt als OPTIONALE Dependency fuer: PDF-Rendering fuer OCR, > PDF-Schwaerzung (_vendor/), Redaction-Erkennung. > Steuer-Agent-Dateien (dist_type=0) sind nicht Teil des Release. > Damit ist BACH als MIT-Projekt publizierbar ohne AGPL-Infizierung durch PyMuPDF.

## Core Dependencies

| Package | Version | License | Notes | |---------|---------|---------|-------| | `requests` | 2.32.5 | Apache-2.0 | HTTP client | | `httpx` | 0.28.1 | BSD-3-Clause | Async HTTP | | `aiohttp` | 3.13.0 | Apache-2.0 AND MIT | Async HTTP sessions | | `PyYAML` | 6.0.2 | MIT | YAML parsing | | `toml` | 0.10.2 | MIT | TOML parsing | | `python-dotenv` | 1.2.1 | BSD (see metadata) | .env file loading | | `pydantic` | 2.12.5 | MIT (see metadata) | Data validation | | `xmltodict` | 1.0.2 | MIT | XML ↔ dict | | `defusedxml` | 0.7.1 | PSFL (Python SF License) | Secure XML parsing | | `lxml` | 6.0.0 | BSD-3-Clause | XML/HTML processing | | `emoji` | 2.15.0 | BSD | Emoji handling | | `ftfy` | 6.3.1 | Apache-2.0 | Unicode/encoding repair | | `rapidfuzz` | 3.14.3 | MIT (see metadata) | Fuzzy string matching | | `markdown` | 3.10 | BSD (see metadata) | Markdown → HTML | | `watchdog` | 6.0.0 | Apache-2.0 | File system monitoring | | `psutil` | 7.0.0 | BSD-3-Clause | System/process info | | `GitPython` | 3.1.46 | BSD-3-Clause | Git operations | | `colorama` | 0.4.6 | BSD | ANSI terminal colors | | `rich` | 14.2.0 | MIT | Rich terminal output | | `click` | 8.2.1 | BSD (see metadata) | CLI argument parsing | | `typer` | 0.21.1 | MIT (see metadata) | Typed CLI building | | `tqdm` | 4.67.1 | MPL-2.0 AND MIT | Progress bars | | `cryptography` | 45.0.5 | Apache-2.0 OR BSD-3-Clause | Encryption | | `keyring` | 25.7.0 | MIT (see metadata) | OS keychain | | `peewee` | 3.19.0 | MIT (see metadata) | Lightweight ORM | | `pypdf` | 6.4.0 | MIT (see metadata) | PDF text extraction (core, replaces PyMuPDF for reading) | | `pdfplumber` | 0.11.7 | MIT | PDF text/table extraction (core, fallback after pypdf) | | `pikepdf` | 10.0.2 | MPL-2.0 (see metadata) | PDF low-level editing | | `pyperclip` | 1.9.0 | BSD | Clipboard access | | `pyautogui` | 0.9.54 | BSD | GUI automation |

## Optional Dependencies

### Document Processing

| Package | Version | License | Notes | |---------|---------|---------|-------| | `PyMuPDF` | 1.26.4 | AGPL-3.0 OR Commercial | ⚠️ OPTIONAL: PDF render/redact/OCR-render (fitz). SQ072/ENT-32: Core PDF reading replaced by pypdf+pdfplumber. Install only for OCR-rendering or redaction features. | | `extract_msg` | 0.55.0 | GPL | ⚠️ OPTIONAL: Parse .msg Outlook files (report_generator). SQ072/ENT-32: Moved to optional due to GPL incompatibility with MIT. Install only if you need Outlook .msg parsing. | | `pdf2image` | 1.17.0 | MIT | PDF → image (requires poppler) | | `reportlab` | 4.4.5 | BSD | PDF generation | | `fpdf2` | 2.8.3 | LGPL-3.0 | Lightweight PDF creation | | `weasyprint` | 68.1 | BSD | HTML/CSS → PDF | | `Pillow` | 10.4.0 | HPND (PIL License) | Image processing | | `pytesseract` | 0.3.13 | Apache-2.0 | OCR wrapper | | `python-docx` | 1.2.0 | MIT | Word .docx files | | `python-pptx` | 1.0.2 | MIT | PowerPoint .pptx files | | `openpyxl` | 3.1.5 | MIT | Excel .xlsx files |

### AI / LLM Partners

| Package | Version | License | Notes | |---------|---------|---------|-------| | `anthropic` | 0.79.0 | MIT | Claude API (primary LLM) | | `ollama` | 0.6.1 | MIT (see metadata) | Ollama local LLM | | `openai-whisper` | 20250625 | MIT | Speech-to-text (Whisper) |

### Data Analysis / Market

| Package | Version | License | Notes | |---------|---------|---------|-------| | `numpy` | 2.3.1 | BSD | Numerical computing | | `pandas` | 2.3.1 | BSD | Data analysis | | `scipy` | 1.16.0 | BSD | Scientific computing | | `matplotlib` | 3.10.6 | PSF License | Plotting | | `yfinance` | 1.0 | Apache | Yahoo Finance data |

### Vector Database / RAG

| Package | Version | License | Notes | |---------|---------|---------|-------| | `chromadb` | 1.4.1 | Apache-2.0 | Embedded vector DB |

### GUI / Web Server

| Package | Version | License | Notes | |---------|---------|---------|-------| | `PyQt6` | 6.10.0 | GPL-3.0 (see metadata) | ⚠️ Qt GUI framework | | `fastapi` | 0.128.0 | MIT (see metadata) | Web API framework | | `uvicorn` | 0.40.0 | BSD (see metadata) | ASGI server | | `starlette` | 0.50.0 | BSD (see metadata) | ASGI framework | | `pystray` | 0.19.5 | LGPL-3.0 | System tray icon | | `tkinterdnd2` | 0.4.3 | MIT | Drag & drop (Tk) | | `selenium` | 4.38.0 | Apache-2.0 | Browser automation |

### Google Services

| Package | Version | License | Notes | |---------|---------|---------|-------| | `google-api-python-client` | 2.187.0 | Apache-2.0 | Google APIs | | `google-auth-oauthlib` | 1.2.3 | Apache-2.0 | Google OAuth2 |

### Voice / Audio

| Package | Version | License | Notes | |---------|---------|---------|-------| | `pyttsx3` | 2.99 | MIT (see metadata) | Text-to-speech |

### Windows-Specific

| Package | Version | License | Notes | |---------|---------|---------|-------| | `pywin32` | 311 | PSF | Windows COM/API |

### Development / Testing

| Package | Version | License | Notes | |---------|---------|---------|-------| | `pytest` | 9.0.2 | MIT (see metadata) | Test runner |

## Packages Referenced But Not Installed

These are referenced in the source code but not currently installed (planned integrations, optional features, or legacy code):

| Import name | PyPI package | Notes | |-------------|-------------|-------| | `fitz` | PyMuPDF | Already listed above (different import name) | | `sklearn` | `scikit-learn` | ML market analysis models | | `tensorflow` | `tensorflow` | Neural network (market analysis) | | `statsmodels` | `statsmodels` | Statistical models (market analysis) | | `playwright` | `playwright` | Web automation (testing examples only) | | `html2text` | `html2text` | HTML → Markdown (web parse) | | `croniter` | `croniter` | Cron expressions (GUI scheduler) | | `google` | `google-generativeai` | Gemini API (planned) | | `mcp` | `mcp` | MCP SDK (tools/mcp_server.py) | | `pyaudio` | `pyaudio` | Audio I/O (voice STT) | | `vosk` | `vosk` | Offline speech recognition | | `openwakeword` | `openWakeWord` | Wake word detection | | `piper` | `piper-tts` | Neural TTS (voice) | | `whisper` | `openai-whisper` | Already listed above | | `telegram` | `python-telegram-bot` | Telegram connector | | `textract` | `textract` | Document text extraction |

## ⚠️ License Compatibility Notes

Critical items requiring attention before public release:

1. PyMuPDF (AGPL-3.0): ✅ RESOLVED by SQ072 (2026-02-19). Core PDF-Lesen migriert zu pypdf+pdfplumber (MIT). PyMuPDF ist jetzt NUR optional fuer Spezial-Features (OCR-Rendering, Schwaerzung). Steuer-Expert-Dateien (dist_type=0) sind vom Release ausgenommen. AGPL-Infizierung des MIT-Release ist damit beseitigt.

2. extract_msg (GPL): Used in 2 files for .msg email parsing. GPL is similarly restrictive. Can be made optional (only install if .msg parsing is needed).

3. PyQt6 (GPL-3.0): Used only in `gui/prompt_manager.py` and `pdf_schwaerzer_pro.py`. Both are optional/tool components. Can be classified as optional.

4. fpdf2 (LGPL-3.0): LGPL allows linking from non-GPL code without copyleft propagation. Generally compatible.

5. pystray (LGPL-3.0): Same as fpdf2, generally compatible.

Recommended BACH license given the above: If retaining PyMuPDF and PyQt6: GPL-3.0 or AGPL-3.0 If replacing/making optional: MIT or Apache-2.0 (preferred for open source)

Generated: 2026-02-18 | BACH v2.6.0 (Vanilla) | Python 3.12 To regenerate: python BACH_Dev/tools/scan_imports.py (SQ034)