{"id":51856291,"url":"https://github.com/ellmos-ai/bach","last_synced_at":"2026-07-24T01:03:49.996Z","repository":{"id":340241328,"uuid":"1164337426","full_name":"ellmos-ai/bach","owner":"ellmos-ai","description":"BACH v3.12.4-earth: local-first text-based OS for LLM agents with SQLite memory, 113+ handlers, 550+ tools, MCP servers, scheduler and multi-agent orchestration","archived":false,"fork":false,"pushed_at":"2026-07-18T12:25:28.000Z","size":14984,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-07-18T14:12:19.882Z","etag":null,"topics":["agent-framework","ai-agent","ai-assistant","automation","cli","knowledge-management","llm","llm-memory","llm-os","local-first","mcp-server","model-context-protocol","multi-agent","personal-os","pyside6","python","sqlite","sqlite-memory","task-management","workflow-automation"],"latest_commit_sha":null,"homepage":"https://github.com/ellmos-ai/bach#readme","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ellmos-ai.png","metadata":{"files":{"readme":"README.de.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://paypal.me/lukasgeiger2507"]}},"created_at":"2026-02-23T00:46:32.000Z","updated_at":"2026-07-18T12:25:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ellmos-ai/bach","commit_stats":null,"previous_names":["lukisch/bach","ellmos-ai/bach"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/ellmos-ai/bach","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ellmos-ai%2Fbach","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ellmos-ai%2Fbach/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ellmos-ai%2Fbach/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ellmos-ai%2Fbach/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ellmos-ai","download_url":"https://codeload.github.com/ellmos-ai/bach/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ellmos-ai%2Fbach/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35822076,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-23T02:00:06.683Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-framework","ai-agent","ai-assistant","automation","cli","knowledge-management","llm","llm-memory","llm-os","local-first","mcp-server","model-context-protocol","multi-agent","personal-os","pyside6","python","sqlite","sqlite-memory","task-management","workflow-automation"],"created_at":"2026-07-24T01:03:49.419Z","updated_at":"2026-07-24T01:03:49.957Z","avatar_url":"https://github.com/ellmos-ai.png","language":"Python","funding_links":["https://paypal.me/lukasgeiger2507"],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"assets/banner_v2.png\" width=\"100%\" alt=\"BACH Banner\"\u003e\n\n# ellmos BACH — Textbasiertes Betriebssystem für LLMs\n\n\u003e Der Strom, der alles verbindet.\n\n[![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python)](https://python.org)\n[![Lizenz: MIT](https://img.shields.io/badge/License-MIT-green)](LICENSE)\n[![Version](https://img.shields.io/badge/Version-v3.13.0--bluesky-orange)](CHANGELOG.md)\n[![Status](https://img.shields.io/badge/Status-Production--Ready-brightgreen)](ROADMAP.md)\n\n**Version:** v3.13.0-bluesky\n\n## 🎬 Demo-Video\n\nBACH live in Aktion — Dashboard, Codex-Backend, Operator-Steuerung — in 2:22:\n\n[![BACH-Demo — local-first LLM-Betriebssystem (2:22)](https://img.youtube.com/vi/Gv5nxF8HssU/maxresdefault.jpg)](https://youtu.be/Gv5nxF8HssU)\n\n## Sprachen\n\nBACH wird mit Dokumentations- und Übersetzungsoberflächen für sechs Sprachen ausgeliefert:\n\n[🇬🇧 English](README.md) | **🇩🇪 Deutsch** | [🇪🇸 Español](README.es.md) | [🇷🇺 Русский](README.ru.md) | [🇯🇵 日本語](README.ja.md) | [🇨🇳 中文](README.zh.md)\n\nDer 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/\u003clang\u003e/`.\n\n## Überblick\n\nBACH 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.\n\n## Such- und Abgrenzungskontext\n\nBACH 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.\n\nSinnvolle 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`.\n\n## OpenAI Build Week — Codex und GPT-5.6\n\nBACH nutzt Codex in zwei klar getrennten Rollen:\n\n- **Laufzeit-Backend:** `codex-cli` ist eines von fünf austauschbaren Chat-Backends; BACH-Agenten können Programmieraufgaben über `codex exec` delegieren.\n- **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.\n- **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.\n- **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.\n\nZur Nachvollziehbarkeit gilt die GPT-5.6-Zuordnung der Automationen erst ab dieser Konfigurationsänderung; frühere Automationsläufe verwendeten frühere Codex-Modelle.\n\n### Kernfunktionen\n\n- **113+ Handler** - CLI- und API-Abdeckung für Systemfunktionen\n- **550+ Tools** - Umfangreiche Tool-Bibliothek für Dateiverarbeitung, Analyse und Automation\n- **1870+ Skills** - Wiederverwendbare Workflows und Templates\n- **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\n- **71 Workflow-Vorlagen** - Vorgefertigte Prozess-Workflows\n- **Agent Doctor** - `bach agent doctor [name] [--json]` prüft Claude CLI, Laufzeitverzeichnisse, SKILL.md und veraltete PID-Dateien vor dem Start\n- **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`\n- **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\n- **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\n- **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\n- **Upgrade-Drift- und Reparaturpfad** - `bach upgrade list \u003cPfad\u003e --json`, `bach upgrade status/check --json` und `bach upgrade repair [--dry-run] [--version \u003cTag\u003e]` liefern maschinenlesbare Versions-, Status-, Drift-, Reparatur- und Recovery-Flächen für Releases, Dashboards und Automationen\n- **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\n- **Manifest-first Plugins** - `bach plugins inspect` zeigt Aktivierung, Provider-/Model-, Setup- und Capability-Metadaten ohne Runtime-Import\n- **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\n- **Wissensspeicher** - Lessons, Facts und mehrstufiges Memory-System\n\n## Installation\n\n```bash\n# Repository klonen\ngit clone https://github.com/ellmos-ai/bach.git\ncd bach\n\n# Abhängigkeiten installieren und `bach` CLI verfügbar machen\npip install -e .\n\n# Pre-Flight-Check\nbach setup preflight\n\n# Vollständige Installation (MCP-Server, Hooks, Secrets, User-Profil)\nbach setup full-install\n```\n\n## Quick Start\n\n```bash\n# BACH starten\npython bach.py --startup\n\n# Task erstellen\npython bach.py task add \"Analysiere Projektstruktur\"\n\n# Wissen abrufen\npython bach.py wiki search \"Task Management\"\n\n# BACH beenden\npython bach.py --shutdown\n```\n\n## Hauptkomponenten\n\n### 1. Task-Management\nVollständiges GTD-System mit Priorisierung, Deadlines, Tags und Context-Tracking.\n\n### 2. Wissenssystem\nStrukturiertes Memory-System mit Facts, Lessons und automatischer Konsolidierung.\n\n### 3. Agenten-Framework\nBoss-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.\n\n### 4. Chat-Service \u0026 Bridge-System\nMulti-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.\n\n### 5. Automatisierung\nSchedulerService für zeitbasierte Jobs (Chains, Tasks, Scripts) und Event-basierte Workflows über das Hook-Framework.\n\n### 6. SharedMemory\nMulti-Agent-Koordination mit Kontextgenerierung, Konflikterkennung, Decay und Delta-Queries.\n\n### 7. llmauto-Integration\nChain-Schritte als LLM-Prompts mit `bach://` URL-Auflösung für dynamische Kontext-Einbettung.\n\n## OpenClaw-Abgleich\n\nStand 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](https://github.com/openclaw/openclaw/releases/tag/v2026.7.2-beta.3).\n\nAuf 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.\n\n## Dokumentation\n\n- **Sprachen:** [English](README.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Русский](README.ru.md) | [日本語](README.ja.md) | [中文](README.zh.md)\n- **[Schnellstart](QUICKSTART.md)** - Erste Schritte mit BACH\n- **[Benutzerhandbuch](BACH_USER_MANUAL.md)** - Vollständiges Handbuch\n- **[Skills-Katalog](SKILLS.de.md)** - Öffentlicher Einstieg in verfügbare Skills\n- **[Agenten-Katalog](AGENTS.template.de.md)** - Vorlage und öffentlicher Einstieg für Agenten und Experten\n- **[Workflows](WORKFLOWS.template.de.md)** - 71 Workflow-Vorlagen\n- **[SKILL-Vorlage](SKILL.template.de.md)** - LLM-Betriebsanweisungen für Claude, Gemini, Ollama und Codex-artige Agenten\n\n## Lizenz\n\nMIT License - siehe [LICENSE](LICENSE) für Details.\n\n## Support\n\n- **Issues:** [GitHub Issues](https://github.com/ellmos-ai/bach/issues)\n- **Discussions:** [GitHub Discussions](https://github.com/ellmos-ai/bach/discussions)\n\n---\n\nEnglish version: [README.md](README.md)\n\n*Generiert mit `bach docs generate readme --lang de`*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fellmos-ai%2Fbach","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fellmos-ai%2Fbach","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fellmos-ai%2Fbach/lists"}