Practical overview
When it fits
Use Cayu when a Python agent must handle work across multiple tool calls or human decisions and needs persisted progress, controlled authority or recovery. Begin with the generated project for its documented credential-free checks, then configure a provider for live runs.
Who it is for
- Python developers building domain-specific agents that need to persist state or resume work after interruption.
- Teams that need to govern tool authority, include human approvals, and inspect agent execution as well as final output.
Documented uses
- Compose an agent harness from model, context, tool, memory, policy and domain components.
- Run work through durable sessions, task dispatch, resumable steps, approvals and recovery.
- Test and evaluate an agent using included project checks and evaluation scaffolding.
Requirements & limits
Cayu is open source under the Apache-2.0 license. The documented quickstart requires Python 3.11 or newer and uv. Cayu Cloud is optional.
- The generated project and its initial checks can be used without provider credentials; live model runs require a configured provider and its credentials.
- Applications must supply their own user interface, authentication, business authorization, domain rules and completion criteria.
- The framework supports multiple provider families, including OpenAI API, Anthropic, Bedrock, Vertex and OpenAI-compatible APIs; OpenAI subscription login is labeled experimental.
- Native Python tools are trusted application code; configured isolation and external receipts determine guarantees at the application boundary.
- The documented coding starter can prepare changes for delivery but does not commit, push, open pull requests, run CI or merge.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Create and verify a Cayu starter project
Generate a project and run its credential-free inspection, checks, tests and evaluation.
Before you start
- Python 3.11 or newer
- uv
Steps
Run
uvx cayu new myagentand change into the generated project directory.Run the command below to install the development dependencies.
uv sync --extra devRun the anatomy guide, inspection, strict checks, tests and evaluation with the documented the command below commands.
uv run --no-sync
Expected outcome
A generated starter project is inspected and its included tests and evaluation are run without live provider credentials.
Guide limitations
- These checks establish starter behavior, not live-model quality.
- A live model run requires provider configuration and the credentials specified by that provider's guide.
Configure and make a first live agent run
Run the generated agent after configuring a supported model provider.
Before you start
- A Cayu starter project created with the documented quickstart
- A supported provider, its model, and the required credentials
Steps
Choose a supported provider and model in
configuration/settings.pyor through the generatedCAYU_PROVIDERsetting.Set the credentials specified in the provider guide.
Run the documented the command below command with a support-request message.
uv run --no-sync python run.py --messageInspect the emitted events and final outcome.
Expected outcome
The application makes a live run and exposes its events and final outcome for inspection.
Guide limitations
- Provider authentication failures are configuration problems; a run that fails or pauses is a runtime outcome to assess from its recorded evidence.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 4 October 2026
- Original website title
- cayu-dev/cayu · Official homepage title · retained in its source language