# ChorusGraph

One canonical identity. Human page: https://www.insightits.com/products/chorusgraph.html

| Field | Value |
|-------|-------|
| Slug | `chorusgraph` |
| Status | published |
| Family | agentRuntime |
| Infra category | Agent Runtime |
| Record type | product |
| Parent | — |
| JSON | https://www.insightits.com/catalog/chorusgraph.json |
| Markdown | https://www.insightits.com/catalog/chorusgraph.md |
| GitHub | https://github.com/insightitsGit/ChorusGraph |
| PyPI | https://pypi.org/project/chorusgraph/1.3.0/ |
| Install | `pip install "chorusgraph==1.3.0". Apache 2.0. Published Azure scale benchmark: +4–15 pp task success vs the documented LangGraph baseline (n=300/scenario).` |
| Version | 1.3.0 |

## What it is

Apache-2.0 native Python agent runtime and LangGraph alternative with its own Graph engine, semantic cache, Route Ledger, memory, and ports for PrismGuard security and PrismRAG retrieval. It does not require LangGraph in production.

## Problem

Production agents fail on glue: repeat-intent LLM spend without a cache, logs instead of decision replay, and six repos duck-taped (orchestration + Redis + retrieval + checkpoints + audit) before go-live.

## Alternatives

- **LangGraph** — Published Azure scale comparison uses LangGraph as a documented baseline. ChorusGraph is a native runtime with cache, Route Ledger, and ports included; LangGraph is a mature ecosystem teams compose themselves. ([source](https://www.insightits.com/compare/chorusgraph-vs-langgraph.html))

## Features

- **+4–15 pp Task Success** — Published Azure scale run heavy_20260708_140300 (n=300 per scenario) vs the documented LangGraph baseline.
- **300+ Deterministic Tests** — CI runs without live API keys; benchmark methodology and raw artifacts are published separately.
- **Security + Retrieval Plug-ins** — PrismGuard (make_guard_handler) and PrismRAG (your DB taxonomy) — legal, healthcare, finance without forking the engine.

## Architecture

ChorusStack with four swappable ports: LLM backend, checkpoint store (SQLite free; Postgres persistence license-gated), semantic cache, retrieval (PrismRAG plug-in). Optional PrismGuard make_guard_handler before RAG/LLM. Route Ledger records why the agent routed. Canonical order: PrismGuard → ChorusGraph (+ PrismRAG) → LLM → PrismShine.

## Use cases

- Legal, healthcare, and finance agents that need auditable routing on a customer database
- Teams that want one runtime instead of assembling cache, retrieval, memory, and tracing
- Repeat-intent workloads where a default-on semantic cache at routing boundaries matters

## Benchmarks

Published Azure scale run heavy_20260708_140300 (n=300/scenario, seed 42, Gemini): task success 4–15 percentage points, mean LLM calls 31–76% lower, mean latency 8–73% lower vs the documented LangGraph baseline.

### Disclosures

- Integrated product stack comparison, not an engine-only microbenchmark.
- ChorusGraph includes its productized cache, memory, Route Ledger, and deterministic routing; the LangGraph baseline is a competent framework implementation without those ChorusGraph layers.
- No published performance claim against CrewAI.
- No published performance claim against Microsoft Agent Framework.
- No published performance claim against AutoGen.

### Evidence URLs

- https://github.com/insightitsGit/ChorusGraph/blob/master/docs/BENCHMARK.md
- https://github.com/insightitsGit/ChorusGraph/blob/master/docs/BENCHMARK_RESULTS.md
- https://github.com/insightitsGit/ChorusGraph/tree/master/benchmark/results/azure_heavy_20260708_140300


## GitHub

https://github.com/insightitsGit/ChorusGraph

## PyPI

https://pypi.org/project/chorusgraph/1.3.0/

## Documentation

- [Python agent runtime guide](https://www.insightits.com/guides/python-agent-runtime.html)
- [ChorusGraph vs LangGraph](https://www.insightits.com/compare/chorusgraph-vs-langgraph.html)
- [Agent frameworks guide](https://www.insightits.com/compare/agent-frameworks.html)
- [Whitepaper](https://github.com/insightitsGit/ChorusGraph/blob/master/docs/WHITEPAPER.md)
- [Benchmark results](https://github.com/insightitsGit/ChorusGraph/blob/master/docs/BENCHMARK_RESULTS.md)
- [Benchmark methodology](https://github.com/insightitsGit/ChorusGraph/blob/master/docs/BENCHMARK.md)
- [interactiveDemo](https://insightitsgit.github.io/ChorusGraph/demo.html)
- [fairness](https://github.com/insightitsGit/ChorusGraph/blob/master/benchmark/FAIRNESS_H9.md)
- [scaleRun](https://github.com/insightitsGit/ChorusGraph/tree/master/benchmark/results/azure_heavy_20260708_140300)
- [installGuide](https://github.com/insightitsGit/ChorusGraph/blob/master/docs/INSTALL.md)
- [aiIdePrompts](https://github.com/insightitsGit/ChorusGraph/blob/master/docs/AI_IDE_PROMPTS.md)
- [plugins](https://github.com/insightitsGit/ChorusGraph/blob/master/docs/PLUGINS.md)

## Is not

- A LangGraph wrapper or plugin
- A claim that LangGraph has no cache — LangGraph has opt-in CachePolicy / compile(cache=...)
- A published performance comparison against CrewAI or Microsoft Agent Framework

## Related products

- [prismguard](./prismguard.md)
- [prismrag](./prismrag.md)
- [prismshine](./prismshine.md)
- [choruscontrol](./choruscontrol.md)