Skip to content

Agentscope Runtime

A production-ready runtime framework for agent apps with secure tool sandboxing, Agent-as-a-Service APIs, scalable deployment, full-stack observability, and broad framework…

Install

$pip install agentscope-runtime

Install command taken from the project's README or registry entry. Always review code before running it.

[!IMPORTANT]

Archive Notice

With the release of AgentScope 2.0, all capabilities of AgentScope Runtime — including tool sandboxing, Agent-as-a-Service APIs, and full-stack observability — have been natively integrated into AgentScope 2.0.

We recommend all users migrate to AgentScope 2.0 (https://github.com/agentscope-ai/agentscope) for continued updates, new features and community support. This repository will remain available in read-only mode for reference and will be archived soon.

Thank you to everyone who contributed to and used AgentScope Runtime!

AgentScope Runtime: A Production-grade Runtime for Agent Applications

[Cookbook] [Try WebUI] [中文README] [Samples]

Core capabilities:

Tool Sandboxing — tool call runs inside a hardened sandbox

Agent-as-a-Service (AaaS) APIs — expose agents as streaming, production-ready APIs

Scalable Deployment — deploy locally, on Kubernetes, or serverless for elastic scale

Plus

Full-stack observability (logs / traces)

Framework compatibility with mainstream agent frameworks


Table of Contents

[!NOTE]

Recommended reading order:

  • I want to run an agent app in 5 minutes: Quick Start (Agent App example) → verify with curl (SSE streaming)
  • I care about secure tool execution / automation: Quick Start (Sandbox examples) → sandbox image registry/namespace/tag configuration → (optional) production-grade serverless sandbox deployment
  • I want production deployment / expose APIs: Quick Start (Agent App example) → Quick Start (Deployment example) → Guides
  • I want to contribute: Contributing → Contact
  • News
  • Key Features
  • Quick Start: From installation to running a minimal Agent API service. Learn the three-stage AgentApp development pattern: init / query / shutdown.
    • Prerequisites: Required runtime environment and dependencies
    • Installation: Install from PyPI or from source
    • Agent App Example: How to build a streaming (SSE) Agent-as-a-Service API
    • Sandbox Example: How to safely execute Python/Shell/GUI/Browser/Filesystem/Mobile tools in an isolated sandbox
    • Deployment Example: Learn to deploy with DeployManager locally or in a serverless environment, and access the service via A2A, Response API, or the OpenAI SDK in compatible mode
  • Guides: A tutorial site covering AgentScope Runtime concepts, architecture, APIs, and sample projects—helping you move from “it runs” to “scalable and maintainable”.
  • Contact
  • Contributing
  • License
  • Contributors

🆕 NEWS

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io