้ฆ้กต
>
AIๅๆฒฟ
>
Jukebox-OS: Deterministic time-travel replay and ACID tool sandbox for AI agents
Jukebox-OS: Deterministic time-travel replay and ACID tool sandbox for AI agents
___________________________________________________________________________ / \ | โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ | | โ โโโโโโ โโโโโโ โโโโโโโโโโโโโโโโโโ โโโโโโโ โโโ โโโ โ | | โ โโโโโโ โโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ | | โ โโโโโโ โโโโโโโโโโ โโโโโโ โโโโโโโฆโโโโ โโโ โโโโโโ [ EST. 76 ] โ | | โโโ โโโโโโ โโโโโโโโโโ โโโโโโ โโโโโโโโโโโ โโโ โโโโโโ โ | | โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโฆโโโโโโโโโโโโโโ โโโ โ | | โ โโโโโโ โโโโโโโ โโโ โโโโโโโโโโโโโโโโโโ โโโโโโโ โโโ โโโ โ | | โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ | | ========================================================================= | | โ
24-HOUR DETERMINISTIC AGENT RUNTIME โข ACID SANDBOX โข TIME-TRAVEL โ
| \___________________________________________________________________________/ || || โโโโโโโโโโโโโโ "DROP THE NEEDLE ON ANY FRAME" โโโโโโโโโโโโโโ ๐ J U K E B O X ๐ฎ The Deterministic Flight-Recorder, ACID Tool Sandbox & Time-Travel Runtime for Multi-Agent Systems [ ๐๏ธ NOW PLAYING ON TRACK #01 ] Stop letting autonomous agents trash your production database and burn $400 in runaway loops. JUKEBOX records every LLM prompt, token stream, MCP tool call, and filesystem mutation onto a cryptographic vinyl tape (.jbx)โgiving your agents BEGIN / COMMIT / ROLLBACK semantics and <1ms zero-cost time-travel replay. [ ๐๏ธ NOW PLAYING ON TRACK #01 ] Stop letting autonomous agents trash your production database and burn $400 in runaway loops. JUKEBOX records every LLM prompt, token stream, MCP tool call, and filesystem mutation onto a cryptographic vinyl tape (.jbx)โgiving your agents BEGIN / COMMIT / ROLLBACK semantics and <1ms zero-cost time-travel replay. ๐ฝ๏ธ Today's Specials (Features) โข ๐ฅ The Blue Plate Special (Quickstart) โข ๐ A La Carte Menu (Architecture) โข ๐ Counter Service & Drive-Thru (CLI) โข ๐ฅ Chef's Table (Benchmarks) โข ๐ช Tipping the Cooks (Contributing) ๐ Today's Specials (Why JUKEBOX?) Modern agent frameworks (LangGraph, AutoGen, CrewAI, OpenAI Agents SDK) are great at orchestrating prompts, but they treat side effects as fire-and-forget. When a 15-step agent workflow hallucinates on Step 12 after mutating three SQL tables and five local files on Step 8, "checkpointing the chat history" won't save you. JUKEBOX (architected by Marius Carlsson) is a systems-level runtime written in Rust with Python bindings that brings database-grade ACID transactions and deterministic vinyl replay to any AI agent stack: ๐ฅ The Blue Plate Special (60-Second Quickstart) 1. Slide Into a Booth (Installation) git clone https://github.com/socrates6969/jukebox-os.git cd jukebox-os pip install -e . 2. Wrap Any Agent in a Transactional Vinyl Track import asyncio from jukebox import Jukebox, SandboxPolicy, CircuitBreaker jb = Jukebox( tape_dir="./tapes", sandbox=SandboxPolicy(filesystem="copy_on_write", mcp_mode="staged_acid"), breaker=CircuitBreaker(max_cost_usd=0.50, max_semantic_repeat=3), ) @jb.track(name="invoice-reconciliation-agent") async def run_accounting_agent(customer_id: str, amount_usd: float) -> dict: async with jb.transaction(tape_id="tr_8f92a1c4") as tx: tx.record_agent_turn( agent_name="planner", message=f"Staging refund of ${amount_usd} for {customer_id}", model="gpt-4o", cost_usd=0.008, ) tx.stage_file_write( path="./tapes/staged_ledger_demo.json", content=f'{{"customer": "{customer_id}", "refund_usd": {amount_usd}}}', ) if amount_usd > 500.0: await tx.rollback(reason="Refund exceeds $500 autonomous threshold") return {"status": "ROLLED_BACK", "tape_id": tx.tape_id} await tx.commit() return {"status": "COMMITTED", "tape_id": tx.tape_id} if __name__ == "__main__": print(asyncio.run(run_accounting_agent("cust_9981", 420.00))) 3. Drop the Needle: Time-Travel Forking in Python from jukebox import Tape tape = Tape.load("./tapes/tr_8f92a1c4.jbx") b_side = tape.fork( at_frame=3, override_model="claude-3-7-sonnet-latest", override_system_prompt="You are a strict SQL auditor. Never issue DELETE without a WHERE clause.", ) print(b_side.replay_and_diff().to_markdown()) ๐ A La Carte Menu (System Architecture) +-----------------------------------------------------------------------------------+ | APPLICATION & ORCHESTRATION LAYER | | [ LangGraph ] [ CrewAI ] [ AutoGen ] [ OpenAI / Anthropic SDK ] | +-----------------------------------------+-----------------------------------------+ | @jukebox.track / MCP Proxy v +-----------------------------------------------------------------------------------+ | ๐ JUKEBOX RUST CORE RUNTIME (libjukebox) ๐ฎ | | | | +-------------------------+ +-----------------------+ +---------------------+ | | | ANTI-SKIP NEEDLE | | BLAKE3 MERKLE CAS | | OTEL GEN_AI | | | | โข Cosine Loop Breaker | | โข Zero-Cost Replay | | EXPORTER | | | | โข Token Budget Gate | | โข .jbx Binary Tape | | โข Spans & Metrics | | | +-------------------------+ +-----------------------+ +---------------------+ | | | | +-----------------------------------------------------------------------------+ | | | SHADOW BOOTH: TRANSACTIONAL WASI & CoW SANDBOX | | | | [ Virtual CoW Filesystem ] [ SQL Savepoint Proxy ] [ MCP Stage Gate ] | | | +--------------------------------------+--------------------------------------+ | +-----------------------------------------|-----------------------------------------+ | +--------------------+--------------------+ | | [ VERIFIER PASSES ] [ VERIFIER FAILS ] | | v v ( ATOMIC WORLD COMMIT ) ( INSTANT ZERO-RESIDUE ) Writes flushed to Disk/API ROLLBACK & ALERT ๐ Counter Service & Drive-Thru (CLI & TUI) # List recent agent flight recordings in your local booth $ jukebox ls --tape-dir ./tapes ๐ JUKEBOX 24-HOUR FLIGHT RECORDER // LOCAL BOOTH TAPES ๐ฎ ------------------------------------------------------------------------------ TRACK ID AGENT NAME FRAMES COST STATUS ------------------------------------------------------------------------------ tr_8f92a1c4 invoice-reconciliation-agent 5 $0.0080 COMMITTED # Replay & cryptographically verify a .jbx Merkle tape in <1ms $ jukebox replay ./tapes/tr_8f92a1c4.jbx ๐ฅ Chef's Table / The Line (Benchmarks) ๐ช Tipping the Cooks (Contributing & Community) Fork the Repo & Pull Up a Stool: git clone https://github.com/socrates6969/jukebox-os.git cd jukebox-os pip install -e . pytest pytest -v git clone https://github.com/socrates6969/jukebox-os.git cd jukebox-os pip install -e . pytest pytest -v House Rules (Code of Conduct): Read our CODE_OF_CONDUCT.md and CONTRIBUTING.md. โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ BUILT WITH CHROME, NEON & RUST BY MARIUS CARLSSON (@mariuscarlsson) โ โ "THANK YOU FOR DINING AT JUKEBOX โ DRIVE SAFELY!" โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โญ Star jukebox-os on GitHub โข ๐ฎ Launch Live 24-Hr Diner Inspector