​
Requirements

​
Automatic installation

Use the get-started command to create a new Restack application 
pipx install restackio.get-started --force && restackio.get-started

​
Choose an example

Choose between different examples:
  • Default agent: Fully featured Agent with tools example
  • Empty agent: Most basic Agent with chat example

​
Manual installation

To skip the automatic installation, clone the examples-python repository. 
git clone https://github.com/restackio/examples-python.git

cd examples-python/agent_todo
Start the Restack engine and Developer UI: 
docker run -d --pull always --name restack -p 5233:5233 -p 6233:6233 -p 7233:7233 -p 9233:9233 -p 10233:10233 -p 11233:11233 ghcr.io/restackio/restack:main

​
Run the examples

​
Start python shell

If using uv: 
uv venv && source .venv/bin/activate
If using pip: 
python -m venv .venv && source .venv/bin/activate

​
Install dependencies and run

If using uv: 
uv sync
uv run dev
If using pip: 
pip install -e .
python -c "from src.services import watch_services; watch_services()"
This installs the dependencies and start the services running agents.

​
Run agent or workflow

​
From the developer UI

Visit http://localhost:5233 and click the Run button for the agent.

​
From the API

Run agents or workflows from the API by using the generated endpoint: POST http://localhost:6233/api/agents/AgentTodo

​
From any client

In a separate terminal, schedule the agent to start immediately. 
uv run schedule
If using pip: 
python -c "from schedule import run_schedule; run_schedule()"

​
Send an event to the agent

In this example, the user asks the AI agent to create a to-do.

​
From the UI

{
  "agentId": "{agent_id}",
  "runId": "{run_id}",
  "eventName": "message",
  "eventInput": {
    "content": "Can you send an email to the CEO?"
  }
}

​
From a client

client = Restack()

client.send_agent_event(
  agent_id="agent-id",
  run_id="run-id",
  event_name="eventName",
  event_input={"key": data.value}
)

​
See the agent run

The LLM will use tool call to create the todo. The creation of the todo will be done in a simple function. Replay and follow the agent run in the UI. Replay agent run Now, simply trigger more events from the Developer UI. In this case, the agent will ask permission to execute the todo. Send confirmation to agent If confirmed, this time the agent will execute the todo in a 2-step workflow. Execute todo workflow

​
Next steps

Build reliable agents