FollowAgents AI AGENTS 目录
首页 / 全部 Agents / AnimaWorks
开发与工程 autonomous-agentsmulti-agentmemorybrain-inspiredmulti-modelragorganization-as-codegithub-webhooks

AnimaWorks

像聊微信一样指挥一支 24/7 自主运转的 AI 组织：持久化智能体各带长期记忆、身份与排班，自动写码、评审、修 CI 并向你汇报。

在 GitHub 查看 ↗ 快速上手 ↓
源仓库
xuiltul/animaworks
Star 数
★ 269
最近更新
1 天前
License
Apache-2.0
主语言
Python
FA 评分
48/100 · 缺口较多

30 秒速览

可在哪里用
通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
开始前需要
Python 3.12/3.13uvDocker（可选）Ollama（可选本地 LLM）WSL（Windows 环境）GitHub CLI（Docker 镜像内置）Shell / 命令行网络访问本地文件系统MCP Server
典型场景
独立开发者或小团队：让 3–8 个 Anima 全天候维护一个生产 SaaS，自动消化 GitHub CI 失败和 PR 评论（README 记录 6 个月自主提交 302 个 PR）。
主要局限
不支持原生 Windows，必须经 WSL 运行（依赖 fcntl、pty、os.killpg 等 Unix API）。
源码审查
48/100 · 缺口较多

这个 Agent 能做什么，适合哪些场景？

AnimaWorks 是一个开源的「Organization-as-Code」框架，把多个持久化 AI 智能体（Digital Animas）组成一个全天候运转的虚拟组织。每个 Anima 拥有基于文件系统的类脑长期记忆：六通道自动预热、ChromaDB 向量 + BM25 + 原子事实混合检索（可选 Neo4j 图记忆）、夜间睡眠式整合与主动遗忘。运行时采用 FastAPI 控制面加每 Anima 独立 OS 进程和 IPC v2 任务子进程的隔离架构，配合 SQLite TaskStore 原子任务板、Heartbeat/Cron 自主巡逻和 GitHub Webhook 网关。交互界面是 LINE 风格的网页聊天（WebSocket/SSE），支持一键审批卡、D3 记忆气泡图、语音通话和 3D/像素办公室可视化。引擎层支持 Claude Agent SDK、Codex、Cursor、Gemini CLI、Grok 与 LiteLLM 七种执行模式，可接 Claude 订阅登录、各云 API 或本地 Ollama。安全上通过 Enclave 独立 OS 用户域隔离密钥与 PII，并对出站内容做 PII 清洗。

AnimaWorks 启动一个 FastAPI 服务器（默认端口 18500），为每个 Anima 拉起独立的根进程，重活再派生 TaskRunner 子进程并通过 IPC v2（STDIN/STDOUT JSON-RPC + 二进制分帧）通信。收到消息、GitHub webhook 或 Heartbeat/Cron 触发后，Manager Anima 负责目标拆解，经 SQLite TaskStore（shared/taskboard.sqlite3）下发任务，带 mutex_key 防冲突、delegated_tasks 委托契约和停滞任务自动恢复。工程师 Anima 在隔离的 git worktree 沙箱中并行写码、运行测试、互相做多模型 PR 评审、自动修复 CI 失败并核验部署结果。每次对话前执行六通道记忆预热（发送者画像、近期活动、相关知识、待办、情节、原子事实），混合检索管线融合向量搜索（ChromaDB）、BM25、FactRecord 与 RRF；夜间维护进程把当日日志整合为结构化知识并按保护规则遗忘低价值记忆。需要人工签批时通过 call_human 在聊天中弹出审批卡，重大事故可经 Twilio 直接打电话。CLI 提供 animaworks start / demo / init / chat / task / memory / enclave / company 等命令族。

  1. 独立开发者或小团队：让 3–8 个 Anima 全天候维护一个生产 SaaS，自动消化 GitHub CI 失败和 PR 评论（README 记录 6 个月自主提交 302 个 PR）。
  2. 技术负责人：通过 dev-lead / engineer / researcher / ops 角色模板快速组建分工明确的编码组织，用 git worktree 隔离并行开发。
  3. 需要无人值守值班的运维：用低成本的 background_model 跑 Heartbeat/Cron 巡逻，监控日志、健康检查，事故时经 Twilio 语音呼叫真人。
  4. 客服与行政场景：处理客户咨询、整理 Zoom 会议纪要，经 Slack/Discord/Chatwork 双向同步消息。
  5. 想本地跑私有模型的用户：通过 LiteLLM 模式 A 接 Ollama/vLLM，不依赖任何云 API。
  6. 多业务线管理者：用 animaworks company 命令在一个运行时里划分多个公司/事业部并做导出与拆分。

如何安装或部署这个 Agent？

macOS/Linux 一键安装：

curl -sSL https://raw.githubusercontent.com/xuiltul/animaworks/main/scripts/setup.sh | bash
cd animaworks
uv run animaworks start

Windows 会自动安装 WSL：

irm https://raw.githubusercontent.com/xuiltul/animaworks/main/scripts/setup.ps1 | iex
cd animaworks
uv run animaworks start

Docker 部署（镜像内含 Node.js、GitHub CLI、Playwright、Claude Code/Codex/Gemini CLI）：

git clone https://github.com/xuiltul/animaworks.git && cd animaworks
docker compose up -d --build

手动 pip 安装（推荐 Python 3.12/3.13）：

git clone https://github.com/xuiltul/animaworks.git && cd animaworks
python3 -m venv .venv && source .venv/bin/activate
pip install --upgrade pip && pip install -e ".[all-tools]"
animaworks start

凭证可选用 Claude Code 订阅登录、codex login、ANTHROPIC_API_KEY / OPENAI_API_KEY / GOOGLE_API_KEY 等，或本地 Ollama（无需 API key）。

如何使用这个 Agent？

60 秒体验预置的 3-Anima 演示组织（无需 API key，若已登录 Claude Code 或 Codex）：

curl -sSL https://raw.githubusercontent.com/xuiltul/animaworks/main/scripts/setup.sh | bash
cd animaworks
uv run animaworks demo

然后打开 http://localhost:18501 与已在工作的团队聊天。正式使用则打开 http://localhost:18500 走设置向导：选语言与主题（en/ja/zh/ko）→ 配置 LLM 连接 → 用 dev-lead、full-stack、assistant 等模板创建第一个 Anima。也可全程无浏览器操作：

uv run animaworks init
uv run animaworks start
uv run animaworks chat alice "Check our sprint goals for today and delegate tasks to the team"

创建成员、查看任务板等：

docker exec -it <container> animaworks anima create --name alice --template dev-lead
docker exec -it <container> animaworks send <your-name> alice "Hello!"

日常通过网页聊天交流，审批请求会以卡片形式出现（Approve/Reject/Comment）；背景活动自动折叠，可切换 Background 展开。

这个 Agent 有哪些优点和局限？

优点
  • 有真实生产数据背书：8-Anima 组织连续 6 个多月自主开发运营 SaaS，31,215 个任务中 99.7% 由组织自发完成。
  • 类脑记忆架构是明确差异点：六通道预热、向量+BM25+原子事实混合检索、夜间整合与主动遗忘，而非无状态会话包装。
  • 故障隔离做得细：每 Anima 独立 OS 进程 + TaskRunner 子进程（IPC v2），单个工具挂死只回收子进程，服务器不倒。
  • 七种执行引擎 + 前台/后台模型混合路由，可用便宜模型跑巡逻、用前沿模型写码，并可完全接本地 Ollama。
  • 安全设计超出同类：Enclave 独立 OS 用户域 + Unix 域套接字白名单 + 出站 PII 清洗 + 五段命令检查与信任边界标注。
局限
  • 不支持原生 Windows，必须经 WSL 运行（依赖 fcntl、pty、os.killpg 等 Unix API）。
  • 部署面较重：进程树、ChromaDB、SQLite TaskStore、可选 Neo4j/向量服务等多个组件，排障和理解成本不低。
  • 持续运行的 Heartbeat/Cron 和多 Anima 并发会持续消耗 LLM 配额/费用，且高级功能依赖 Claude/Codex 等订阅或 API key。
  • README 中的对比表（vs CrewAI/LangGraph 等）为项目自述，且生产数据来自作者自己的产品，缺乏第三方验证。
  • 图像/语音/3D 生成和 Twilio 电话等能力需要额外申请 NovelAI、fal.ai、ElevenLabs、Twilio 等密钥。

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
AnimaWorks 当前 48 · 缺口较多 — ★ 269 1 天前 Python Codex · Claude Code · OpenAI API · Claude API
《LangGraph 1.0 完全指南》 69 · 存在缺口 代码库 / SDK免费 + 模型费 ★ 467 1 个月前 Jupyter Notebook Claude Code
Agentica 63 · 存在缺口 命令行工具免费 + 模型费 ★ 360 1 天前 Python OpenAI API · Claude API
Agent Craft 智能体教程 49 · 缺口较多 命令行工具免费 + 模型费 ★ 533 9 天前 Python OpenAI API

FollowAgents 如何评估这个 Agent？

FollowAgents 源码审查 · FARS-2.1
缺口较多
48/ 100 五分制 2.4 / 5
信任安全 13/29
可靠稳定 6/14
适用触发 10/18
规范维护 10/18
有效结果 6/13
证据核验 3/8
查看各维度的扣分理由
信任安全13 / 29 · 2.2/5

安全文档（docs/en/security.md 等）详细描述了信任边界、命令策略、文件访问策略、Enclave 与 PII 脱敏、内部 API 令牌校验，属于较扎实的最小权限设计（least_privilege=2）。但用户确认仅体现为 call_human 审批卡与部分审批门，缺少对高危外部副作用（发信、电话、git push）的强制确认证据（user_confirmation=1）。数据流透明性有信任标签与来源记录（=2）。敏感数据处理有 Egress PII 脱敏与 Vault，但依赖可选 enclave 额外包（=2）。依赖安全方面 pyproject 固定了 mcp<2、litellm 上限并注明 chromadb 已知问题，但依赖面极广（chromadb、sentence-transformers、litellm、多个 CLI SDK），未见锁文件或漏洞扫描证据（=1）。外部效应方面文档明确承认没有发送预算/频率上限，仅同一 run 内去重（=1）。回滚方面有 GlobalPermissionsCache 回滚与进程重启，但缺少对 Agent 自主写代码/部署的通用回滚机制说明（=1）。来源归属方面有 Apache-2.0 与版权声明，但发布者身份未经验证、无 NOTICE 或第三方归属清单（=1）。

可靠稳定6 / 14 · 2.1/5

自一致性上 README 宣称“生产验证 302 PR/99.7% 自主”等指标，但仓库内无对应日志或可核对数据，且安全文档标注的验证提交（581e20f1）与本次审查修订（e7f0d47）不一致，存在文档漂移（=1）。依赖可用性上依赖大量可选 extras 与外部 CLI（Claude/Codex/Cursor/Gemini/Grok），Windows 原生不支持需 WSL，安装路径脆弱（=1）。失败信息方面文档描述了配置读取失败即拒绝、rate_guard 重试、进程隔离回收等，错误处理思路清晰（=2）。

适用触发10 / 18 · 2.8/5

受众与场景覆盖开发者、运维、多语言用户，提供 4 套预设与多引擎（=2）。能力边界文档明确列出残余风险、不保证任意主机防护、Bash 检查为启发式（=2）。触发精度上 Heartbeat/Cron/Webhook 有描述，但缺少对触发条件、去重、误触发的具体阈值证据（=1）。环境适配支持 macOS/Linux/WSL/Docker，但明确不支持原生 Windows（=2）。

规范维护10 / 18 · 2.8/5

信息架构有 README 多语言、docs 目录、安全/架构/参考文档，结构清晰（=2）。安装说明详尽（setup.sh、PowerShell、Docker、pip）（=2）。命名稳定性上存在 legacy 名称迁移（core.supervisor.runner → core.runtime.runner）与多处“until 2026-11”注释，说明命名仍在变动（=1）。示例与 FAQ 有 60 秒演示、Demo Guide、对比表（=2）。已知限制在安全文档残余风险与 pyproject 注释中有体现（=2）。许可证为完整 Apache-2.0 文本且 pyproject 声明一致（=3）。版本与变更日志仅见 pyproject version 0.17.0 与 CHANGELOG 链接，未提供内容（=1）。维护责任方面发布者未经验证，无明确维护者/治理说明（=1）。

有效结果6 / 13 · 2.3/5

输出可用性上提供聊天 UI、审批卡、文件附件、CLI，交互产物较可用（=2）。边际价值上“组织即代码+脑启发记忆”有差异化，但同类多智能体框架众多，且核心价值主张依赖未验证的生产指标（=1）。成本效益上多引擎、多进程、ChromaDB、语音/3D 资产生成带来较高资源与配置成本，缺少成本对比证据（=1）。

证据核验3 / 8 · 1.9/5

主张可追溯性上 README 指标标注“aggregated from primary execution logs”但仓库内无日志或数据文件可核对（=1）。交叉印证上安全文档与 pyproject 注释、CI 工作流相互印证部分工程实践，但生产指标无第二来源（=1）。事实与推断分离上 README 混合营销性断言与工程事实，未明确区分（=1）。

风险与缓解建议
  • README 中的生产指标（302 PR、99.7% 自主任务）无法在仓库内核对，应视为未经验证的营销性主张。
  • 安全文档标注的验证提交与本次审查修订不一致，文档可能已漂移，实际代码行为需自行核对。
  • 外部发送缺少频率/预算上限，仅同一 run 内去重，存在误发与滥用风险。
  • 依赖面广且包含多个外部 CLI 与可选 extras，安装与供应链风险较高，未见锁文件或漏洞扫描。
  • 发布者身份未经验证，维护责任与更新路径不明确。
  • 原生 Windows 不支持，需 WSL；多进程与 ChromaDB 带来较高资源与配置成本。
证据充分度：低 评估于 2026年11月1日 审查版本 e7f0d4732006 评估后仓库已有新提交，评分可能未覆盖最新改动
评估证据 README.mden/security.mdja/security.mdko/security.mddocs/security.mdspecs/20260215_memory-write-security-20260216.mdLICENSEpyproject.tomlworkflows/ci.ymlworkflows/publish.ymltests/__init__.pytests/_codex_sandbox.pytests/conftest.py
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

  1. v0.17.0
    发布说明摘录
    Highlights - Standard workspace file names. Anima workspaces now follow the de-facto convention used by OpenClaw and Hermes Agent: SOUL.md (personality, voice, values), IDENTITY.md (name, profile, appearance), AGENTS.md (role and operating instructions), HEARTBEAT.md, and BOOTSTRAP.md. - Export to other agent runtimes. animaworks anima export NAME --format openclaw|hermes --out DIR writes an Anima in OpenClaw or Hermes layout (credentials redacted). The OpenClaw / Hermes importers can now apply SOUL.md, IDENTITY.md, AGENTS.md, and HEARTBEAT.md directly. …
    在 GitHub 查看 ↗
  2. v0.16.0
    发布说明摘录
    AnimaWorks v0.16.0 This release redesigns the web chat as a messenger-style talk screen with file attachments and a memory browser, adds a Twilio phone channel, an isolated enclave mode for sensitive data, and execution mode Y for the Antigravity CLI. It also makes tasks, inbox handling and cron quieter, and restructures the runtime so each process owns its own state. Highlights …
    在 GitHub 查看 ↗
  3. v0.15.0
    发布说明摘录
    AnimaWorks v0.15.0 This release adds background memory review and peer notes, a task board that Animas triage themselves, a skill ledger with rollback, and per-caller internal API tokens. It also shortens prompts and reorganizes the code into single-purpose packages. Highlights - Background memory review: after a context compaction, at the end of a task and every 10 chat turns, the background model makes up to 3 knowledge or peer-note updates without blocking the conversation. Peer notes (animas/{name}/peers/) are recalled whenever that person or Anima writes in. …
    在 GitHub 查看 ↗
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审，横向比较这个 Agent 所属的短名单。

开源编程 Agent 横向对比

按 FARS 评审排序的开源编程 agent——分数、信任、许可证、语言与维护状态并排比较，并说明各自擅长与不擅长什么。

Claude Code Agent 横向对比

完整兼容 Claude Code 的 agent，按 FARS 评审排序——兼容性取自各 agent 自己的 AGENTS.md 与文档，不做推测。

相关 Agents

开发与工程

《LangGraph 1.0 完全指南》

面向 Agent 开发者的 LangGraph 1.0 开源中文电子书，14 章覆盖从 ReAct Agent 到多智能体与 RAG 的完整实战，并可安装为 Claude Code Skill 直接生成高质量 LangGraph 代码。
开发与工程

Agentica

一个人，一支 agent 团队：多会话 CLI 协作、/goal 长任务、微信企微飞书远程召回，让开放模型跑得更准更快更省。
开发与工程

Agent Craft 智能体教程

用可运行的 Python 示例系统学习智能体全栈开发。
开发与工程

RepoBrain 代码库智能问答引擎

给你的代码库装上大脑——在 Claude Code、Cursor、Codex、Windsurf 等工具中使用，基于真实代码和文件定位的回答。