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

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

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

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)