superserve 0.1.5

CLI and SDK for Superserve hosted agent infrastructure

Deploy AI agents to sandboxed cloud containers. One command, no infrastructure config.

Features

• Sandboxed execution — Every agent runs in a gVisor-isolated container with its own compute, filesystem, and network
• Persistent workspace — Storage that survives restarts. Agents pick up where they left off
• Encrypted secrets — API keys are encrypted and injected at runtime. Values are never exposed
• Real-time streaming — Stream tokens and tool calls as they happen
• Sub-second cold starts — Pre-provisioned containers mean your agent starts almost instantly
• Built for Claude Agent SDK — Write with the Claude Agent SDK, deploy with Superserve

Quick Start

pip install superserve
superserve login

Initialize from the root of your project where your dependencies and agent code live:

superserve init

This creates a superserve.yaml:

name: my-agent
command: python main.py  # edit to match your agent's start command

Deploy:

superserve deploy

Set your secrets:

superserve secrets set my-agent ANTHROPIC_API_KEY=sk-ant-...

Run your agent:

superserve run my-agent

You > What is the capital of France?

Agent > The capital of France is Paris.

Completed in 1.2s

You > And what's its population?

Agent > Paris has approximately 2.1 million people in the city proper.

Completed in 0.8s

CLI Reference

Command	Description
superserve login	Authenticate with Superserve
superserve init	Generate superserve.yaml for your project
superserve deploy	Deploy your agent
superserve run AGENT	Run an interactive session
superserve secrets set AGENT KEY=VALUE	Set encrypted environment variables
superserve secrets list AGENT	List secret key names
superserve agents list	List deployed agents
superserve agents get AGENT	Get agent details
superserve agents delete AGENT	Delete an agent
superserve sessions list	List sessions

See the full CLI Reference for all flags and options.

Requirements

• Python 3.12+
• A Superserve account

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

This project is licensed under the Open Core Ventures Source Available License (OCVSAL) 1.0 - see the LICENSE file for details.

---

If you find Superserve useful, please consider giving us a star!