Skip to main content
Install cpsl, verify the capsule CLI, then authenticate to your workspace. The package includes both pieces:
  • cpsl, the Python API you write your app with
  • capsule, the CLI you use for login, serve, deploy, secrets, channels, and filesystems

​
Requirements

  • Python 3.10+
  • a virtual environment or uv project
  • access to a Capsule workspace if you want to serve, deploy, manage secrets, create channels, or mount filesystems

​
Install with uv

Or install into a virtual environment directly:

​
Install with pip

​
Verify the CLI

You should see command groups such as:

​
Authenticate to your workspace

This opens a browser, authenticates against your workspace, and stores a local token for platform commands. serve, deploy, secret, channel, and fs all talk to Capsule, so login is part of normal local setup.

​
Scaffold a project

Use create when you want a template instead of a blank app.py:
The create command can generate:
  • quickstart for a BAML-backed assistant with packaged context
  • media-studio for generated media in chat
  • browser-agent for browser workflows
  • background-agent for scheduled agent loops
Start with quickstart for the main path, then use media-studio, browser-agent, or background-agent when you want a more specialized starter.

​
Next steps