TS

AgentX

by lucky-aeon/AgentX

1 views

AgentX 致力于让小白也能无门槛通过自然语言打造属于自己的 Agent。AgentX 采用了自研 MCP 网关,模型高可用组件打造高可用

apidockerChat & Messaging

AgentX - 智能对话系统平台

AgentX 是一个基于大模型 (LLM) 和多能力平台 (MCP) 的智能 Agent 构建平台。它致力于简化 Agent 的创建流程,让用户无需复杂的流程节点或拖拽操作,仅通过自然语言和工具集成即可打造个性化的智能 Agent。

🔗 相关链接

📦 子仓库

📚 学习资源

⏳ 功能

  • Agent 管理(创建/发布)
  • LLM 上下文管理(滑动窗口,摘要算法)
  • Agent 策略(MCP)
  • 大模型服务商
  • 用户
  • 工具市场
  • MCP Server Community
  • MCP Gateway (等待重构)
  • 预先设置工具
  • Agent 定时任务
  • Agent OpenAPI
  • 模型高可用组件
  • RAG
  • 计费
  • Multi Agent
  • Agent 监控

🚀 如何安装启动

🛠️ 环境准备

必需环境

  • Docker & Docker Compose: 用于容器化部署(推荐)
  • Git: 用于克隆项目和子模块

本地开发环境(可选)

  • Node.js & npm: 推荐使用 LTS 版本
  • Java Development Kit (JDK): JDK 17 或更高版本

系统支持

  • Linux: 完全支持(推荐)
  • macOS: 完全支持
  • Windows: 完全支持(Windows 10/11 + WSL2 或原生支持)

🐳 All-in-One Docker 部署(最简单)

🎯 真正的一键部署:前端 + 后端 + 数据库,一个容器搞定!

🚀 快速启动(使用预构建镜像)

# 直接拉取并启动(最快方式)
docker pull ghcr.io/lucky-aeon/agentx:latest
docker run -d --name agentx -p 3000:3000 -p 8088:8088 ghcr.io/lucky-aeon/agentx:latest

# 查看启动日志
docker logs agentx -f

🔨 本地构建启动

# 克隆仓库并构建
git clone https://github.com/lucky-aeon/AgentX.git
cd AgentX
docker build -f Dockerfile.allinone -t agentx:latest .
docker run -d --name agentx -p 3000:3000 -p 8088:8088 agentx:latest

📁 使用配置文件部署(推荐生产环境)

# 1. 获取配置文件模板
curl -O https://raw.githubusercontent.com/lucky-aeon/AgentX/master/config-templates/production.env
mv production.env agentx.env
vim ./agentx.env  # 编辑配置

# 2. 启动容器(使用预构建镜像)
docker run -d \
  --name agentx-prod \
  -p 3000:3000 \
  -p 8088:8088 \
  -v $(pwd)/agentx.env:/app/config/agentx.env:ro \
  ghcr.io/lucky-aeon/agentx:latest

🔗 外部数据库模式

# 1. 创建Docker网络
docker network create agentx-network

# 2. 启动PostgreSQL(如果需要)
docker run -d \
  --name postgres-db \
  --network agentx-network \
  -e POSTGRES_DB=agentx \
  -e POSTGRES_USER=agentx_user \
  -e POSTGRES_PASSWORD=your_password \
  -p 5432:5432 \
  postgres:15

# 3. 配置外部数据库
curl -O https://raw.githubusercontent.com/lucky-aeon/AgentX/master/config-templates/external-database.env
mv external-database.env agentx.env
# 编辑 agentx.env,设置 DB_HOST=postgres-db

# 4. 启动AgentX容器
docker run -d \
  --name agentx-external \
  --network agentx-network \
  -p 3000:3000 \
  -p 8088:8088 \
  -v $(pwd)/agentx.env:/app/config/agentx.env:ro \
  ghcr.io/lucky-aeon/agentx:latest

📋 访问地址

🔐 默认账号

角色邮箱密码
管理员[email protected]admin123
测试用户[email protected]test123

📖 详细配置说明

查看 config-templates/README.md 获取完整的配置选项和部署指南。


🐳 开发模式部署

🔥 开发模式

最佳开发体验:代码修改自动重启容器,无需手动操作!

Linux/macOS 用户
# 克隆仓库
git clone https://github.com/lucky-aeon/AgentX.git
cd AgentX

# 一键启动开发模式(包含热更新功能)
./bin/start-dev.sh
Windows 用户
# 克隆仓库
git clone https://github.com/lucky-aeon/AgentX.git
cd AgentX

# 一键启动开发模式(包含热更新功能)
bin\start-dev.bat

🏭 生产模式

Linux/macOS 用户
# 生产环境启动
./bin/start.sh
Windows 用户
# 生产环境启动
bin\start.bat

📋 开发模式服务地址

开发模式启动成功后,您可以通过以下地址访问服务:

⚠️ 安全提示:首次登录后请立即修改默认密码,生产环境请删除测试账号。

🛠️ 开发管理命令

Linux/macOS 用户

# 查看服务状态
docker compose -f docker-compose.dev.yml ps

# 停止所有服务(保留容器)
./bin/stop.sh

# 删除所有容器
docker compose -f docker-compose.dev.yml down

# 查看服务日志
docker compose -f docker-compose.dev.yml logs -f [服务名]

# 重启特定服务
docker compose -f docker-compose.dev.yml restart [服务名]

Windows 用户

# 查看服务状态
docker compose -f docker-compose.dev.yml ps

# 停止所有服务(保留容器)
bin\stop.bat

# 删除所有容器
docker compose -f docker-compose.dev.yml down

# 查看服务日志
docker compose -f docker-compose.dev.yml logs -f [服务名]

# 重启特定服务
docker compose -f docker-compose.dev.yml restart [服务名]

📝 开发模式说明

开发模式启动后会显示以下信息并询问是否启动文件监听:

🔥 是否立即启动文件监听?(推荐)
  - 启动后修改代码会自动重启容器
  - 可随时按 Ctrl+C 停止监听
启动文件监听? [Y/n] (默认: Y):
  • 选择 Y:启动文件监听,修改代码自动生效
  • 选择 n:跳过文件监听,需要手动重启服务

💻 本地开发启动(传统方式)

如果您更喜欢传统的本地开发方式:

1. 启动数据库

cd script
chmod +x setup_with_compose.sh
./setup_with_compose.sh

2. 启动后端服务

cd AgentX
./mvnw spring-boot:run

3. 启动前端服务

cd agentx-frontend-plus
npm install --legacy-peer-deps
npm run dev

功能介绍

Contributors

AgentX

Star History

Star History Chart

联系我们

我们致力于构建一个活跃的开发者社区,欢迎各种形式的交流与合作!

📱 私人微信

如有技术问题或商务合作,可添加开发者微信:

私人微信

👥 微信交流群

加入我们的技术交流群,与更多开发者一起讨论:

微信交流群

📢 微信公众号

关注我们的公众号,获取最新技术动态和产品更新:

微信公众号

如果二维码过期或无法扫描,请通过私人微信联系我。

Install

No configuration available
For more configuration details, refer to the content on the left

Related

Related projects feature coming soon

Will recommend related projects based on sub-categories