安装

如何安装 AgenticX 并配置运行环境。

安装

环境要求

Python 3.10+
pip 或 uv

从 PyPI 安装（推荐）

bash

1pip install agenticx

如需全部可选能力（文档解析、向量库等）：

bash

1pip install "agenticx[all]"

从源码安装

bash

1git clone https://github.com/DemonDamon/AgenticX.git
2cd AgenticX
3
4# 基础安装
5pip install -e .
6
7# 含全部 extras
8pip install -e ".[all]"

环境变量

bash

1# 必需：至少配置一个 LLM 供应商密钥
2export OPENAI_API_KEY="your-api-key"
3
4# 可选供应商
5export ANTHROPIC_API_KEY="your-api-key"
6export MOONSHOT_API_KEY="your-api-key"

或在项目根目录使用 .env 文件：

bash

1OPENAI_API_KEY=your-api-key
2ANTHROPIC_API_KEY=your-api-key

系统依赖（可选）

高级文档处理能力（PDF / Word / PPT 解析）可能需要：

bash

1# macOS
2brew install antiword tesseract
3
4# Ubuntu/Debian
5sudo apt-get install antiword tesseract-ocr

验证安装

bash

1agx --version

应看到类似输出：

1agx version 0.x.x

安装

环境要求

从 PyPI 安装（推荐）

从源码安装

环境变量

系统依赖（可选）

验证安装

下一步