Projects - Polpo

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 — sk_live_ credentials scoped to the project
Subdomain — {project}.polpo.cloud with a server-generated 20-character alphanumeric slug
LLM Gateway — managed AI Gateway enabled by default

Projects scale to zero when idle — you only pay for the executions and completions you use.

Creating a project

The fastest way is the CLI wizard — it handles login, project creation, scaffolding, and API key generation in one step:

npx @polpo-ai/cli create

You can also create projects from the dashboard or API:

Dashboard
API

Open the dashboard

Navigate to your organization’s dashboard.

Click New Project

Enter a project name. The slug is generated automatically.

curl -X POST https://{project}.polpo.cloud/v1/projects \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "your-org-id",
    "name": "My Project"
  }'

Linking an existing directory

Already have a cloud project? Bind your local directory to it:

npx @polpo-ai/cli link --project-id <uuid>

This writes .polpo/polpo.json with the project reference. Subsequent polpo deploy commands target this project.

Organization scope

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

Deleting a project

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

Core Concepts

LLM Gateway

​What each project gets

​Creating a project

​Linking an existing directory

​Organization scope

​Deleting a project

What each project gets

Creating a project

Linking an existing directory

Organization scope

Deleting a project