Skip to main content

​
Get started with Polos

Build your first durable agent in three simple steps.

​
Step 1: Start the Polos orchestrator

Install the Polos CLI and start the orchestrator:
pip install polos
polos start
The orchestrator manages workflow execution and state persistence.

​
Step 2: Write your first agent

Create a simple agent that performs a task:
from polos import Agent

agent = Agent(
    name="my-first-agent",
    instructions="You are a helpful assistant"
)

result = agent.run("What is the weather today?")
Agents automatically handle retries and state persistence.

​
Step 3: Start a worker

Start a worker to execute your agent:
polos worker start
Your agent will now execute with full durability guarantees.

​
Next steps

Now that you have Polos running, explore these key features:

What is Polos?

Learn about durable execution and why it matters.

Fundamentals

Understand core concepts like workflows, steps, and agents.

Agents

Build powerful AI agents with tools and memory.

Workflows

Orchestrate complex multi-step processes.
Need help? Join our Discord community or check out the cookbook examples.