5-Minute Tutorial
=================
This tutorial gets you from zero to a working agent in 5 minutes.
.. contents:: On this page
:local:
:depth: 2
Prerequisites
-------------
1. Python 3.10 or higher
2. An OpenAI API key (or another LLM provider)
Step 1: Install (1 minute)
--------------------------
.. code-block:: bash
# Using uv (recommended)
uv pip install pantheon-agents
# Or using pip
pip install pantheon-agents
Step 2: Set API Key (30 seconds)
--------------------------------
.. code-block:: bash
export OPENAI_API_KEY="your-api-key-here"
Step 3: Start Chatting (30 seconds)
-----------------------------------
**Option A: REPL (Recommended)**
.. code-block:: bash
pantheon cli
You'll see a prompt. Type your message and press Enter:
.. code-block:: text
> Hello! What can you do?
**Option B: Python Script**
.. code-block:: python
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:
.. code-block:: python
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:
.. code-block:: python
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:
.. raw:: html