项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1774
使用教程
环境要求
- Node.js 环境(需支持 corepack,用于启用 pnpm)
- pnpm 包管理器(通过 corepack 安装最新版)
- Git(用于克隆仓库)
- 至少一个大模型提供商的 API Key(Claude、GPT 等,写入 .env 文件)
安装与启动步骤
-
1克隆仓库
把 AgentDock 源码下载到本地,并进入项目根目录,后续命令都在此目录执行。
git clone https://github.com/AgentDock/AgentDock.git cd AgentDock -
2启用 pnpm
项目使用 pnpm 管理依赖,用 corepack 启用并激活最新版 pnpm,无需单独全局安装。
corepack enable corepack prepare pnpm@latest --activate -
3安装依赖
在项目根目录安装所有依赖,耗时取决于网络;如安装出错可改用干净重装脚本。
pnpm install -
4干净重装依赖
仅当依赖损坏或需要从零重建时执行:该脚本会删除全部 node_modules 与 lock 文件后重新安装。
pnpm run clean-install -
5配置环境变量
复制 .env.example 生成环境文件,然后填入你的大模型 API Key,否则客户端无法正常工作。
cp .env.example .env.local -
6启动开发服务器
运行开发服务,终端出现本地访问地址即代表启动成功,可在浏览器打开该地址体验。
pnpm dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
LLM Provider API Key(具体变量名以 .env.example | 是 | AgentDock 开源客户端运行时必须配置大模型提供商的 API Key | sk-xxxxxxxx |
如何确认成功
执行 pnpm dev 后终端无报错并输出本地访问地址,浏览器打开该地址能看到客户端页面。
常见问题
Q:提示找不到 pnpm 命令怎么办?
A:先执行 corepack enable 和 corepack prepare pnpm@latest --activate 启用 pnpm,再运行 pnpm install。
Q:依赖安装失败或想彻底重装怎么办?
A:运行 pnpm run clean-install,它会删除所有 node_modules 和 lock 文件后重新安装依赖。
Q:不配置 API Key 能启动吗?
A:可以启动开发服务器,但开源客户端需要大模型提供商的 API Key 才能正常使用相关功能。
Q:如何把客户端部署到线上?
A:README 提供了部署到 Vercel 账号的按钮,可直接点击按钮完成开源客户端的部署。
注意事项
- corepack 随 Node.js 提供,请先确保本地已安装 Node.js
- 环境文件可命名为 .env 或 .env.local,二者选其一即可
- API Key 属于敏感信息,不要提交到代码仓库
- 可参考官方 Getting Started Guide(docs/getting-started.md)与在线示例 hub.agentdock.ai
核心亮点
- 可视化拖拽编排,降低 Agent 开发门槛
- 内置生命周期管理,支持版本控制和监控
- 插件化架构,轻松集成主流大模型和工具
不足之处
- 项目较新,生态和第三方集成尚不成熟
- 文档/社区待观察
适用场景
- 快速构建企业内部客服或知识库问答 Agent
- 为产品原型搭建多步骤自动化工作流
- 教学和实验环境,学习 Agent 编排原理
替代项目
LangChain、AutoGen、Dify
下一篇:lotus
同类项目推荐
opprime-world-key
开源
让 AI 智能体在元宇宙中安家,自主生存与协作
The key that opens Opprime World — the first metaverse where AI agents are natives,···
emperorclaw
开源
把 AI 塞进公司工作区,自动干活提效
Introduce AI to your company workspace.
Awesome-Adaptation-of-Agentic-AI
开源
一网打尽智能体AI适应研究,快速跟上领域前沿
Repo for "Adaptation of Agentic AI"
awesome-agent-cortex
开源
一张图看懂智能体生态,选型不再东拼西凑
Curated map of AI agent frameworks, protocols, runtimes, skills, memory, identity, s···
Arcgentic
开源
给 AI 编码代理装上计划、自审、外审的强制关卡
Mechanical plan/dev/self-audit/external-audit gates for AI coding agents, with a con···
dao-code
开源
在终端用 DeepSeek 写代码,跨会话记忆几乎零成本
Open-source TypeScript terminal coding agent for DeepSeek-V4 — builds on DeepSeek's···
second-brain
开源
让本地文件自动驱动智能体干活,多平台沟通不用愁。
Second Brain is an agentic framework that acts as an operating system, using local f···
matlab-agentic-toolkit
开源
让 AI 智能体直接调用 MATLAB 做工程计算
The MATLAB Agentic Toolkit brings proven MATLAB capabilities to AI agents, making en···
agent-watch-approve
开源
手表上批准AI操作,任务完成自动提醒,告别盯终端。
⌚ 在 Apple Watch 上批准 Claude Code / Codex 的危险操作,任务完成自动提醒 | Approve y···
