Skip to content

README.de.md

Latest commit

 

History

History
185 lines (127 loc) · 12.1 KB

README.de.md

File metadata and controls

185 lines (127 loc) · 12.1 KB
Raw

BACH Banner

ellmos BACH — Textbasiertes Betriebssystem für LLMs

Der Strom, der alles verbindet.

Python Lizenz: MIT Version Status

Version: v3.13.0-bluesky

🎬 Demo-Video

BACH live in Aktion — Dashboard, Codex-Backend, Operator-Steuerung — in 2:22:

BACH-Demo — local-first LLM-Betriebssystem (2:22)

Sprachen

BACH wird mit Dokumentations- und Übersetzungsoberflächen für sechs Sprachen ausgeliefert:

🇬🇧 English | 🇩🇪 Deutsch | 🇪🇸 Español | 🇷🇺 Русский | 🇯🇵 日本語 | 🇨🇳 中文

Der aktuelle Release-Snapshot aktiviert de, en, es, ru, ja und zh in system/exports/translations/languages_config.release.json und exportiert passende Locale-Dateien in system/exports/translations/locales/. Für Crawler und direkte Spracheinstiege hat jede Sprache zusätzlich eine eigene README.md unter docs/i18n/<lang>/.

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

Such- und Abgrenzungskontext

BACH ist am besten als local-first LLM-Betriebssystem zu verstehen: eine dauerhafte Python-/SQLite-Arbeitsumgebung für autonome Agenten, strukturiertes Gedächtnis, Scheduler-Automation, Prompt-Ketten, MCP-Server-Integration und mehrsprachige Bedienoberflächen. Es ist kein Chatbot-Wrapper, kein gehostetes Agent-SaaS, kein Bash-Testframework, kein Musikprojekt und keine LangChain-artige Pipeline-Bibliothek.

Sinnvolle Suchphrasen sind local-first LLM operating system, text-based OS for LLM agents, SQLite memory for AI agents, BACH ellmos agent OS, personal agentic OS Python SQLite und multi-agent orchestration with MCP servers.

OpenAI Build Week — Codex und GPT-5.6

BACH nutzt Codex in zwei klar getrennten Rollen:

  • Laufzeit-Backend: codex-cli ist eines von fünf austauschbaren Chat-Backends; BACH-Agenten können Programmieraufgaben über codex exec delegieren.
  • Repository-Entwicklung: Drei aktive Codex-Automationen pflegen das Projekt: bach-daily-care-and-dev-check, bach-start-and-health-checks und bach-github-release-service. Seit dem 21. Juli 2026 sind alle drei für GPT-5.6 (gpt-5.6-terra) konfiguriert; die ersten beiden laufen täglich, der Release-Service wöchentlich.
  • Verifiziertes Modell-Routing: In Codex-Session 019f85c6-4339-7f13-b8e5-bf1823fd8432 prüfte GPT-5.6 Sol mit hohem Reasoning alle 78 Automationsdefinitionen und routete BACHs Entwicklungs- und Release-Aufgaben auf Terra/high sowie die Health-Checks auf Terra/medium.
  • Abschlussprüfung der Einreichung: GPT-5.6 Sol prüfte und zertifizierte in Codex-Session 019f8674-fe9a-7d91-a80f-7ee799e8ced0 die ausstehenden BACH-Änderungen, korrigierte die Wettbewerbsangaben und schloss die Härtung und Regressionstests des Web-Scrapers ab.

Zur Nachvollziehbarkeit gilt die GPT-5.6-Zuordnung der Automationen erst ab dieser Konfigurationsänderung; frühere Automationsläufe verwendeten frühere Codex-Modelle.

Kernfunktionen

  • 113+ Handler - CLI- und API-Abdeckung für Systemfunktionen
  • 550+ Tools - Umfangreiche Tool-Bibliothek für Dateiverarbeitung, Analyse und Automation
  • 1870+ Skills - Wiederverwendbare Workflows und Templates
  • Skill-Source-Registry - bach skills version bach löst den kanonischen Repo-Root-Skill jetzt über system/data/skill_sources.json auf und kann optionale Codex-/Claude-Nutzerkopien ohne fuzzy Dateinamen-Drift vergleichen
  • 71 Workflow-Vorlagen - Vorgefertigte Prozess-Workflows
  • Agent Doctor - bach agent doctor [name] [--json] prüft Claude CLI, Laufzeitverzeichnisse, SKILL.md und veraltete PID-Dateien vor dem Start
  • Agent-Operator-Steuerung - bach agent pause/resume/checkpoint/steer/clear-steer [name] [--json] erlaubt kooperative Pauseanforderungen und Operator-Hinweise vor dem Start oder während des Laufs, ergänzt explizite Checkpoint-Bestätigungen, spiegelt den Zustand in OPERATOR_NOTES.md, erhält vorgemerkte Hinweise über den nächsten bach agent start hinweg, injiziert sie in die generierte Session-CLAUDE.md und zeigt den Vorstart- und Kontrollzustand maschinenlesbar über queued_for_next_start plus verschachteltes operator_control
  • Scheduler Doctor - bach scheduler doctor [--json] sowie bach scheduler session doctor [--json] prüfen Automations-Skripte, PID-Status, DB-/Config-/Profil-Flächen und schlagen Recovery-Schritte vor
  • Session-Steuerung - bach scheduler session pause/resume/steer/clear-steer [--json] steuert profilspezifische Auto-Sessions und liefert bei Bedarf maschinenlesbare Antworten, ohne die Daemon-Config manuell umzuschreiben
  • Scheduler-Laufsteuerung - bach scheduler pause/resume/steer/clear-steer [--json] pausiert fällige Jobs global, reicht vorgemerkte Hinweise an Job-/Chain-Läufe weiter und hydratisiert schedulerweite Steer-Hinweise jetzt auch in llmauto-Ketten bis zum nächsten sicheren Checkpoint
  • Upgrade-Drift- und Reparaturpfad - bach upgrade list <Pfad> --json, bach upgrade status/check --json und bach upgrade repair [--dry-run] [--version <Tag>] liefern maschinenlesbare Versions-, Status-, Drift-, Reparatur- und Recovery-Flächen für Releases, Dashboards und Automationen
  • Install Security Gate - Statische Scans für skills install, plugins load und MCP-Setup/Config-Aktivierung; Plugin-Setups mit Shell/Desktop/MCP-Zugriff brauchen jetzt explizite fail-closed Guards, blockierte lokale Importe werden quarantänisiert
  • Manifest-first Plugins - bach plugins inspect zeigt Aktivierung, Provider-/Model-, Setup- und Capability-Metadaten ohne Runtime-Import
  • Strukturierte bach_api-Kernmodule - task und memory bieten jetzt über dir(...) auffindbare Methoden, liefern bei häufigen Reads/Writes Python-Objekte zurück und behalten raw(...) für Legacy-Handler-Aufrufe
  • Wissensspeicher - Lessons, Facts und mehrstufiges Memory-System

Installation

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

# Abhängigkeiten installieren und `bach` CLI verfügbar machen
pip install -e .

# Pre-Flight-Check
bach setup preflight

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

Optionale Operator-Konsole

Die bestehende Operator-Konsole ellmos-unified-gui kann ohne zweiten Prozess und ohne zweite Unified-GUI-Konfiguration in das BACH-Dashboard eingebunden werden:

pip install -e ".[console]"
BACH_GUI_CONSOLE_ENABLED=1 python system/gui/server.py

Der Mount ist standardmäßig deaktiviert und verwendet /control. Mit BACH_GUI_CONSOLE_PREFIX lässt sich ein anderer absoluter URL-Pfad wählen. Fehlt das optionale Paket oder schlägt das Einbinden fehl, läuft das BACH-Dashboard ohne die Konsole weiter. BACH führt keine eigene zusätzliche Anmeldung ein; Unified GUI behält für einen BACH-Host sein bestehendes fähigkeitsbasiertes Verhalten. Da das BACH-Dashboard derzeit keine AUTH_ROLE-Host-Session bereitstellt, sollte dieser Mount nur auf der standardmäßigen Loopback-Adresse oder hinter einer bestehenden vertrauenswürdigen Zugriffsgrenze laufen.

Quick Start

# Schnelle, nebenwirkungsfreie Metadaten
python bach.py --version
python bach.py --help

# 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

--version, --help, befehlsspezifische Hilfe und der globale --dry-run-Startpfad umgehen AutoLogger, ProSync und Activity Tracking. Normale Befehle melden den ProSync-Pull sofort und begrenzen ihn beim Start auf 15 Sekunden. Für einen langsameren Transit kann das lokale Budget über BACH_PROSYNC_STARTUP_TIMEOUT_SECONDS auf 1 bis 300 Sekunden gesetzt werden. Scheitert der Pull oder läuft er in das Zeitlimit, registriert BACH für diesen Prozess keinen Exit-Push.

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.). bach agent unterstützt inzwischen Vorstart-Steering, kooperative Pauseanforderungen, explizite Checkpoint-Bestätigungen via bach agent checkpoint und maschinenlesbare operator_control-Snapshots für laufende oder vorgemerkte Agentenläufe.

4. Chat-Service & Bridge-System

Multi-Backend Telegram-Bot mit wechselbaren LLM-Backends (Ollama, Claude CLI, Codex CLI, Claude API, OpenAI API), HTTP Control API mit Web-Dashboard und plattformübergreifendem System Tray. Connector-Framework für weitere Services (Email, WhatsApp, etc.) und USMC-Bridge für Cross-Agent-Kommunikation.

5. Automatisierung

SchedulerService für zeitbasierte Jobs (Chains, Tasks, Scripts) und Event-basierte Workflows über das Hook-Framework.

6. SharedMemory

Multi-Agent-Koordination mit Kontextgenerierung, Konflikterkennung, Decay und Delta-Queries.

7. llmauto-Integration

Chain-Schritte als LLM-Prompts mit bach:// URL-Auflösung für dynamische Kontext-Einbettung.

OpenClaw-Abgleich

Stand 2026-07-19: OpenClaw Stable bleibt 2026.7.1; das neueste sichtbare Prerelease ist 2026.7.2-beta.3, veröffentlicht am 2026-07-18 um 23:16 UTC. Es erweitert die bereits beobachteten Signale zu session-lokaler MCP-Isolation, task-ledger-basierter Cron-Historie, Remote-Workern und Recovery um Remote-Coding-Sessions auf dem owning host, geführtes Control-UI-/Channel-Setup, robustere Gateway-/Session-Recovery, sicherere Channel-Bedienung und versionierte Restart-Handoffs für externe Supervisoren. Für BACH passen davon vor allem supervised Restart-Handoffs, Terminal-Resume auf dem owning host, gehärtete Setup-Flows und recovery-sichere Channel-/Session-Pfade; breite Mobile-/Channel-Parität bleibt weiter außerhalb des aktuellen Fokus. Quelle: openclaw/openclaw releases.

Auf BACH-Seite hat der Daily-Care-Lauf vom 2026-07-19 den Live-Release-Katalog versiegelt: bach upgrade repair --version v3.13.0-bluesky --json registriert den aktuellen Release jetzt real, und bach upgrade check --json meldet Stable/Latest v3.13.0-bluesky, release_entries=2, current_release_registered=true, repair_recommended=false und local_modifications=0. test-agent-Doctor/Start-Dry-Run sowie Usecase 50 liefen ebenfalls erfolgreich.

Dokumentation

Lizenz

MIT License - siehe LICENSE für Details.

Support

English version: README.md

Generiert mit bach docs generate readme --lang de