Skip to main content

​
OmniCoreAgent Cookbook

Copy, paste, run. These examples show how to build with OmniCoreAgent from the first local agent through production-shaped application harnesses.

​
🚀 Where to Start

New to OmniCoreAgent? Start with getting_started — progressive examples from “Hello World” to production deployments. Know what you’re building? Find your use case below. Just want to see it work? 
from omnicoreagent import OmniCoreAgent

agent = OmniCoreAgent(
    name="my_agent",
    system_instruction="You are a helpful assistant.",
    model_config={"provider": "openai", "model": "gpt-4o"}
)

result = await agent.run("Hello!")
print(result["response"])

​
📚 Build by Use Case

​
🤖 I want to build my first agent

→ getting_started — Basic agents, tools, memory, events, and configuration.

​
🛠️ I want to use custom tools

→ getting_started/agent_with_local_tools.py — Register Python functions as tools.

​
🔌 I want to connect MCP servers

→ getting_started/agent_with_mcp_tools.py — Connect to external MCP servers.

​
👥 I want agents working together

→ workflows — Sequential, Parallel, and Router agents.

​
🚁 I want agents running autonomously

→ background_agents — Scheduled tasks and queue-based execution.

​
🧠 I want complex multi-step workflows

→ getting_started/agent_with_sub_agents.py — OmniCoreAgent dynamic subagents, workspace files, and orchestration.

​
🏭 I want to build a real application

→ real_applications — Production-shaped app harness examples that show domain tools, workspace files, offloading, telemetry, guardrails, and workspace command tools across different apps.

​
🧪 I want more domain demos

→ advanced_agent — E-commerce, flight booking, customer support, due diligence.

​
🌐 I want to deploy as an API

→ omniserve — Deploy agents as REST/SSE APIs with one command.

​
🚀 I want to run in production

→ production — Metrics and guardrails.

​
📂 Directory Structure

cookbook/
├── getting_started/     # Start here! Progressive learning path
├── workflows/           # Multi-agent orchestration patterns
├── background_agents/   # Scheduled and autonomous agents
├── omniserve/           # 🆕 Deploy agents as REST/SSE APIs
├── real_applications/   # End-to-end application harness examples
├── advanced_agent/      # Real-world application examples
└── production/          # Production-ready configurations

​
🎯 Featured Examples

ExampleWhat You’ll Build
Research Due DiligenceResearch agent with parallel tools, workspace reports, artifact readback, telemetry
Support OperationsSupport agent with customer/order tools, guardrails, escalation, workspace notes
Workspace Code ReviewCode review agent using built-in workspace file commands instead of unrestricted shell
Support Background TaskReal support operations app running through durable background task state, events, attempts, and workspace output
E-commerce ShopperPersonal shopping assistant with cart, preferences, recommendations
Flight BookingTravel agent with search, booking, and itinerary management
Customer SupportSupport agent with ticket handling and escalation
Due DiligenceInvestment research with web search, analysis, and reporting

​
🤝 Contributing

Want to add a cookbook example? See CONTRIBUTING.mdx for guidelines.