PenguiFlow¶
PenguiFlow is an async-first orchestration library for building:
- Typed agent workflows (LLM planner + tools)
- Concurrent pipelines (fan-out/fan-in, joins, routers)
- Production-ready runtime behavior (timeouts, retries, backpressure, cancellation, telemetry hooks)
Start here¶
- New to PenguiFlow? Read Concepts.
- Want to run something today? Follow Quickstart.
- Building an LLM tool-using agent? Start with ReactPlanner overview.
What’s in scope for these docs¶
This site is the curated, user-facing documentation.
The repository also contains:
- RFCs and proposals under
docs/RFC/anddocs/proposals/(implementation notes) - deeper architecture notes under
docs/architecture/
Those are valuable for contributors, but they are not part of the curated navigation and may assume internal context.
Docs map¶
| If you want to… | Start here |
|---|---|
| Build a typed async pipeline | Flows & nodes |
| Add parallel fan-out / joins | Concurrency |
| Stream partial output (tokens/status) | Streaming |
| Cancel in-flight work | Cancellation |
| Build an LLM-driven orchestrator | ReactPlanner |
| Connect MCP/UTCP/HTTP tools | Tooling |
| Ship pause/resume (OAuth/HITL) | Pause/resume |
| Persist/replay/operate at scale | State store |