Minimal ConnectOnion Agent

The simplest way to get started with ConnectOnion. A basic calculator agent that demonstrates:

• Creating an agent with a simple tool
• Interactive conversations
• Using both agent.input() and llm_do() functions

Quick Start

# Initialize project (if not already done)
co init --template minimal

# Run the agent
python agent.py

What's Inside

agent.py - A minimal agent with:

• Simple calculator tool (add, subtract, multiply, divide)
• Interactive conversation loop
• Examples of both agent and direct LLM usage

Example Interaction

# The agent can use its calculator tool
agent.input("What is 25 * 4?")
# → The calculator will compute: 100

# Direct LLM call without tools
llm_do("What is ConnectOnion?")
# → Quick response without agent overhead

Environment Variables

The .env file is created automatically during co init. It includes:

• OPENONION_API_KEY - Managed keys with co/ prefix (recommended)
• Or OPENAI_API_KEY - Your own OpenAI API key

Next Steps

Ready for more? Try these templates:

• co init --template playwright - Browser automation with Playwright
• co init --template web-research - Web search and research tools
• co init --template meta-agent - Multi-agent orchestration

Learn More

• Documentation
• Examples
• Discord Community