How-To Guides
Recipes for common tasks with Cycles, organized by what you're trying to do.
Integrate Cycles into your app
- Add Cycles with Claude or Codex — wire Cycles into an existing codebase using AI assistants.
- Add Cycles to an existing application — manual integration steps.
- Choose the right integration pattern — decorator, middleware, manual, or framework-native.
- Migrate from a custom rate limiter
- Evaluate Cycles for an agent SaaS — fit/no-fit framing and a 15-minute test.
- Integrations overview · Ecosystem
LLM providers
OpenAI (Python) · OpenAI (TypeScript) · Anthropic (Python) · Anthropic (TypeScript) · AWS Bedrock · Google Gemini · Groq · Ollama / local LLMs
Agent frameworks
OpenAI Agents SDK · LangChain (Python) · LangChain.js · LangGraph · LlamaIndex · CrewAI · AutoGen · Pydantic AI · any-agent · MCP · OpenClaw
Web frameworks
Vercel AI SDK · Next.js · Express · FastAPI · Django · Flask · Spring AI · Rust
Design budget hierarchies
- Choosing the right overage policy — reject, allow-if-available, or allow-with-overdraft.
- Multi-tenant SaaS guide
- Budget templates · Common budget patterns
- Multi-agent shared workspace budgets
- Cost estimation cheat sheet
- Budget allocation and management
- Tenant, workflow, and run budgets
- Estimate exposure before execution
- Assigning RISK_POINTS to agent tools
- Degradation paths
- Budget control for LangChain agents
- Shadow mode rollout
Operate Cycles in production
- Production operations guide
- Monitoring and alerting · Observability setup · Prometheus metrics reference
- Security hardening
- Tenant management · API key management
- Tenants, scopes, and budgets
- Rolling over billing periods
- Bulk actions for tenants and webhooks
- Force-releasing stuck reservations
- Searching admin list endpoints
- Webhook integrations · Managing webhooks
- Custom field resolvers
- Programmatic client usage · Dashboard guide
- Client performance tuning
Handle errors and edge cases
- Error handling patterns
- Language-specific patterns: Python · TypeScript · Rust
- Handling streaming responses
- Testing with Cycles
- Troubleshooting and FAQ
Run the MCP server
Related
- Quickstart — get started with a specific stack.
- Cycles Protocol — the open specification.
- How Cycles compares — vs LiteLLM, Helicone, rate limiters, provider caps, DIY wrappers.