bernstein
Deterministic orchestrator for CLI coding agents (Claude Code, Codex, Gemini CLI, and 40+ more). No model in the coordination loop, so parallel runs in per-task git worktrees replay byte-identically. Signed lineage plus an opt-in HMAC audit chain a reviewer checks offline, without rerunning it. Cluster mode, air-gap deploy.
Decision gist · record as of 2026-08-14
Yes, if you are orchestrating multiple CLI coding agents and need deterministic replay, cryptographic auditability, and per-task isolation. The low install friction and active maintenance support the use case. No, if you need a stable API—beta status means minor versions may break interfaces, so pin carefully. No, if you are not using CLI agents or do not need replay and audit guarantees.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later.
- Requires at least one CLI agent installed and authenticated (e.g., Claude Code, Codex, Gemini CLI).
- Git must be available for per-task worktree isolation.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license; you can use, modify, and distribute freely in commercial and private projects, with attribution and no warranty.
last release 2026-08-14 (0 days) · last repo commit 2026-08-14 · 882 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 199,587 downloads/mo, #9,704 on PyPI
Alternatives
Verify before relying
# Install
uv tool install bernstein # or: pipx install bernstein
# Initialize and verify
bernstein init
bernstein doctor
# Run an agent task
bernstein -g "fix the failing test in tests/test_foo.py"
# Verify determinism
bernstein replay latest --verify- Whether all 40+ agent adapters are documented or discoverable in the package itself.
- Performance characteristics when running many agents in parallel (latency, resource overhead).
- Compatibility of the air-gap install profile with all runtime dependencies.
- Whether the HMAC audit chain and signed receipts are suitable for regulated compliance workflows.
What it is and what it does
Bernstein is a deterministic orchestrator for running multiple CLI coding agents in parallel. It coordinates tasks without an LLM in the scheduling loop—meaning a run is reproducible byte-for-byte when replayed with the same inputs and agent outputs. Each coding task runs in its own git worktree, isolated by default; coordination state (the task backlog) is shared and claimed atomically. The package records every run in a replay journal and maintains an always-on lineage spine that tracks lineage-bearing steps; an optional HMAC-chained audit log adds cryptographic receipts you can verify offline without rerunning the orchestration.
It ships with adapters for Claude Code, Codex, Gemini CLI, and 40+ other agents, plus a generic `--prompt` wrapper. You can watch runs live via a terminal dashboard (`bernstein live`) or browser dashboard (`bernstein gui serve`), and verify determinism by replaying a recorded run and checking for divergence. The package includes air-gap deployment support and is built on fastapi, cryptography, and opentelemetry for observability. It's beta software, solo-maintained, and actively developed; minor versions may change interfaces.
Use it for
- Run multiple coding agents on the same task in parallel and compare their outputs deterministically, with cryptographic proof of what each agent produced.
- Verify that a multi-agent workflow produces identical results when replayed with the same inputs, catching non-determinism at the exact step it occurs.
- Build compliance-auditable agent workflows where every step is signed and can be verified offline by a reviewer without access to live infrastructure.
- Coordinate agent tasks across a cluster with per-task isolation, ensuring agents cannot interfere with each other's working directories or shared state.
- Record and replay agent-driven code generation or testing workflows to debug failures or reproduce issues from a previous run.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are orchestrating multiple CLI coding agents and need deterministic replay, cryptographic auditability, and per-task isolation.
The low install friction and active maintenance support the use case. No, if you need a stable API—beta status means minor versions may break interfaces, so pin carefully. No, if you are not using CLI agents or do not need replay and audit guarantees.
Install
bernstein on PyPI
Before you install
Low friction: pure Python wheel with 34 runtime dependencies including fastapi, cryptography, and opentelemetry. Active maintenance (last commit 2026-08-14, 882 stars); beta status means minor versions may change interfaces—pin the version if you depend on it. Requires Python 3.12+.
Requires Python 3.12 or later. Requires at least one CLI agent installed and authenticated (e.g., Claude Code, Codex, Gemini CLI). Git must be available for per-task worktree isolation.
License in practice
Apache-2.0 permissive license; you can use, modify, and distribute freely in commercial and private projects, with attribution and no warranty.
Quickstart
# Install
uv tool install bernstein # or: pipx install bernstein
# Initialize and verify
bernstein init
bernstein doctor
# Run an agent task
bernstein -g "fix the failing test in tests/test_foo.py"
# Verify determinism
bernstein replay latest --verifyVerify before relying
- Whether all 40+ agent adapters are documented or discoverable in the package itself.
- Performance characteristics when running many agents in parallel (latency, resource overhead).
- Compatibility of the air-gap install profile with all runtime dependencies.
- Whether the HMAC audit chain and signed receipts are suitable for regulated compliance workflows.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 34 packagesasn1cryptocbor2clickcryptographydefusedxmlfastapihttpxidnajsonschemakeyringmcpopenaiopentelemetry-apiopentelemetry-exporter-otlpopentelemetry-sdkpackagingpillowpluggyprometheus-clientpydantic-settingspyfigletpython-dotenvpython-frontmatterpyyamlreportlabrichsetproctitlesignxmlstarletteterminaltexteffects |
| Maintenance | Actively maintained 0 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 199,587 / month, #9,704 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersIntended Audience :: System AdministratorsLicense :: OSI Approved :: Apache Software LicenseOperating System :: MacOSOperating System :: Microsoft :: WindowsOperating System :: OS IndependentOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software DevelopmentTopic :: Software Development :: Build ToolsTopic :: Software Development :: Code GeneratorsTopic :: Software Development :: Quality AssuranceTopic :: System :: Distributed ComputingTyping :: Typed |
Evidence: bernstein-3.15.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “multi-agent orchestration cli”
- bernsteinBernstein orchestrates parallel CLI coding agents (Claude Code,…
- ai-parrotAI-Parrot is an async-first Python framework for building, extending,…
- pydantic-deepA Python framework and terminal assistant for building autonomous AI…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also langgraph · google-agents-cli · opencode-agent-hub · trinity-agent · agent_governance_toolkit · ouroboros-ai · langgraph-supervisor · agent-framework-core · agentops · pydantic-deep