Skip to main content

​
Installation

AgentScope requires Python 3.10 or higher. You can install from source or pypi.

​
From PyPI

uv pip install agentscope
# or
# pip install agentscope

​
From Source

To install AgentScope from source, you need to clone the repository from GitHub and install by the following commands 
git clone -b main https://github.com/agentscope-ai/agentscope
cd agentscope
pip install -e .
To ensure AgentScope is installed successfully, check via executing the following code: 
import agentscope

print(agentscope.__version__)

​
Extra Dependencies

To satisfy the requirements of different functionalities, AgentScope provides extra dependencies that can be installed based on your needs.
  • full: Including extra dependencies for model APIs and tool functions
  • dev: Development dependencies, including testing and documentation tools
For example, when installing the full dependencies, the installation command varies depending on your operating system.
  • For Windows users:
pip install agentscope[full]
  • For Mac and Linux users:
pip install agentscope\[full\]

​
Simple Example

Here is a simple example of interacting with an agent in the terminal: 
import asyncio
import os

from agentscope.agent import ReActAgent, UserAgent
from agentscope.formatter import DashScopeChatFormatter
from agentscope.memory import InMemoryMemory
from agentscope.model import DashScopeChatModel
from agentscope.tool import (
    Toolkit,
    execute_shell_command,
    execute_python_code,
    view_text_file,
)


async def main() -> None:
    """The main entry point for the ReAct agent example."""
    toolkit = Toolkit()

    toolkit.register_tool_function(execute_shell_command)
    toolkit.register_tool_function(execute_python_code)
    toolkit.register_tool_function(view_text_file)

    agent = ReActAgent(
        name="Friday",
        sys_prompt="You are a helpful assistant named Friday.",
        model=DashScopeChatModel(
            api_key=os.environ.get("DASHSCOPE_API_KEY"),
            model_name="qwen3.5-plus",
            enable_thinking=False,
            stream=True,
            multimodality=True
        ),
        formatter=DashScopeChatFormatter(),
        toolkit=toolkit,
    )

    user = UserAgent("User")

    msg = None
    while True:
        msg = await user(msg)
        if msg.get_text_content() == "exit":
            break
        msg = await agent(msg)

asyncio.run(main())