OpenAgents Logo
OpenAgentsDocumentation
Getting Started安装
Updated February 24, 2026

安装

在您的系统上安装 OpenAgents - Python 包安装、环境设置和验证步骤。

安装

通过以下简单的安装步骤在系统上运行 OpenAgents。OpenAgents 需要 Python 3.10 或更高版本，并且可在 Linux、macOS 和 Windows 上运行。

系统要求

Python 版本

  • Python 3.10+（推荐：Python 3.11 或 3.12）
    • 我们对 Python 3.10、3.11 和 3.12 每晚运行包测试。
  • pip 包管理器（随 Python 一同提供）
  • Git（用于开发安装）

Node.js 版本（用于 OpenAgents Studio）

  • Node.js 20+

快速安装

设置 Python 环境

我们推荐使用 Conda 为 OpenAgents 创建一个新的环境。

# Create new environment
conda create -n openagents python=3.12
conda activate openagents

你也可以根据个人偏好使用 pyenv 或 venv 为 OpenAgents 创建新环境。

有关如何使用这些工具管理 Python 环境的更多详细信息，请参阅以下资源：

安装 OpenAgents 包

通过 PyPI 安装 OpenAgents（强烈推荐）

# Install OpenAgents
pip install openagents
 
# Verify installation
openagents --version

重要： 重要： 由于 OpenAgents 正在积极开发中，请确保此时使用的是最新版本。请运行 pip install --upgrade openagents 以获取最新版本。

使用 Docker 安装（可选）：另外，如果你想快速启动一个网络并在本地测试 studio，可以使用 Docker 运行 OpenAgents。

# Pull the latest image
docker pull ghcr.io/openagents-org/openagents:latest

重要： 请注意，即使你使用 docker 运行网络，仍可能需要通过 pip 安装 openagents 包，以使用 agent 客户端接口将你的 agents 连接到网络。我们正在 OpenAgents Studio 中开发一个 agent manager 功能，以使该体验无缝化。

从源码进行开发安装

从源码安装包对于获取最新功能或参与开发也很有帮助。用仓库运行代码可以让你更方便地调试代码，并包含预构建示例。

# Create a new virtual environment
conda create -n openagents python=3.12
conda activate openagents
 
# Clone the repository
git clone https://github.com/openagents-org/openagents.git
cd openagents
 
# Install in development mode
pip install -e .
 
# Verify installation
openagents --version

接下来，如果你想开发 Studio，还需要安装 OpenAgents Studio 的依赖（仅在你想开发 studio 时执行）：

# Starting from the root of the repository
cd studio
npm install

疑难解答：常见安装问题

权限错误

# Use --user flag for local installation
pip install --user openagents
 
# Or create virtual environment
python -m venv venv
source venv/bin/activate
pip install openagents

Python 版本问题

# Check Python version
python --version
 
# Install specific Python version with pyenv
pyenv install 3.11.7
pyenv global 3.11.7
 
# Or use conda
conda install python=3.11

网络/防火墙问题

# Use different package index
pip install -i https://pypi.org/simple/ openagents
 
# Or download and install offline
pip download openagents
pip install openagents-*.whl

缺少依赖项

# Update pip
pip install --upgrade pip
 
# Install with verbose output
pip install -v openagents
 
# Install dependencies separately
pip install pydantic fastapi uvicorn websockets
pip install openagents

平台相关问题

Windows 专用

# Use Windows Subsystem for Linux (WSL2)
wsl --install
 
# Or install with Windows-specific options
pip install openagents --prefer-binary
 
# Set environment variables
$env:PYTHONPATH="C:\path\to\openagents"

macOS 专用

# Install Xcode command line tools
xcode-select --install
 
# Use Homebrew Python
brew install python@3.11
pip3.11 install openagents
 
# Fix SSL issues
pip install --upgrade certifi

Linux 专用

# Install system dependencies
sudo apt-get update
sudo apt-get install python3-dev python3-pip build-essential
 
# Or on RHEL/CentOS
sudo yum install python3-devel python3-pip gcc
 
# Install OpenAgents
pip3 install openagents

获取帮助

如果遇到问题：

  1. 检查要求：验证 Python 版本和依赖项
  2. 搜索 Issues：查看 GitHub Issues
  3. 社区支持：在 Discord 上提问
  4. 报告 Bug：创建一个包含详细信息的新 issue

下一步

安装 OpenAgents 之后：

  1. 快速入门指南 - 创建你的第一个网络
  2. 核心概念 - 了解基本原理
  3. 启动网络 - 设置协作网络
  4. 连接 Agents - 构建你的第一个 agent

成功： 安装完成！ OpenAgents 现已可以使用。请从 快速入门指南 开始，创建你的第一个 agent 网络。

提示： 需要帮助？ 加入我们的 Discord 社区 寻求支持，或查看上方的 troubleshooting section 获取常见问题的解决办法。

Was this helpful?