Repolode
AFK-surf

AFK-surf/Comma

开源的无会话个人 AI 智能体,把目标拆成任务并持续执行,支持 Docker Compose 自托管。

Star
327
Fork
22
未关闭 Issue
1
最近提交
前天

这是什么?

Comma 是一个个人 AI 智能体,工作围绕持久化的任务(Task)组织,而不是聊天会话。简单问题直接在聊天中回答,较大的请求则转为任务,由智能体规划、执行、复核并验证,直到目标完成。任务在“进行中”“待审核”“已完成”之间流转,需要用户决定的事项会停在待审核状态。

智能体还可以运行称为 Loop 的常驻监视程序,监控收件箱、代码仓库或订阅源,只在需要处理时才调用模型。在 Mac 上,Salix 组件可以读取本地文件;开启相关权限后,还能修改文件、运行命令,或把工作交给 Codex、Claude Code 等工具。模型可使用自己的 API Key,也可以接入 ChatGPT 或 Claude 订阅。

后端主要使用 Elixir/OTP 编写,每个智能体作为独立进程运行;仓库中包含 TLA+ 模型和 Lean 验证的运行时属性。仓库提供 Docker Compose 配置,可一键启动包含 PostgreSQL、Redis、MinIO 和 ClickHouse 的单机实例。

核心功能

  • 01将较大的请求转为任务,规划、执行并验证直到完成。
  • 02运行 Loop 监控收件箱、代码仓库或订阅源,仅在需要时唤醒智能体。
  • 03通过 Salix 连接 Mac,读取本地文件,并在授权后执行命令。
  • 04可把 Codex、Claude Code 等智能体作为 Worker 或子智能体调用。
  • 05提供 Docker Compose 配置,便于使用 PostgreSQL、Redis 和 MinIO 自托管。

适用场景

  • 把需要跨设备持续推进的多步骤个人或办公事务交给智能体处理。
  • 监控收件箱或代码仓库,仅在有变化时让智能体介入。
  • 使用自己的模型服务密钥,部署一个自托管的个人智能体。
  • 在统一的任务看板中调度 Claude Code 等现有编码智能体。

快速上手

  1. 1

    复制示例配置

    cp .env.example .env
  2. 2

    在 .env 中设置 COMMA_OWNER_EMAIL 和模型提供商

  3. 3

    构建并启动 Docker Compose 服务栈

    docker compose up -d --build
  4. 4

    打开 http://localhost:8080 请求登录验证码,并在 http://localhost:8025 查看验证码

使用前须知

  • 自托管需要 Docker Compose v2.24 或更高版本,以及用于真实模型调用的模型提供商账户。
  • 默认服务栈不包含模拟模型,真实模型调用可能产生提供商费用。
  • AGPL-3.0 许可证要求在提供修改版服务时保持源代码可获取。
  • 部分功能(如 Group 云电脑和 Agent VMM 主机)需要本仓库未包含的额外运行时。

标签

常见问题

Comma 是什么?
开源的无会话个人 AI 智能体,把目标拆成任务并持续执行,支持 Docker Compose 自托管。 Comma 是一个个人 AI 智能体,工作围绕持久化的任务(Task)组织,而不是聊天会话。简单问题直接在聊天中回答,较大的请求则转为任务,由智能体规划、执行、复核并验证,直到目标完成。任务在“进行中”“待审核”“已完成”之间流转,需要用户决定的事项会停在待审核状态。
Comma 可以免费使用吗?用的什么许可证?
Comma 以 AGPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
Comma 还在维护吗?
活跃维护中。Comma 最近一次提交是在 2026年10月20日。
Comma 适合用来做什么?
把需要跨设备持续推进的多步骤个人或办公事务交给智能体处理。 监控收件箱或代码仓库,仅在有变化时让智能体介入。 使用自己的模型服务密钥,部署一个自托管的个人智能体。 在统一的任务看板中调度 Claude Code 等现有编码智能体。
Comma 怎么安装和运行?
复制示例配置: cp .env.example .env 在 .env 中设置 COMMA_OWNER_EMAIL 和模型提供商 构建并启动 Docker Compose 服务栈: docker compose up -d --build 打开 http://localhost:8080 请求登录验证码,并在 http://localhost:8025 查看验证码
在哪里获取 Comma?
源代码和安装说明在 GitHub 上:https://github.com/AFK-surf/Comma

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目