VulcanBench v0.1.0
VulcanBench v0.1.0
First public release of VulcanBench — an open-source LLM benchmark for realistic, multi-file software engineering tasks.
Highlights
- 52 gold-verified tasks across Python, Go, TypeScript, and Rust
- Real tool-calling agent loop with mock, OpenAI, and Anthropic providers
- Docker sandbox (default): isolated, non-root, network-off command execution
- Five-metric scoring: functional, quality, security, efficiency, human_like (3-judge ensemble)
- Suite tooling:
--repeat,--max-concurrency,--max-cost,--fail-under, effort sweeps - Artifacts: JSONL trace,
summary.json,final.patch, self-containedreplay.html - CLI: leaderboard, report, calibration, replay
- FastAPI backend + Next.js dashboard (filesystem or Postgres)
- CI: lint, typecheck, ≥80% harness coverage, task validation, sandbox image builds
Quick start
git clone https://github.com/morganlinton/VulcanBench.git
cd VulcanBench
make setup
source .venv/bin/activate
vulcanbench --helpFree smoke test (no API key):
vulcanbench run --task hello-world --model mock:synthetic --sandbox local --no-judgesReal model run (build sandbox image first):
make sandbox-image
export OPENAI_API_KEY=...
vulcanbench run --task py-topo-sort-cycle --model openai:gpt-4o-mini --no-judgesDashboard + API:
pip install -e ".[backend]"
uvicorn backend.app:app --port 8000
cd dashboard && npm install && npm run dev # http://localhost:3000Documentation
Notes
- Install from source with
pip install -e ".[dev,test]"— the task corpus and sandbox Dockerfiles ship in the repo clone. - Bring your own API keys; see README provider terms.
- Apache 2.0 licensed.
Full changelog: CHANGELOG.md