-
Notifications
You must be signed in to change notification settings - Fork 98
Home
Build powerful AI agents in Python with minimal code
ConnectOnion is a lightweight Python framework for creating AI agents that can use tools, make decisions, and interact with the world. This wiki provides tutorials, examples, and guides to help you build amazing AI-powered applications.
- Quick Start Guide - Build your first agent in 5 minutes
- Agent Core Concepts ⭐ NEW - How AI agents really work (complete tutorial)
- Building Your First Agent - Complete step-by-step tutorial
- Creating Custom Tools - Add capabilities to your agents
-
Use Managed Keys ⭐ NEW - Use any AI model without API keys (
co auth) -
Interactive Debugging Guide - Debug agents with
agent.auto_debug() - How to Use Auto-Debug - Feature guide and examples
- Debug Agent Errors - Troubleshooting common issues
- Email Agent Example - Search and send emails with AI
- Web Scraping Agent - Extract data from websites
- FAQ - Frequently asked questions
- Troubleshooting - Common errors and solutions
ConnectOnion helps you build AI agents that can:
- Use tools - Search, send emails, browse the web, run code
- Make decisions - Plan multi-step tasks and adapt to results
-
Debug easily - Interactive debugging with
auto_debug() - Scale simply - From prototypes to production
# Install
pip install connectonion
# Create your agent
co create my-agent
cd my-agent
# Run it!
python agent.pyThat's it! The CLI handles API key setup automatically.
Most frameworks give you a way to call LLMs. ConnectOnion gives you everything around it — so you only write prompt and tools.
Keep Simple Things Simple
- 2-line agent creation:
Agent("name").input("task") - Functions become tools automatically — no schema writing, no interface wiring
- No complex configuration files
Make Complicated Things Possible
- Interactive debugging with
auto_debug() - Behavior tracking and automatic logging
- Trust policies for multi-agent security
- Plugin system with Claude Code-equivalent capabilities
Built-in AI Programmer — Run co ai to get an AI coding assistant that deeply understands ConnectOnion. It's built with ConnectOnion and fully open-source.
Built-in Frontend & Backend — Other frameworks: write agent → build FastAPI → build React frontend → wire APIs → deploy. ConnectOnion: write prompt and tools → deploy. Frontend at chat.openonion.ai, all open-source.
Ready-to-Use Tool Ecosystem — bash, Shell, FileTools, BrowserAutomation, Gmail, Outlook, GoogleCalendar, Memory, TodoList — import and use. Need to customize? co copy Gmail copies the source into your project.
Built-in Approval System — Dangerous operations automatically trigger approval. Plugin-based: turn it off, customize it, or replace it.
Skills System — Reusable workflows with automatic permission scoping. Auto-discovers Claude Code skills from .claude/skills/ — no conversion needed.
Claude Code-Equivalent Plugins — auto_compact (context compression), subagents (sub-agent spawning), ulw (autonomous work mode), tool_approval (web approval UI) — these mirror Claude Code's internal capabilities, open to any agent.
Multi-Agent Trust System — Trust decisions happen before LLM involvement — zero token cost for 90% of cases. Three presets: open (dev), careful (staging), strict (production).
1. Beginner (Start here!)
- Quick Start Guide - 5 minutes
- Building Your First Agent - 15 minutes
- Email Agent Example - Working code to study
2. Intermediate
3. Advanced
- Deploy to Production
- Web Scraping Agent
- Official Documentation - Full API reference
- Documentation: docs.connectonion.com
- GitHub: github.com/openonion/connectonion
- PyPI: pypi.org/project/connectonion
- Discord: Join our community
- Check the FAQ for common questions
- Browse Troubleshooting for error solutions
- Ask in GitHub Discussions
- Join our Discord community
Found an error? Want to add a tutorial?
Ready to build your first AI agent? → Start with the Quick Start Guide