Skip to main content
A project is an isolated deployment unit in Polpo. Everything you deploy — agents, teams, missions, API keys — lives inside a project.

​
What each project gets

Every project is provisioned with its own:
  • Database — fully isolated data storage
  • Sandbox pool — isolated execution environments for your agents
  • API keys — separate sk_live_ and sk_test_ credentials
  • LLM provider keys — your own keys, encrypted per-project
Projects scale to zero when idle — you only pay for the executions and completions you use.

​
Deleting a project

Deleting a project permanently removes all data including the database, agents, sessions, and API keys. This action cannot be undone.

​
Organization scope

Projects belong to an organization. When you sign up, an org is created automatically.

​
Creating a project

1

Open the dashboard

Navigate to your organization’s dashboard.
2

Click Create Project

Enter a project name and slug.
3

Configure

Set up your API keys and LLM provider keys.
When you run polpo deploy for the first time, a project is created automatically if none is linked.