# sipyourdrink-ltd/bernstein

The open-source governance layer for AI agents: write the rules declaratively, Bernstein enforces them and produces the verifiable, replayable record. Free, Apache-2.0. https://bernstein.run

Repository: https://github.com/sipyourdrink-ltd/bernstein
Canonical: https://ross.abutalabs.com/products/bernstein
Homepage: https://bernstein.run
Language: Python
License: Apache-2.0
License Family: permissive
Topics: agent-orchestrator, deterministic-replay, air-gap, audit-trail, provenance, reproducibility, git-worktree, agent-fleet, orchestrator, parallel-agents, agent-infrastructure, ai-orchestration, attestation, audit-log, llm-orchestration, tamper-evident, agent-governance, ai-agents, ai-governance, compliance
Last push: 2026-09-03T02:01:53+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 100, release rhythm 88, longevity 11
- inputs: {"age_days": 164, "days_push": 0, "days_rel": 2, "gap_med": 0.0, "n_releases_24m": 151}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1079, forks 149 (observed 2026-09-03T02:15:17.910540+00:00)

## What it is
Bernstein is a deterministic Python scheduler that orchestrates CLI coding agents (Claude Code, Codex, Gemini CLI, Aider, and 40+ more) running in parallel, each isolated in its own git worktree. It keeps the model out of the coordination loop so runs replay byte-identically, and provides signed lineage plus an opt-in HMAC audit chain that reviewers can verify offline.

## Use cases
- run multiple cli coding agents in parallel on one codebase
- get deterministic, byte-identical replays of agent coding runs
- isolate each agent task in its own git worktree
- audit ai coding agent runs with a tamper-evident hmac log
- deploy agent orchestration on-prem or air-gapped
- gate agent-generated diffs on lint, types, and tests before merging
- orchestrate claude code, codex, and gemini cli from one scheduler

## When to choose
- you run several coding agents in parallel and suffer nondeterministic merges
- you need reproducible, provable agent runs with signed lineage for compliance
- you want per-task git worktree isolation with quality gates before merge
- you need air-gapped or on-prem agent orchestration
- you want a model-free coordination loop so scheduling is deterministic

## When to avoid
- you need a single-agent assistant rather than a multi-agent orchestrator
- you want the model itself to make coordination and routing decisions
- you need a fully stable tool - it is beta software built by a solo maintainer
- you prefer in-process plugin extensibility over subprocess-isolated adapters

## Facets
- artifact type: cli-tool
- maturity: active
- function: agent-framework, workflow-automation, developer-tools, cli, version-control, security, scheduling
- domain: developer-tools, large-language-models, version-control, security
- platform: python, cli, self-hosted, cross-platform
- tags: agent-orchestrator, deterministic-replay, git-worktree, audit-trail, hmac-audit-log, air-gap, parallel-agents, cli-coding-agents, provenance, reproducibility, mcp-server, multi-agent, beta-software, ai-agents, automation, linux, macos, docker

## Member repositories
- sipyourdrink-ltd/bernstein (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:17.910540+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:16:09.372674+00:00, confidence not recorded.
  - readme: https://github.com/sipyourdrink-ltd/bernstein (fetched 2026-09-03T02:15:17.910540+00:00, sha 9cfb71e90de7)
  - homepage: https://bernstein.run (fetched 2026-08-29T13:14:18.954328+00:00, sha 0038238fd0dd)
  - site_page: https://bernstein.run/about (fetched 2026-08-29T13:14:18.967632+00:00, sha 13c92c2ce703)
  - registry_pypi: https://pypi.org/pypi/bernstein/json (fetched 2026-08-29T13:14:18.970726+00:00, sha f7e92c755a5c)
  - site_page: https://bernstein.run/blog/v3-14-159-pi (fetched 2026-08-29T13:14:18.964026+00:00, sha 9877b6e0bb10)
- Data as of 2026-08-30T08:39:29.467469+00:00.