系统要求
- 需安装 Docker 和 Docker Compose
- 最低 4GB 内存配置
- 10GB 可用磁盘空间
- 需要网络连接以下载镜像和更新
许可协议
使用 PentAGI 前，请阅读并同意《最终用户许可协议》(EULA)。协议文本可在PentAGI的 GitHub 代码库查看：EULA.md
获取项目最新动态和实时状态，请访问 GitHub 代码库。
快速安装指南
- 创建工作目录：
mkdir pentagi && cd pentagi
- 获取配置文件：
curl -o .env https://raw.githubusercontent.com/vxcontrol/pentagi/master/.env.example
- 在.env文件中配置API密钥：
# 必填：至少配置一个LLM服务商
OPEN_AI_KEY=您的openai密钥
ANTHROPIC_API_KEY=您的anthropic密钥
# 选填：增强搜索功能
GOOGLE_API_KEY=您的谷歌密钥
GOOGLE_CX_KEY=您的谷歌CX标识
TAVILY_API_KEY=您的tavily密钥
TRAVERSAAL_API_KEY=您的traversaal密钥
- 启动PentAGI：
curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/master/docker-compose.yml
docker compose up -d
访问 localhost:8443 进入Web界面（默认账号：admin@pentagi.com / admin）
系统架构
PentAGI采用模块化、可扩展的安全架构，核心组件包括：
1. 核心服务
- 前端界面：基于React框架的TypeScript实现
- 后端API：Go语言开发的REST/GraphQL接口
- 向量存储：集成pgvector的PostgreSQL语义搜索引擎
- 任务队列：异步任务处理系统
- AI代理：具备专业分工的多智能体系统
2. 监控体系
- OpenTelemetry：统一可观测性数据采集
- Grafana：实时可视化告警看板
- VictoriaMetrics：高性能时序数据库
- Jaeger：全链路分布式追踪
3. 分析系统
- Langfuse：LLM运行观测与分析平台
- ClickHouse：列式分析数据仓库
- Redis：高速缓存与限流控制
- MinIO：S3兼容对象存储
外部系统集成
Langfuse配置
用于监控AI代理运行状态：
# 在.env中添加：
LANGFUSE_BASE_URL=http://langfuse-web:3000
# 启动附加服务：
curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/master/docker-compose-langfuse.yml
docker compose -f docker-compose.yml -f docker-compose-langfuse.yml up -d
监控系统集成
实现精细化系统监控：
# 在.env中添加：
OTEL_HOST=otelcol:8148
# 启动监控组件：
curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/master/docker-compose-observability.yml
docker compose -f docker-compose.yml -f docker-compose-observability.yml up -d
OAuth认证配置
支持GitHub/Google登录：
# GitHub认证
GITHUB_CLIENT_ID=您的github客户端ID
GITHUB_CLIENT_SECRET=您的github密钥
# Google认证
GOOGLE_CLIENT_ID=您的google客户端ID
GOOGLE_CLIENT_SECRET=您的google密钥