loomcycle

用途

loomcycle 是一个可自托管的智能体系统运行时（runtime substrate），定位为 agent runtime sidecar：以单个 Go 二进制形式与应用并行运行，负责承载智能体循环、模型路由、记忆与文档子系统、多智能体协作等能力。官方描述为“智能体所居住、对话与学习的地方”。

主要能力

• 单二进制交付：约 80 MB 的 Go 二进制，自带智能体运行所需组件。
• 多提供商模型支持：内置六家 LLM 提供商的路由能力。
• MCP 原生：支持 MCP 连接，具备 MCP server identity。
• 智能体记忆：具备双时态有效性（bi-temporal validity）与 subject-document identity 的智能体记忆；支持按作用域的 SQL 记忆。
• 文档存储：文档存储并为每篇文档派生搜索单元。
• Decision 工具：输出带类型的概率结果（如单选、是/否、量表位置），而非纯文本。
• Teams 原语：用于多智能体状态机工作流。
• 上下文保留模式：三种上下文保留模式，并提供对已驱逐片段的 Recall 工具。
• 工具使用框架：使小型本地模型也能调用工具，官方称实测 10/10 成功率。
• 内置开发工具链：Python、Go、Rust、Node、git、gh、curl、jq、sqlite3，以及带每次运行临时卷的无头 Chromium。
• 可视化画布 LoomBoard：用于构建和调试工作流。
• 多副本高可用：基于 Postgres 的多副本 HA，支持 OpenTelemetry。
• 快照：可将整个部署打包进一个归档。

使用方式

应用可通过 HTTP、gRPC、MCP、TypeScript 适配器或 Python 适配器调用 loomcycle。智能体循环、多提供商路由、记忆与文档子系统、Decision 工具、Teams、MCP server identity、OpenTelemetry 追踪与多副本协调都位于该二进制内，应用可保持原有语言。

提供两种运行姿态（posture），使用同一二进制与同一配置 schema，由运维人员通过环境变量选择：

• 沙箱姿态：作为受管理的沙箱运行。
• 完整智能体开发环境姿态。

信任边界为 operator / caller：operator 配置是下限，调用方可在每次请求中收窄权限但不能放宽。持有 bearer token（LOOMCYCLE_AUTH_TOKEN）者应视为完全可信。若需真正隔离，应在容器或 VM 中运行 loomcycle；Bash 虽有限制（cwd、env scrub、输出边界、超时），但并非内核级沙箱。

快速开始

init --with-token 会打印 Web UI 地址（http://127.0.0.1:8787/ui）。打开后，在登录提示处粘贴来自 ~/.config/loomcycle/auth.env 的 token。token 保存在 0600 文件中，不会嵌入 URL。loomcycle 与 loomcycle doctor 都会从配置目录自动加载 auth.env；显式 export LOOMCYCLE_AUTH_TOKEN=… 始终覆盖它。

引导层级（Bootstrap tiers）

• Tier 1：零配置开发（开放模式，localhost）：无 token、无参数，仅在 127.0.0.1 上运行，whoami 返回合成的 admin。切勿暴露到 localhost 之外。
• Tier 2：单一共享 token（推荐默认）：一个 bearer 控制全部，init --with-token 为便捷方式。
• Tier 3：多租户、按主体 token（RFC L，v0.17.0）：为每个开发者/应用铸造独立 bearer，绑定权威的 (tenant, subject, scopes)。首个 admin OperatorTokenDef 会禁用旧的共享 token 回退。支持按路由的 HTTP scope 与按 RPC 的 gRPC scope，Web UI 变为角色感知（super-admin vs tenant）。

从源码构建（用于开发）

资料中提供了“Build from a checkout (for development)”的说明，但未给出具体命令内容。

多副本集群演示（v0.12.x）

提供一条命令的 docker compose up 集群（2 个 loomcycle 副本、Postgres、nginx LB）及验证脚本，见 examples/cluster/README.md；完整运维手册见 docs/MULTI-REPLICA.md。

适用场景

• 需要自托管、掌控智能体循环与数据底座的团队。
• 需要多智能体状态机工作流（Teams）的场景。
• 需要带概率输出的决策模型（Decision）的场景。
• 需要智能体记忆与文档检索的场景。
• 需要在 Postgres 上多副本高可用部署的场景。
• 需要以 HTTP/gRPC/MCP 或 TS/Python 适配器集成到既有技术栈的场景。

限制与注意事项

• Bash 限制并非内核级沙箱；真正隔离需容器或 VM。
• 持有 bearer token 者视为完全可信。
• Tier 1 开放模式仅限 localhost，切勿对外暴露。
• 资料未提供具体收费、价格信息。
• 资料未提供完整的安装命令细节（仅提及 Homebrew、多架构 Docker、Claude Code 插件、TS + Python 适配器、TrueNAS 应用等分发形式）。

版本与状态

loomcycle 已过 v1.0（当前 v1.111），功能完整、经过加固并具备分发条件。在 JobEmber.ai 经过两个月持续生产运行验证，在真实用户负载下使用 Postgres 多副本 HA。v1.0 之后的开发为新增原语与加固。采用 Apache-2.0 许可。近期版本（v1.101–v1.112）涉及快照携带整个部署、团队决策、无痕运行（retention: "none"）、多租户认证、token 过期与限流、子智能体与团队走查（team walk）等能力。