StackMap
Subscribe
Explore / superserve
superserve-ai

superserve

Persistent, secure sandboxes for AI agents on Firecracker microVMs — TypeScript and Python SDKs, CLI and console; the runtime is a hosted service, the SDK stack is Apache-2.0.

415 48 TypeScript Apache-2.0updated today
agents
View on GitHubDispute this mapping →
Curator's take

The pitch is persistence: sandboxes that survive between agent runs instead of being disposable, on Firecracker isolation. Know what the repo is before starring: this is the SDK/CLI/console monorepo — the actual sandbox runtime lives behind the hosted service at superserve.ai, and the README is a contributor doc, not a product doc (the substance is at docs.superserve.ai). Use it when you want managed microVM sandboxes with a clean SDK and don't want to run KVM hosts; NOT for air-gapped or self-hosted requirements — that's CubeSandbox's territory. Young project, small community — evaluate the service's durability before building on it.

Mapped by ShipWithAI editors · links verified
README.md


Twitter Header - Personal

Persistent and secure sandboxes for AI Agents, powered by Firecracker microVMs.

Docs License

Getting Started

Visit superserve.ai or jump straight into the docs.

Structure

apps/
  console/                 # Sandbox dashboard (Next.js 16, App Router)
  ui-docs/                 # UI component docs (Vite)
packages/
  cli/                     # TypeScript CLI (@superserve/cli)
  python-sdk/              # Python SDK (superserve on PyPI)
  sdk/                     # TypeScript SDK (@superserve/sdk)
  ui/                      # Shared UI components (@superserve/ui)
  typescript-config/       # Shared tsconfig presets
  tailwind-config/         # Shared Tailwind config
docs/                      # Mintlify documentation site
tests/                     # SDK end-to-end tests

Monorepo managed with Bun workspaces, Turborepo, and uv workspaces.

Setup

bun install               # install all JS/TS dependencies
uv sync                   # install all Python dependencies

Development

bun run dev               # start all dev servers
bun run build             # build all packages
bun run lint              # lint all packages
bun run format            # format all files
bun run typecheck         # type check all packages
bun run test              # unit/integration tests

For more (per-package targets, dependency management, etc.), see CONTRIBUTING.md.

SDKs

Full reference at docs.superserve.ai.

Testing

bun run test                                        # unit tests (no credentials)
SUPERSERVE_API_KEY=ss_live_... bun run test:e2e     # e2e against staging

For environment overrides and single-language runs, see CONTRIBUTING.md.

Releasing

See RELEASING.md for publishing the SDKs to npm and PyPI.

Contributing

Contributions welcome — see CONTRIBUTING.md for guidelines.

License

Apache License 2.0 — see LICENSE.

Where to find us

Continue your stack

What teams reach for next — and why each earns a place beside superserve. Ranked by curator confidence.