Skip to main content
Prerequisites:
  • Python 3.12 or higher
  • Docker (optional, for code sandbox features)

​
Get started in four steps

1

Install Superserve

pip install superserve
For sandbox support (code execution):
pip install superserve[sandbox]
2

Create a project

superserve init my_project
cd my_project
This generates a project structure with:
  • agents/ - Directory for your agent code
  • pyproject.toml - Project dependencies
  • .env.example - Template for environment variables (copy to .env)
3

Create an agent

superserve create-agent my_agent
Available frameworks: python (default), langchain, pydantic (more coming soon)See the framework guides for framework-specific implementations.This creates agents/my_agent/agent.py with a template you can customize.
4

Run and test

Start the server:
superserve up
Test your agent:
curl -X POST http://localhost:8000/agents/my_agent/ \
  -H "Content-Type: application/json" \
  -d '{"query": "Hello!"}'