craft-agents-oss

用 TypeScript 快速搭出能自主干活的 AI 智能体

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 7239

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类智能体

开发团队craft-ai-agents

所属国家

官网地址

GitHubhttps://github.com/craft-ai-agents/craft-agents-oss

定价模式free

价格说明开源免费，定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型

GitHub 星标★ 7239

30天Star增速

HF 下载量

上线时间2026-01-19 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-11

浏览次数0

项目介绍

craft-agents-oss 是一个用 TypeScript 编写的开源智能体（Agent）框架，目标是让开发者快速构建、编排和部署可自主完成任务的 AI Agent。它把大模型调用、工具使用、任务规划、多轮记忆等能力封装成可复用的组件，解决从零搭建 Agent 时重复造轮子、流程难以编排、状态管理混乱的问题。核心能力包括：以声明式方式定义 Agent 的行为与工具集，支持多步骤任务分解与执行，内置上下文与记忆管理，可接入多种模型与外部 API，并提供可观测的执行链路便于调试。项目采用 TypeScript，类型友好，便于在 Node.js 或前端工程中集成，适合做自动化助手、工作流机器人、知识问答等场景。作为一个成长中的项目，它更偏向开发者工具定位，强调可扩展和可组合，而非开箱即用的成品应用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 15 分钟部署方式：本地安装 8 步

环境要求

macOS、Linux 或 Windows 桌面环境（一键安装脚本）
需要联网下载安装包
使用前需准备模型接入方式：Anthropic API Key/Claude Max、Google AI Studio、ChatGPT Plus（Codex OA
如需 Docker 部署：已安装 Docker，并准备一个服务端访问令牌
如需从源码构建：已安装 Bun（README 中使用 bun run electron:start）

安装与启动步骤

1macOS/Linux 一键安装

README 推荐的一键安装方式，脚本会下载并安装 Craft Agents 桌面应用，执行后按提示完成安装。
```
curl -fsSL https://thecraftagents.com/install-app.sh | bash
```
2Windows 一键安装

Windows 用户在 PowerShell 中执行该命令安装应用；若执行策略受限需先调整策略。
```
irm https://thecraftagents.com/install-app.ps1 | iex
```
3启动并连接模型

安装完成后启动应用，选择一种 API 连接方式：Anthropic（API Key 或 Claude Max）、Google AI Studio、ChatGPT Plus（Codex OAuth）或 GitHub Copilot OAuth
4创建工作区

在应用内创建一个 workspace，用于组织管理自己的会话（sessions）。
5连接数据源

可选步骤：添加 MCP server、REST API 或本地文件系统作为数据源，让 Agent 能访问外部内容。
6Docker 部署服务端

若要跑服务端而非桌面应用，可用官方镜像启动，映射 9100 端口并挂载数据卷持久化配置。
```
docker run -d 
  -p 9100:9100 
  -e CRAFT_SERVER_TOKEN= 
  -e CRAFT_RPC_HOST=0.0.0.0 
  -v craft-data:/root/.craft-agent 
  craft-agents-server
```
7CLI 运行单次任务

craft-cli run 自带 headless 服务，会创建会话、发送提示并流式返回结果后退出，无需单独启动服务。
```
craft-cli run "Summarize the README"
```
8从源码构建运行

在 monorepo 根目录下用 Bun 启动 Electron 应用，适合二次开发场景。
```
bun run electron:start
```

关键配置

配置项	必填	说明	示例
`CRAFT_SERVER_TOKEN`	是	Docker 服务端的访问令牌，必须自行设置
`CRAFT_RPC_HOST`	否	RPC 服务监听地址，Docker 中需设为 0.0.0.0	`0.0.0.0`
`CRAFT_RPC_TLS_CERT`	否	启用 TLS 时的证书文件路径	`/certs/cert.pem`
`CRAFT_RPC_TLS_KEY`	否	启用 TLS 时的私钥文件路径	`/certs/key.pem`
`LLM_API_KEY`	否	模型 API Key，也可用各厂商专用环境变量	`sk-xxxxxxxx`
`--provider / --model`	否	craft-cli run 指定模型供应商与模型 ID	`--provider anthropic --model claude-sonnet-4-5-20250929`

如何确认成功

Docker 方式下容器正常运行且 9100 端口可访问；桌面方式下应用成功启动并能新建会话开始对话。

常见问题

Q：必须自己准备 API Key 吗？

A：不一定，README 列出了多种接入方式：Anthropic 的 API Key 或 Claude Max、Google AI Studio、ChatGPT Plus（Codex OAuth）、GitHub Copilot OAuth，可任选其一。

Q：如何改用 OpenAI、Google 等其他模型？

A：craft-cli run 支持 --provider 参数，可选 anthropic、openai、google、openrouter、groq、mistral、xai 等，并用 --model 指定具体模型 ID。

Q：API Key 从哪里读取？

A：按 --api-key、$LLM_API_KEY 或厂商专用环境变量（如 $ANTHROPIC_API_KEY、$OPENAI_API_KEY）的顺序解析。

Q：配置文件放在哪里？

A：默认存放在 ~/.craft-agent/，包含 config.json、credentials.enc、preferences.json、theme.json 以及各 workspace 子目录。

Q：Google 集成（Gmail、Calendar 等）要做什么？

A：需要自行创建 Google OAuth 凭据，属于一次性配置，README 未提供具体步骤。

注意事项

项目基于 Apache 2.0 协议开源，可自由修改和再分发。
Docker 部署时建议挂载 craft-data 卷，否则配置与会话数据会随容器丢失。
README 中的 monorepo 源码构建段落不完整，bun run electron:start 为其中显示的命令。
TLS 方式需把证书目录以只读方式挂载到容器内的 /certs。

核心亮点

TypeScript 编写，类型完整，前端/Node 项目集成成本低
声明式定义 Agent 行为与工具，编排多步骤任务更清晰
内置记忆与上下文管理，减少自行维护对话状态的重复工作

不足之处

生态与文档仍在成长阶段，深度使用需读源码
相比成熟框架，现成示例和社区插件较少

适用场景

搭建企业内部自动化任务助手
开发多步骤工作流机器人
构建带工具调用的知识问答 Agent

替代项目

LangChain、AutoGen

上一篇：agency-agents

下一篇：agent-zero