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

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

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

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

`bash
python bach.py --startup
`

#### Task erstellen und verwalten

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

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

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

Facts abrufen
=============
python bach.py mem read facts
`

#### BACH beenden

`bash
python bach.py --shutdown
`

------------------------------------------------------------

📚 Wichtigste Kommandos
----------------------

------------------------------------------------------------

🎯 Nächste Schritte
------------------

1. Dokumentation erkunden
   `bash
   python bach.py docs list
   `

2. Agenten kennenlernen
   `bash
   python bach.py agent list
   `

3. Skills durchsuchen
   `bash
   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
----------------

`bash
Allgemeine Hilfe
================
python bach.py --help

Handler-spezifische Hilfe
=========================
python bach.py <handler> --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
-------

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

`bash
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
===========================
<!-- AUTO-GENERATED via SQ034 (2026-02-18) - update when dependencies change -->

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)
