Skip to content

Latest commit

 

History

History
190 lines (130 loc) · 21.8 KB

README.it.md

File metadata and controls

190 lines (130 loc) · 21.8 KB
Bernstein
Bernstein - deterministic multi-agent CLI orchestration

"To achieve great things, two things are needed: a plan and not quite enough time." - attributed to Leonard Bernstein

orchestrazione deterministica di agenti CLI multi-agente

CI PyPI GHCR Python 3.12+ License OpenSSF Scorecard CodeQL Open in Codespaces MCP Toplist Ask DeepWiki

website · docs · install · first run · glossary · limitations · name policy · sponsor

简体中文 · 繁體中文 · 日本語 · 한국어 · हिन्दी · বাংলা · Русский · Español · Português · Deutsch · Français · Italiano · Nederlands · Polski · Svenska · Suomi · Українська · Türkçe · العربية · עברית · Bahasa Indonesia · Tiếng Việt · ไทย


Stato: beta. Mantenuto da una sola persona, in sviluppo attivo. Il numero di versione conta i rilasci, non la maturità: le versioni minori possono modificare le interfacce. Fissa la versione per qualsiasi dipendenza critica; le regressioni vengono risolte rapidamente, segnalale.

Bernstein è un orchestratore deterministico per agenti di codifica CLI (Claude Code, Codex, Gemini CLI e oltre 40 altri). Li esegue in parallelo, controlla ciò che producono tramite gate e registra una quantità di dati sufficiente per consentire verifiche successive. Profilo di installazione air-gap incluso. Apache-2.0.

in sintesi

Quattro elementi lo contraddistinguono; tutto il resto sono dettagli.

  • Nessun LLM nel ciclo di coordinamento. La pianificazione è in puro Python, rendendo ogni esecuzione riproducibile da cima a fondo. Riproduci il piano di ieri e otterrai esattamente il grafo delle attività di ieri.
  • Verificabile a posteriori. Il giornale di replay registra ogni esecuzione, e la colonna vertebrale di lineage sempre attiva memorizza ogni passaggio dotato di tracciabilità; il log di audit opzionale concatenato con HMAC (BERNSTEIN_AUDIT=1) aggiunge ricevute verificabili offline. Il non determinismo emerge come discrepanza di hash nel passaggio esatto, non come riesecuzione intermittente. I deliverable non costituiti da codice ricevono lo stesso trattamento: un task può dichiarare un contratto di artefatto (report, dataset, log di azioni, risultati ops) e si conclude con una ricevuta di lineage firmata anziché un commit git.
  • Isolato per progettazione. Ogni task di codifica ottiene il proprio git worktree protetto da merge gate; i task in modalità artefatto ottengono una directory di lavoro in .sdd/workspaces/. Gli agenti non condividono alcuno spazio di lavoro modificabile per impostazione predefinita; l'unico stato condiviso è il backlog dei task, acquisito in modo atomico. Restrizioni più severe sul filesystem sono opzionali, fornite dai backend sandbox. Disattivando i worktree, ogni task viene eseguito nel checkout condiviso.
  • Ampio e locale. Oltre 40 adapter per agenti CLI più un wrapper generico --prompt, stato basato su file, nessun passaggio SaaS, nessun piano dati di terze parti.

L'elenco completo è disponibile nella pagina delle funzionalità; la matrice delle caratteristiche costituisce l'indice esaustivo.

installazione in 30 secondi

uv tool install bernstein    # or: pipx install bernstein
bernstein init
bernstein doctor             # checks a CLI agent is installed and authenticated
bernstein -g "fix the failing test in tests/test_foo.py"

pipx, pip, brew, dnf, npm e Docker sono trattati nella guida all'installazione; la wheelhouse per ambienti isolati dispone della propria guida air-gap.

A real bernstein demo run: mock agents fix four seeded bugs, ending on the run's signed receipt verifying offline

La registrazione sopra mostra un'esecuzione reale e include la propria prova. La registrazione, la ricevuta firmata derivata dal giornale di quell'esecuzione e la chiave pubblica associata si trovano in docs/assets/demo-run/. Verifica l'esecuzione appena visualizzata, offline:

bernstein verify receipt docs/assets/demo-run/run-receipt.json \
    --public-key docs/assets/demo-run/run-receipt.pub.pem

La CI riverifica la ricevuta salvata a ogni push su main — dimostrando che una copia manomessa fallisce — affinché l'evidenza pubblicata non diventi un semplice file decorativo. scripts/record_demo.sh rigenera registrazione, ricevuta e chiave da una nuova esecuzione reale; nulla nel terminale è sintetizzato.

Un'esecuzione in corso può essere monitorata da entrambe le interfacce operatore. Entrambe leggono la stessa API dei task, garantendo che nessuna delle due sia uno specchio in ritardo dell'altra. In bernstein live, le colonne sinistra e destra scorrono in modo indipendente come pannelli completi, mantenendo i widget accessibili anche su terminali compatti.

A two-column terminal dashboard - agents with their live logs on the left, the task board on the right - with a full-width activity feed and a cost line underneath A browser dashboard listing sixty-two tasks with eleven running, one of them opened to its working-tree diff
bernstein live — la dashboard da terminale bernstein gui serve — la dashboard da browser

provare un'esecuzione

Il determinismo qui è una proprietà che puoi verificare, non un dogma da accettare per fede. Esegui una volta con l'audit abilitato, quindi verifica quanto registrato:

BERNSTEIN_AUDIT=1 bernstein -g "fix the failing test in tests/test_foo.py"
bernstein replay list                 # run ids recorded on disk
bernstein replay latest --verify      # recompute the journal head, name the first divergent step
bernstein lineage verify <run_id>     # recompute the always-on lineage spine
bernstein audit verify                # HMAC chain + Merkle seal (written because audit was enabled)
bernstein audit diagnose <run_id> --signal gate --sign-key KEY
                                      # name the exact step a failure entered the run, as a signed receipt
bernstein verify run <run_id> --signing-key-path key.pem   # sign one portable run receipt
bernstein verify receipt .sdd/runs/<run_id>/run-receipt.json  # verify it offline: file only

Il giornale viene scritto a ogni esecuzione; la colonna vertebrale di lineage è sempre attiva e acquisisce una voce per ogni passaggio tracciabile, consentendo a un'esecuzione breve di terminare con una struttura valida e vuota. bernstein audit verify ha una catena da controllare solo quando l'esecuzione è stata avviata con BERNSTEIN_AUDIT=1, un preset di conformità o bernstein run --audit. Il flag --audit appartiene a bernstein run; nella forma bernstein -g sopra, imposta la variabile di ambiente.

Una ricevuta di esecuzione vincola la testa del giornale, la testa della colonna vertebrale di lineage (se sono state scritte voci) e, opzionalmente, un intervallo della catena di audit, sotto un unico soggetto firmato con Ed25519 con chiave pubblica incorporata. Un revisore in possesso di tale file e della chiave pubblica dell'operatore può confermare che le azioni e le catene incorporate non sono state alterate: nessuna chiave HMAC richiesta, nessun ambiente .sdd/ attivo e codice di uscita 2 con indicazione del primo passaggio divergente in caso di manomissione. Tale ricevuta identifica lo stato del giornale incorporato; dimostrare che tale stato corrisponde all'intero giornale completato richiede inoltre un sigillo indipendente di testa/conteggio. Con il solo file senza vincolo --public-key, il controllo verifica unicamente l'integrità interna. Dettagli in replay deterministico.

La stessa verificabilità si applica ai parametri di valutazione. bernstein bench run <suite> --reliability k (anche scritto bernstein eval --reliability k) esegue ciascun task k volte con coordinamento fisso, riportando la soglia minima pass^k (tutti i k tentativi devono riuscire) insieme alla soglia massima pass@1. Tale risultato è sigillato in una ricevuta firmata che bernstein bench reliability-verify ricalcola offline, invalidando qualsiasi valore falsificato. Dettagli: soglia di affidabilità pass^k.

come funziona

Ogni obiettivo attraversa quattro fasi:

  1. Decomposizione (Decompose). Il manager suddivide l'obiettivo in task con ruoli, file assegnati e segnali di completamento. Una singola chiamata LLM, poi esclusivamente puro Python.
  2. Creazione (Spawn). Gli agenti si avviano in git worktrees isolati, uno per ciascun task di codifica; i task in modalità artefatto ottengono una directory di lavoro standard. Il branch principale resta pulito.
  3. Verifica (Verify). Il janitor verifica segnali concreti: test superati, file presenti, lint conforme, tipi corretti.
  4. Unione (Merge). Il lavoro verificato entra in main. I task non riusciti vengono ritentati o reindirizzati a un modello differente.

Perché lo scheduler è in puro Python e quali sono i compromessi adottati: perché deterministico.

comandi quotidiani

cd your-project
bernstein init                    # creates .sdd/ workspace, bernstein.yaml + templates/
bernstein -g "Add rate limiting"  # agents spawn, work in parallel, verify, exit
bernstein live                    # watch progress in the TUI dashboard
bernstein run plan.yaml           # multi-stage plan: skip LLM planning, execute directly
bernstein stop                    # graceful shutdown with drain

L'intera interfaccia operatore (automazione PR, pianificazioni, bridge di chat, demone autofix) è descritta in comandi operatore.

Gate di igiene del repository: bernstein readme-l10n verify blocca le PR i cui README tradotti divergono dalla versione inglese (indicando la sezione obsoleta), mentre bernstein readme-l10n sync aggiorna i collegamenti dopo modifiche al testo inglese. Consulta readme-l10n.

agenti supportati

Claude Code, Codex CLI, Gemini CLI, GitHub Copilot CLI, Cursor, Aider, Goose, Muse Code, OpenAI Agents SDK, Amp, Cody, Continue, Devin Terminal, Junie, Kilo, Kiro, AWS Q Developer, Ollama, OpenCode, OpenHands, Open Interpreter, gptme, Plandex, AIChat, Letta Code, Qwen e altri ancora. L'indice degli adapter contiene i comandi di installazione per 30 di essi. bernstein integrations list elenca tutte le 51 integrazioni collegate da src/bernstein/adapters/registry.py, unica fonte di verità. 49 sono adapter per agenti selezionabili; le altre due righe corrispondono allo stub di test mock e al profilo endpoint self-hosted-endpoints. Qualsiasi altro strumento dotato di flag --prompt funziona tramite il wrapper generico.

Combina agenti diversi nella stessa esecuzione: modelli locali economici per il codice boilerplate, modelli cloud più potenti per le scelte architetturali. bernstein integrations list --installed mostra gli strumenti disponibili sul tuo sistema.

oltre la pagina principale

Tutte le informazioni approfondite sono disponibili sul sito della documentazione:

pagina argomenti trattati
capabilities elenco completo delle funzionalità: modalità server MCP, schede agenti firmate, backend sandbox, sink di artefatti, conformità normativa
who this is for in quali contesti porta valore e quando Bernstein non è lo strumento appropriato
workflows DAG dichiarativi in YAML composti da nodi agent / command / loop
web UI dashboard web basata sulla stessa API impiegata dalla TUI
cloud execution sperimentale: esegui agenti su Cloudflare Workers con sincronizzazione workspace su R2 tramite il tuo account. Il servizio gestito api.bernstein.run non è ancora disponibile
datasources ricevute di query in sola lettura e driver che collega ciascun risultato allo snapshot dello schema corrispondente
agent catalogs indirizza i ruoli a definizioni di agenti esterne ai template inclusi: directory generiche YAML/SKILL.md o alberature di plugin Claude Code
security scorecard, fuzzing, irrobustimento
architecture funzionamento interno del sistema

perché questo nome?

Bernstein prende il nome da Leonard Bernstein, celebre direttore d'orchestra e compositore statunitense. Il progetto dirige un team di agenti di codifica CLI nello stesso modo in cui Bernstein guidava la Filarmonica di New York: ogni esecutore al momento giusto, la partitura deterministica, il direttore responsabile del risultato complessivo.

ho creato bernstein perché spendevo 400 $/mese in fatture claude eseguendo tre agenti di codifica in parallelo e ottenendo merge non deterministici. Apache 2.0, mantenuto da una sola persona. Statistiche in tempo reale: bernstein.run.

menzioni e citazioni

Incluso in vinta/awesome-python, recensito nella panoramica di Augment Code sugli orchestratori di agenti open source e citato in Python Weekly #742. Abbiamo inoltre documentato questo approccio come pattern di orchestrazione deterministica senza LLM in awesome-agentic-patterns.

Tutte le citazioni: oltre 20 liste awesome, directory, newsletter e riferimenti tra pari

L'elenco completo monitorato, comprendente ogni voce in elenchi awesome, cataloghi, citazioni di stato dell'arte e menzioni in newsletter, è disponibile in docs/mentions.md. Nuove voci vengono aggiunte progressivamente; correzioni e integrazioni sono benvenute via issue o PR.

contribuzione, supporto, licenza

I contributi via PR sono benvenuti; CONTRIBUTING.md descrive configurazione e convenzioni di codice. Le segnalazioni di sicurezza vanno inoltrate tramite SECURITY.md. Se Bernstein ti fa risparmiare tempo: GitHub Sponsors. Contatto: forte@bernstein.run.

I metadati di citazione si trovano in CITATION.cff. Licenza: Apache-2.0; il nome del progetto è tutelato separatamente in TRADEMARKS.md.


Alex Chernysh · GitHub · X · bernstein.run