Home/AI Agents/bernstein

bernstein

sipyourdrink-ltd/bernstein

Audit-grade multi-agent orchestration for CLI coding agents

GitHub Website

GraphCanon updated today · GitHub synced today

657

Stars

Forks

Open issues

Watchers

today

Last push

Python Apache-2.0Created Mar 22, 2026

Trust & integrity

Full report

Maintenance: Very active (0d since push); As of today · Source: github_public_v1
Provenance: Not a fork · Organization account; As of today · Source: github_public_v1
Security (OSV): 1 medium (1 medium); As of today · Source: mcp_manifest@v1

Public GitHub metadata and optional OSV dependency scans. Signals, not a guarantee. Trust methodology.

Overview

Bernstein is an orchestrator designed for managing multiple AI coding agents in a secure and verifiable environment. It supports HMAC-chained audit logs, signed agent cards, per-artifact lineage tracking, and air-gapped deployment options.

Capability facts

Deploy: Self-host
Source: dockerfile:Dockerfile · Jul 12, 2026
Docker: Dockerfile present
Source: dockerfile:Dockerfile · Jul 12, 2026
CLI: CLI entrypoint
Source: pyproject.toml:[project.scripts] · Jul 12, 2026
MCP server: No MCP server detected
Source: repo_scan · Jul 12, 2026
Languages: python
Source: github.language+pyproject.toml · Jul 12, 2026

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Node.js runtimeNode.js

Source: README excerpt (regex_v1, Jul 11, 2026)

See the full [install matrix](#install) for `dnf copr`, `npx`, optional extras, and the wheelhouse path for air-gapped sites.

Source link

Python runtimePython

Source: README excerpt (regex_v1, Jul 11, 2026)

The one-liner scripts check for Python 3.12+, bootstrap pipx when it's missing, fix PATH for the current session, and insta

Source link

README

install in 30 seconds

pipx install bernstein
bernstein init
bernstein run -g "fix the failing test in tests/test_foo.py"

See installed integrations: bernstein integrations list --installed.

other install methods

curl -fsSL https://bernstein.run/install.sh | sh        # macOS / Linux one-liner
irm https://bernstein.run/install.ps1 | iex             # Windows PowerShell
pip install bernstein                                   # pip
uv tool install bernstein                               # uv
brew tap chernistry/tap && brew install bernstein       # Homebrew

See the full install matrix for dnf copr, npx, optional extras, and the wheelhouse path for air-gapped sites.

quick start

cd your-project
bernstein init                    # creates .sdd/ workspace + bernstein.yaml
bernstein -g "Add rate limiting"  # agents spawn, work in parallel, verify, exit
bernstein live                    # watch progress in the TUI dashboard
bernstein stop                    # graceful shutdown with drain

For multi-stage projects, define a YAML plan:

bernstein run plan.yaml           # skips LLM planning, goes straight to execution
bernstein run --dry-run plan.yaml # preview tasks and estimated cost

install

Method	Command
One-liner (macOS / Linux)	`curl -fsSL https://bernstein.run/install.sh \| sh`
One-liner (Windows)	`irm https://bernstein.run/install.ps1 \| iex`
pip	`pip install bernstein`
pipx	`pipx install bernstein`
uv	`uv tool install bernstein`
Homebrew	`brew tap chernistry/tap && brew install bernstein`
Fedora / RHEL	`sudo dnf copr enable alexchernysh/bernstein && sudo dnf install bernstein`
npm (wrapper)	`npx bernstein-orchestrator`
Docker (GHCR)	`docker run --rm -v "$PWD:/work" -w /work -e ANTHROPIC_API_KEY ghcr.io/sipyourdrink-ltd/bernstein:latest run -g "fix tests/test_foo.py"`

The one-liner scripts check for Python 3.12+, bootstrap pipx when it's missing, fix PATH for the current session, and install (or upgrade) bernstein. Script sources: install.sh · install.ps1.