convez.ai
MCP ServerAutomaçãoAvançado
ellmos-ai

BACH v3.12.4 — Sistema Operacional baseado em Texto para Agentes LLM

ellmos-ai/bach

SO baseado em texto para agentes LLM com SQLite, scheduler e orquestração multi-agente

Ver no GitHub
BomPluginScore · de 0 a 100

BACH é um sistema operacional local-first construído em Python e SQLite que capacita agentes LLM a trabalhar autonomamente com memória estruturada, 113+ handlers, 550+ ferramentas e orquestração multi-agente. Fornece infraestrutura completa para gerenciamento de tarefas, automação agendada, cadeias de prompts e integração com servidores MCP.

Instalação

$npx convez-ai ellmos-ai/bach

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
3
Acompanhando
2
Saúde
87%
Último commit
há 1 dia
Versão
v3.14.0
Issues abertas
11
Contribuidores
3

Casos de uso

  • Construir agentes autônomos com memória persistente e aprendizado contínuo
  • Orquestrar múltiplos agentes LLM em workflows complexos
  • Automatizar tarefas repetitivas com scheduler integrado e 550+ ferramentas

Veredito

BACH é uma plataforma robusta e production-ready para quem precisa orquestrar agentes LLM sofisticados com estado persistente e controle granular. Excelente para automação enterprise e sistemas agenticos complexos, mas requer expertise Python/SQLite.

README

A tradução para o português deste README ainda está na fila.

ellmos BACH — Text-Based Operating System for LLMs

The stream that unites everything.

Python License: MIT Version Status Tests

Version: v3.12.4-earth

Languages

BACH is documented and shipped with translation surfaces for six languages:

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

The current release snapshot enables de, en, es, ru, ja, and zh in system/exports/translations/languages_config.release.json and exports matching locale files in system/exports/translations/locales/. For crawlers and direct language entry points, each language also has its own README.md under docs/i18n/<lang>/.

Overview

BACH is a text-based operating system that empowers Large Language Models (LLMs) to work autonomously, learn, and self-organize. Part of the ellmos family (Extra Large Language Model Operating Systems), BACH provides comprehensive infrastructure for task management, knowledge management, automation, and LLM orchestration.

Discovery Context

BACH is best described as a local-first LLM operating system: a persistent Python/SQLite workbench for autonomous agents, structured memory, scheduler-driven automation, prompt chains, MCP server integration, and multilingual operator surfaces. It is not a chatbot wrapper, hosted agent SaaS, Bash unit-test framework, music project, or LangChain-style pipeline library.

Canonical GitHub repository: ellmos-ai/bach. Machine-readable project context for LLM crawlers is available in llms.txt.

Useful search phrases include ellmos-ai/bach, 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, and multi-agent orchestration with MCP servers.

Key Features

  • 113+ Handlers - Full CLI and API coverage of all system functions
  • 550+ Tools - Extensive tool library for file processing, analysis, and automation
  • 1870+ Skills - Reusable workflows and templates
  • 59 Workflow Templates - Pre-built process workflows
  • 4400+ Tests - Comprehensive automated coverage across handlers, services, GUI, and MCP servers
  • Knowledge Store - Lessons, Facts, and Multi-Level Memory System (6 memory types)
  • Agent CLI - bach agent start/stop/list for direct agent control
  • Agent Doctor - bach agent doctor [name] [--json] validates Claude CLI availability, runtime dirs, skill files, and stale PID state before a launch
  • Agent Operator Controls - bach agent pause/resume/checkpoint/steer/clear-steer [name] [--json] lets operators stage cooperative pause requests and guidance before or during a run, record explicit safe-checkpoint acknowledgements, mirror that state into OPERATOR_NOTES.md, preserve queued hints across the next bach agent start, inject them into the generated session CLAUDE.md, and expose nested operator_control snapshots plus queued_for_next_start for automation-safe polling
  • Agent Runtime Policy Defaults - bach agent start now accepts --permission-mode, --allowed-tools, and --max-turns, and can preload the same defaults from agent SKILL frontmatter for per-agent guardrails
  • Scheduler Doctor - bach scheduler doctor [--json] plus bach scheduler session doctor [--json] validate automation scripts, PID state, DB/config/profile surfaces, and suggest recovery steps before background services are started
  • Session Steering Controls - bach scheduler session pause/resume/steer/clear-steer [--json] lets operators gate or retarget the next profile-specific auto-session without editing daemon config by hand
  • Scheduler Run Controls - bach scheduler pause/resume/steer/clear-steer [--json] now exposes the same operator control plane for due scheduler jobs, including global pause and queued run guidance without hand-editing control files; queued scheduler hints now also hydrate llmauto chains into their next safe-checkpoint prompt path
  • Machine-readable Control & Status Surfaces - bach agent list/start/stop/pause/resume/checkpoint/steer/clear-steer/status --json, bach scheduler status/jobs/session status --json, and bach scheduler session pause/resume/steer/clear-steer --json, including queue state, queued_for_next_start, timestamps, checkpoint acknowledgements, and operator-note metadata for automation-safe polling
  • Upgrade Drift & Repair - bach upgrade list <path> --json, bach upgrade status/check --json, and bach upgrade repair [--dry-run] [--version <tag>] expose automation-safe version, status, drift, repair hints, and recovery for broken distribution metadata
  • Path Surface - bach path exposes canonical system/workspace/DB paths, validation, resolve helpers, and DB overrides in text or JSON
  • Prompt System - Central prompt management with board system and versioning
  • Install Security Gate - Static pre-load scans block obvious code-injection patterns during skills install/plugins load; MCP setup validates allowlisted packages/configs fail-closed, plugin setup contracts now require explicit shell/desktop/MCP checks, and blocked local imports are quarantined
  • Manifest-first Plugins - bach plugins inspect previews activation, provider/model, setup, and capability metadata without importing plugin runtime code
  • Structured bach_api Core - task and memory now expose discoverable methods via dir(...), return Python objects for common reads/writes, and still keep raw(...) for legacy handler-style calls
  • SharedMemory Bus - Multi-agent coordination with conflict detection and decay
  • USMC Bridge - United Shared Memory Communication for cross-agent communication
  • llmauto Chains - Claude prompts as chain steps with bach:// URL resolution
  • Chat Service - Multi-backend Telegram bot (5 backends), Control API, Web Dashboard, cross-platform System Tray

Installation

# Clone the repository
git clone https://github.com/ellmos-ai/bach.git
cd bach

# Install dependencies and make `bach` CLI available
pip install -e .

# Pre-flight check
bach setup preflight

# Full install (MCP servers, hooks, secrets, user profile)
bach setup full-install

MCP Servers (Claude Code Integration)

BACH provides two MCP servers for integration with Claude Code, Cursor, and other IDEs. Cross-platform tested on Windows, macOS (ARM64), and Linux:

# Install and configure MCP servers (recommended)
python system/bach.py setup mcp

# Or manually via npm:
npm install -g ellmos-codecommander-mcp ellmos-filecommander-mcp

Quick Start

# Start BACH
python bach.py --startup

# Create a task
python bach.py task add "Analyze project structure"

# Manage agents
python bach.py agent list
python bach.py agent start bueroassistent

# Manage prompts
python bach.py prompt list
python bach.py prompt add "My Prompt" --content "..."

# Check scheduler status
python bach.py scheduler status

# Shut down BACH
python bach.py --shutdown

Core Components

1. Task Management

Full GTD system with prioritization, deadlines, tags, and context tracking.

2. Knowledge System

Structured memory system with Facts, Lessons, and automatic consolidation (6 memory types, 210+ DB tables).

3. Agent Framework

11 Boss agents orchestrate 22 experts for complex tasks. The Agent CLI allows direct starting, stopping, and listing of agents via bach agent, and now also supports prelaunch steering queues, cooperative pause requests, and explicit safe-checkpoint acknowledgements via bach agent checkpoint. Queued hints are injected into the generated session CLAUDE.md at launch, OPERATOR_NOTES.md mirrors steering, pause, and checkpoint state, and live JSON status surfaces expose the nested operator_control snapshot for dashboards.

4. Prompt System

Central management of prompt templates with board collections and full versioning (bach prompt).

5. Chat Service & Bridge System

Multi-backend Telegram bot with pluggable LLM backends (Ollama, Claude CLI, Codex CLI, Claude API, OpenAI API), HTTP Control API with web dashboard, and cross-platform system tray. Connector framework for additional services (Email, WhatsApp, etc.) and USMC Bridge for cross-agent communication.

6. Automation

SchedulerService for time-based jobs (chains, tasks, scripts) and event-driven workflows via the hook framework.

7. SharedMemory

Multi-agent coordination with context generation, conflict detection, decay, and delta queries.

8. llmauto Integration

Chain steps as LLM prompts with bach:// URL resolution for dynamic context embedding.

The ellmos Family

All ellmos projects follow a water metaphor -- from a spring to a full stream:

TierProjectDescriptionRepository
1USMCUnited Shared Memory Client -- the spring (shared memory only)github.com/ellmos-ai/usmc
2RinnsalThe trickle -- USMC + llmauto (LLM orchestration), extremely compactgithub.com/ellmos-ai/rinnsal
3BACHThe stream that unites everything -- 113+ handlers, 1870+ skills, agents, GUI, bridgegithub.com/ellmos-ai/bach

Documentation

See Also: OpenClaw

How does BACH compare to OpenClaw, a popular open-source AI assistant?

BACHOpenClaw
FocusLLM Operating System -- deep autonomy, structured memory, multi-agent orchestrationPersonal AI Assistant -- broad messaging gateway, voice, companion apps
Tools/Skills550+ tools, 1870+ skills, 59 workflows (local, curated)Community-driven skill/plugin ecosystem; recent releases emphasize manifest-first plugin metadata and install safety
Memory6 memory types with decay, conflict detection, consolidation (210+ DB tables)Session/runtime workspace with bootstrap files such as AGENTS.md, TOOLS.md, USER.md, and related context files
AgentsBoss-Expert orchestration (11 boss agents + 22 experts), SharedMemory BusAgent runtime with multi-session/channel operation
MessagingTelegram, Email, WhatsApp (Bridge System)20+ platforms (WhatsApp, Telegram, Slack, Discord, Signal, Teams, Matrix...)
InterfacesCLI, Python API, PySide6 GUI, Web GUI, Telegram Bot, Web Chat, System TrayCLI, WebChat, macOS/iOS/Android apps, Voice
MCPOwn MCP servers (FileCommander, CodeCommander)Native MCP Registry
StackPython 3.10+, SQLiteTypeScript, Node.js 22+
LicenseMITMIT

In short: BACH goes deep (structured memory, autonomous agents, scheduler, 210+ DB tables). OpenClaw goes wide (20+ messengers, native apps, voice, large community). Different philosophies, complementary strengths.

Competitive Watch

As of 2026-06-13, the OpenClaw repository still marks 2026.6.6 as the latest stable release on GitHub, published on June 12, 2026, while the newest visible prerelease on the official release feed is now 2026.6.7-beta.1, published on June 13, 2026 at 09:42. The most relevant new beta signals for BACH are tighter channel delivery, safer auth/context boundaries, stronger recovery across agent, memory, Codex, cron, and update paths, clearer doctor/update progress reporting, and more trustworthy QA/release evidence.

On the BACH side, the clean GUI i18n state from 2026-06-12 remains intact at 17,593 exported translations with 0 missing GUI entries, and the 2026-06-13 care pass shifted to workflow coverage: a shared skills/workflows/SOFTWARE.md now links software usecases 41-49 to a real workflow file instead of manual fallback, while wiki-author.md was updated to the current wiki/ and hub/_services/wiki/ paths. Verification re-ran bach usecase run 41 --dry-run, bach usecase run-all --dry-run, and a focused test_tuev_handler.py regression (1 passed), which moved the dry-run overview from 15 workflow-backed / 35 manual usecases to 24 / 26. Next high-leverage steps remain deeper active-run steering inside long-running scheduler internals, installer end-to-end coverage, GUI regression coverage, and closing the remaining manual workflow gaps such as reflection_status and the larger domain buckets.

License

MIT License - see LICENSE for details.

Support


Deutsche Version

BACH ist ein textbasiertes Betriebssystem, das Large Language Models (LLMs) befähigt, eigenständig zu arbeiten, zu lernen und sich zu organisieren.

Die vollständige deutsche Dokumentation findest du hier: README.de.md


ellmos BACH v3.12.4-earth - Text-Based Operating System for LLMs


Haftung / Liability

Dieses Projekt ist eine unentgeltliche Open-Source-Schenkung im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß § 521 BGB auf Vorsatz und grobe Fahrlässigkeit beschränkt. Ergänzend gelten die Haftungsausschlüsse aus GPL-3.0 / MIT / Apache-2.0 §§ 15–16 (je nach gewählter Lizenz).

Nutzung auf eigenes Risiko. Keine Wartungszusage, keine Verfügbarkeitsgarantie, keine Gewähr für Fehlerfreiheit oder Eignung für einen bestimmten Zweck.

This project is an unpaid open-source donation. Liability is limited to intent and gross negligence (§ 521 German Civil Code). Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.

Ver o original no GitHub

Bom para

Relacionados