5-Minute Tutorial

5-Minute Tutorial#

This tutorial gets you from zero to a working agent in 5 minutes.

Prerequisites#

  1. Python 3.10 or higher

  2. An OpenAI API key (or another LLM provider)

Step 1: Install (1 minute)#

# Using uv (recommended)
uv pip install pantheon-agents

# Or using pip
pip install pantheon-agents

Step 2: Set API Key (30 seconds)#

export OPENAI_API_KEY="your-api-key-here"

Step 3: Start Chatting (30 seconds)#

Option A: REPL (Recommended)

pantheon cli

You’ll see a prompt. Type your message and press Enter:

> Hello! What can you do?

Option B: Python Script

import asyncio
from pantheon.agent import Agent

async def main():
    agent = Agent(
        name="assistant",
        instructions="You are a helpful assistant."
    )
    await agent.chat()

asyncio.run(main())

Step 4: Add Tools (2 minutes)#

Make your agent more powerful by adding toolsets:

from pantheon.agent import Agent
from pantheon.toolsets import FileManagerToolSet, ShellToolSet

agent = Agent(
    name="developer",
    instructions="You are a developer assistant. Help with coding tasks."
)

# Add toolsets at runtime
await agent.toolset(FileManagerToolSet("files"))  # Read/write/edit files
await agent.toolset(ShellToolSet("shell"))        # Run shell commands

Now your agent can:

  • Read and write files

  • Search code with grep/glob

  • Run shell commands

Step 5: Create a Team (1 minute)#

Multiple agents working together:

from pantheon.agent import Agent
from pantheon.team import PantheonTeam

researcher = Agent(
    name="researcher",
    instructions="You research topics thoroughly."
)

writer = Agent(
    name="writer",
    instructions="You write clear, engaging content."
)

team = PantheonTeam([researcher, writer])
await team.chat()

What’s Next?#

You’ve learned the basics! Here’s where to go next:

Choose Your Interface

Deep dive into REPL, Web UI, or Python API

Configuration

Customize settings, templates, and models

Toolsets

Add powerful capabilities to your agents

Teams

Build multi-agent workflows

Quick Reference#

REPL Commands:

  • /help - Show commands

  • /view <file> - View file

  • /clear - Clear context

  • /exit - Exit

Common Toolsets:

  • FileManagerToolSet - File operations

  • ShellToolSet - Shell commands

  • PythonInterpreterToolSet - Python execution

  • IntegratedNotebookToolSet - Jupyter notebooks

  • WebToolSet - Web search

Team Types:

  • PantheonTeam - Smart delegation (recommended)

  • SwarmTeam - Dynamic handoff

  • SequentialTeam - Pipeline processing

  • MoATeam - Ensemble reasoning