AgentsMesh

环境要求

• Go 1.24+（手动搭建后端时需要）
• Node.js 20+
• pnpm 包管理器
• Docker（本地全栈和容器运行需要）
• 一台可联网的 Linux/macOS/Windows 机器，Runner 提供 deb、rpm、Windows 等安装方式

安装与启动步骤

1. 1注册控制台账号

   直接使用 agentsmesh.ai 托管服务：注册后连接你的 Git 提供商，并准备自有 AI API 密钥（BYOK），无需自建整套后端。

2. 2安装 Runner

   在每一台要纳入集群的机器上执行。Runner 是轻量守护进程，代理在本地执行，代码始终留在你自己的基础设施上。

   curl -fsSL https://agentsmesh.ai/install.sh | sh

   复制

3. 3启动 Runner

   前台启动 Runner 让它上线，之后即可从 Web / 桌面 / iOS 任意控制台创建 AgentPod 并下发任务。

   agentsmesh-runner run

   复制

4. 4安装为系统服务

   可选步骤：把 Runner 注册成系统服务并启动，实现常驻在线，适合需要长期运行的机器。

   agentsmesh-runner service install
   agentsmesh-runner service start

   复制

5. 5克隆项目仓库

   如果要在本地跑完整技术栈，先克隆 AgentsMesh 源码到本机。

   git clone https://github.com/AgentsMesh/AgentsMesh.git

   复制

6. 6一键启动本地栈

   进入 deploy/dev 执行 dev.sh，会自动拉起 PostgreSQL、Redis、MinIO、后端、Relay、Traefik 以及带热更新前端。

   cd AgentsMesh/deploy/dev
   ./dev.sh

   复制

7. 7查看后端日志

   手动模式下可用该命令持续输出后端容器日志，确认服务是否正常启动、有无报错。

   docker compose logs -f backend

   复制

8. 8登录本地控制台

   浏览器打开 Web 控制台 http://localhost:3000，用测试账号登录；API 地址为 http://localhost:80/api。

关键配置

如何确认成功

浏览器能打开 Web 控制台 http://localhost:3000，并用 dev@agentsmesh.local / devpass123 登录成功，即表示本地全栈已启动。

常见问题

注意事项

• 最快上手方式是直接使用 agentsmesh.ai 托管服务，只需安装 Runner，不必自建整套后端。
• 端口是动态分配的，部署前先看 deploy/dev/.env，不要把 3000 或 80 写死在自有配置里。
• dev@agentsmesh.local 与 admin@agentsmesh.local 等测试账号仅供本地开发环境使用。
• Runner 还提供 deb、rpm、Windows 等更多安装方式，详见仓库 runner/ 目录下的 README。