Agentscope Studio AI Agent

[!IMPORTANT]

Archive Notice

AgentScope 2.0 now ships a built-in Web UI as part of its batteries-included Agent Service — a FastAPI backend paired with a pre-built frontend (examples/web_ui) for building, running and observing agents out of the box. Powered by a unified event stream, it visualizes agent reasoning, tool calls and multimodal content in real time, and offers multi-session isolation, Agent Team (leader–worker) orchestration with task planning, permission & human-in-the-loop control, IM channels (Feishu / Discord), MCP & Skill Hub management, session persistence and task scheduling.

With these capabilities built natively into AgentScope 2.0, AgentScope Studio is no longer maintained as a standalone tool. 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 Studio!

<p align="center"> <img src="https://img.alicdn.com/imgextra/i1/O1CN01nTg6w21NqT5qFKH1u_!!6000000001621-55-tps-550-550.svg" alt="AgentScope Logo" width="200" /> </p> <h2 align="center">AgentScope Studio: Development-Oriented Visualization Toolkit</h2> <p align="center"> <a href="https://arxiv.org/abs/2402.14034"> <img src="https://img.shields.io/badge/cs.MA-2402.14034-B31C1C?logo=arxiv&logoColor=B31C1C" alt="arxiv" /> </a> <a href="https://www.npmjs.com/package/@agentscope/studio"> <img src="https://img.shields.io/badge/dynamic/json?url=https://registry.npmjs.org/%40agentscope%2Fstudio&query=$.%27dist-tags%27.latest&prefix=v&logo=npm&label=version" alt="npm" /> </a> <a href="./LICENSE"> <img src="https://img.shields.io/badge/license-Apache--2.0-black" alt="license" /> </a> <a href="https://agentscope.io/"> <img src="https://img.shields.io/badge/Tracing-OpenTelemetry-blue?logo=look&logoColor=green&color=dark-green" alt="tracing" /> </a> <a href="https://agentscope.io/"> <img src="https://img.shields.io/badge/Evaluation-Agent-blue?logo=look&color=red" alt="evaluation" /> </a> <a href="https://agentscope.io/"> <img src="https://img.shields.io/badge/Built--in_Copilot-Friday-blue?logo=look&color=cyan" alt="friday" /> </a> </p>

AgentScope Studio is a powerful local visualization toolkit designed for developers working with AgentScope. It provides a transparent, simple, and fun way to develop, debug, and evaluate agent-based applications.

Key Features

• Project Management: Organize and manage your AgentScope projects with Projects and Runs
• Runtime Visualization: Chatbot-style interface for real-time agent interaction
• Tracing: OpenTelemetry-based trace visualization for LLM calls, token usage, and agent invocations
• Agent Evaluation: Evaluation-oriented analysis from a statistical perspective
• Built-in Copilot (Friday): A development assistant, playground for rapid secondary development, and integration hub for advanced features

<p align="center"> <img src="https://img.alicdn.com/imgextra/i1/O1CN01PG2MdF1Zc44A1QM6N_!!6000000003214-1-tps-1971-1080.gif" width="49%" alt="home" /> <img src="https://img.alicdn.com/imgextra/i2/O1CN01pGHedL1L4ibmyPeiq_!!6000000001246-1-tps-1971-1080.gif" width="49%" alt="runtime" /> <img src="https://img.alicdn.com/imgextra/i1/O1CN01HfFhy928SSJAcWQ8c_!!6000000007931-1-tps-1971-1080.gif" width="49%" alt="traces" /> <img src="https://img.alicdn.com/imgextra/i1/O1CN01vovov821Arms9tEJ1_!!6000000006945-1-tps-1971-1080.gif" width="49%" alt="friday" /> </p>

📢 News

• [2025-08] AgentScope Studio is now open-sourced! We will continue to improve it and welcome contributions from the community.

💻 Installation

Prerequisites

• Node.js >= 20.0.0
• npm >= 10.0.0
• Docker (optional, for Docker deployment)

💡 Tip: If you're using nvm, you can run nvm use to automatically switch to the required Node.js version.

# How to check your version
node --version  # Should show v20.x.x or higher
npm --version   # Should show 10.x.x or higher

From NPM (Recommended)

npm install -g @agentscope/studio

# Start AgentScope Studio
as_studio

From Source

git clone https://github.com/agentscope-ai/agentscope-studio
cd agentscope-studio
npm install

# Start in development mode
npm run dev

• From npm

npm install -g @agentscope/studio  # or npm install @agentscope/studio

as_studio

Docker Deployment

Please refer to docker/README.md.

🚀 QuickStart

To connect AgentScope applications, you need to set the studio_url field in the AgentScope initializer as follows:

import agentscope

agentscope.init(
    # ...
    studio_url="http://localhost:3000"
)

# ...

📚 Documentation

For more details, please refer to our documentation:

• Overview - What is AgentScope Studio and how it works
• Quick Start - Installation and configuration guide
• Project Management - Managing projects and runs
• Tracing - OpenTelemetry integration and semantic conventions
• Friday - Built-in Copilot guide
• Contributing - How to contribute

⚖️ License

AgentScope Studio is released under Apache License 2.0.

✨ Contributors

All thanks to our contributors:

<a href="https://github.com/agentscope-ai/agentscope-studio/graphs/contributors"> <img src="https://contrib.rocks/image?repo=agentscope-ai/agentscope-studio&max=999&columns=12&anon=1" /> </a>