# big-brain

> big-brain wraps LLMs behind standard OpenAI- and Anthropic-compatible APIs. From the outside it's just another model endpoint; inside, a request runs through a "brain" — a tree of flows and agents with memory, tools, routing, and durable execution. It's a Go library (`github.com/force1267/big-brain/pkg/bb`), not a hosted service: you write a small Go program, assemble flows, and call `bb.Serve`.

Read [/llms-full.txt](https://big-brain.mjasadi.com/llms-full.txt) for the complete authoring guide in one file — the fastest way for an agent to learn the whole API before writing a brain.

## Docs

- [Introduction](https://big-brain.mjasadi.com/docs/guide/introduction): what big-brain is, the core idea, what the engine actually sells
- [Quick start](https://big-brain.mjasadi.com/docs/guide/quick-start): install, the 60-second demo, environment variables
- [Mental model](https://big-brain.mjasadi.com/docs/guide/mental-model): flow, agent, turn — the vocabulary used everywhere else
- [Flows, agents & turns](https://big-brain.mjasadi.com/docs/concepts/flows-agents-turns): the OnMessage handler API, structured output, chaining
- [Models & roles](https://big-brain.mjasadi.com/docs/concepts/models): the model resolution ladder, providers, tags
- [Routing with Select](https://big-brain.mjasadi.com/docs/concepts/routing): multi-capability brains, intent routers
- [Concurrency](https://big-brain.mjasadi.com/docs/concepts/concurrency): All/One/Group, checkpoints
- [Tools](https://big-brain.mjasadi.com/docs/concepts/tools): inner vs. outer tools, bb.OnCall, Resolve, forwarding a caller's tools
- [Memory](https://big-brain.mjasadi.com/docs/concepts/memory): the brain's own state, transcripts vs. memory
- [Streaming](https://big-brain.mjasadi.com/docs/concepts/streaming): terminal-boundary streaming, turn.Stream()
- [Durability](https://big-brain.mjasadi.com/docs/concepts/durability): opt-in checkpointing, at-least-once semantics
- [Triggers & initiative](https://big-brain.mjasadi.com/docs/concepts/triggers): Every/Once/Webhook, initiative past the reply
- [Telemetry & cost](https://big-brain.mjasadi.com/docs/concepts/telemetry): reply.Usage(), bb.Spent(ctx), OTel
- [Serving](https://big-brain.mjasadi.com/docs/reference/serving): bb.Serve/bb.Handler, endpoints, serving several flows
- [The rules](https://big-brain.mjasadi.com/docs/reference/rules): the short list every other page expands on
- [Testing](https://big-brain.mjasadi.com/docs/reference/testing): driving a flow in tests, the mocks shipped per package
- [Reference brains](https://big-brain.mjasadi.com/docs/reference/reference-brains): cmd/jarvis-demo and cmd/marvis-demo

## Optional

- [GitHub repository](https://github.com/force1267/big-brain): source, issues, the reference brains' full code