{
  "markdown": "<div align=\"center\">\n  <br/>\n  <br/>\n  <picture>\n    <img width=\"1500\" height=\"auto\" alt=\"Twitter Header - Personal\" src=\"https://github.com/user-attachments/assets/ba41a4ed-1c8b-4826-bd3d-6fc8d84472ae\" />\n  </picture>\n\n  <br/>\n  <br/>\n\n  <p><strong>Persistent and secure sandboxes for AI Agents, powered by Firecracker microVMs.</strong></p>\n\n[![Docs](https://img.shields.io/badge/Docs-latest-blue)](https://docs.superserve.ai/?utm_source=github&utm_medium=readme)\n[![License](https://img.shields.io/badge/license-Apache%20License%202.0-blue)](https://github.com/superserve-ai/superserve/blob/main/LICENSE)\n\n</div>\n\n## Getting Started\n\nVisit [superserve.ai](https://www.superserve.ai/?utm_source=github&utm_medium=referral&utm_campaign=readme) or jump straight into the [docs](https://docs.superserve.ai/?utm_source=github&utm_medium=referral&utm_campaign=readme).\n\n## Structure\n\n```\napps/\n  console/                 # Sandbox dashboard (Next.js 16, App Router)\n  ui-docs/                 # UI component docs (Vite)\npackages/\n  cli/                     # TypeScript CLI (@superserve/cli)\n  python-sdk/              # Python SDK (superserve on PyPI)\n  sdk/                     # TypeScript SDK (@superserve/sdk)\n  ui/                      # Shared UI components (@superserve/ui)\n  typescript-config/       # Shared tsconfig presets\n  tailwind-config/         # Shared Tailwind config\ndocs/                      # Mintlify documentation site\ntests/                     # SDK end-to-end tests\n```\n\nMonorepo managed with [Bun workspaces](https://bun.sh/docs/install/workspaces), [Turborepo](https://turbo.build/repo), and [uv workspaces](https://docs.astral.sh/uv/concepts/projects/workspaces/).\n\n## Setup\n\n```bash\nbun install               # install all JS/TS dependencies\nuv sync                   # install all Python dependencies\n```\n\n## Development\n\n```bash\nbun run dev               # start all dev servers\nbun run build             # build all packages\nbun run lint              # lint all packages\nbun run format            # format all files\nbun run typecheck         # type check all packages\nbun run test              # unit/integration tests\n```\n\nFor more (per-package targets, dependency management, etc.), see [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n## SDKs\n\n- TypeScript: [`@superserve/sdk`](https://www.npmjs.com/package/@superserve/sdk) — `bun add @superserve/sdk`\n- Python: [`superserve`](https://pypi.org/project/superserve/) — `uv add superserve`\n\nFull reference at [docs.superserve.ai](https://docs.superserve.ai/?utm_source=github&utm_medium=readme).\n\n## Testing\n\n```bash\nbun run test                                        # unit tests (no credentials)\nSUPERSERVE_API_KEY=ss_live_... bun run test:e2e     # e2e against staging\n```\n\nFor environment overrides and single-language runs, see [CONTRIBUTING.md](./CONTRIBUTING.md#e2e-tests).\n\n## Releasing\n\nSee [RELEASING.md](./RELEASING.md) for publishing the SDKs to npm and PyPI.\n\n## Contributing\n\nContributions welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\n## License\n\nApache License 2.0 — see [LICENSE](./LICENSE).\n\n## Where to find us\n\n- [Email us](mailto:engineering@superserve.ai)\n- [Twitter/X](https://x.com/superserve_ai)\n- [LinkedIn](https://www.linkedin.com/company/super-serve-ai)\n",
  "bytes": 3279,
  "sha": "801186001f22ae76905d4cf7a8673e7204da392aa52d6d2a8df1aa832e1eecc3",
  "repo_slug": "superserve-ai/superserve",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_superserve_ai_mcp_f555a622/readme"
}