Agent Black Box v0.1.0 Local Alpha
Pre-releaseAgent Black Box v0.1.0 Local Alpha
This is the first public local-alpha release of Agent Black Box: a local-first flight recorder, replay debugger, and handoff kit for AI agent workflows.
Landing page:
https://razistuff.github.io/agent-black-box/
What Is Included
- Local trace recording with
abb record - Run inspection with
abb runs,abb show,abb artifacts, andabb search - Replay fixtures with
abb fixture createandabb replay - Run diffing with
abb diff - Handoff packets with
abb handoff - Portable
.abbbundles withabb bundle exportandabb bundle import - Compare packets for request/response and input/output debugging
- Local HTTP API discovery with
abb endpoints --jsonandabb endpoints --openapi - Agent integration kit generation with
abb agent-kit - Local run deletion with
abb delete RUN_ID --yes - Browser dashboard via
abb start
Download
Recommended for design partners:
agent-black-box-0.1.0-design-partner.zip
Package artifacts:
agent_black_box-0.1.0-py3-none-any.whlagent-black-box-0.1.0.tar.gz
Design Partners
We are looking for the first three public design partners for the local alpha.
- Public call: #1
- Apply to test: https://github.com/RaziStuff/agent-black-box/issues/new?template=design_partner_application.yml
- Share alpha feedback: https://github.com/RaziStuff/agent-black-box/issues/new?template=alpha_feedback.yml
Quick Start
unzip agent-black-box-0.1.0-design-partner.zip
cd agent-black-box-0.1.0-design-partner
sh install.sh
. .venv/bin/activate
abb doctor
abb record -- python3 examples/basic_agent.py
abb runsLocal-First Privacy
Agent Black Box stores data locally by default in .abb/. Handoff JSON files are compact summaries and do not include full artifact payloads. Full portable .abb bundles should be shared intentionally because they can include local trace artifacts.
Use abb delete RUN_ID --yes to remove a run, its local trace rows, replay fixtures, artifact rows, unreferenced artifact object files, and default export files. Use --keep-exports when you want to delete the run but keep generated export files.
Verification
The release was verified with:
python3 -m unittest discover -s testspython3 scripts/release-readiness.py --skip-smoke --no-reportsh scripts/smoke.sh- Fresh clone build, wheel install,
abb doctor,abb record, andabb delete
Known environment skips during local smoke:
- Browser UI render smoke requires Playwright.
- HTTP client smoke may require local socket permissions in restricted sandboxes.
Checksums
agent_black_box-0.1.0-py3-none-any.whl
SHA-256: 38769901a1fa13ca536413adce6ffe5af461c5b0108325cc77227294fc0110e9
agent-black-box-0.1.0.tar.gz
SHA-256: 4d81eec3fad71c41cd6fec330ac276f8f6385e8d42fc740e0da5633f18159451
agent-black-box-0.1.0-design-partner.zip
SHA-256: 20e3f38638c03fd24a94199ef2d058313214055c1a05a7fb67f678f5cc91db62