Repolode
AFK-surf

AFK-surf/Comma

Открытый персональный AI-агент без сессий: превращает цели в Tasks и продолжает работать над ними на разных устройствах; можно развернуть самостоятельно через Docker Compose.

Звёзды
329
Форки
22
Открытые issues
1
Последний коммит
позавчера

Что это?

Comma — персональный AI-агент, который организует работу вокруг постоянных Tasks, а не чатов. На быстрый вопрос он отвечает в чате, а более крупные запросы превращает в Tasks: планирует и выполняет их, проверяет результат, пока цель не будет достигнута. Tasks проходят этапы In progress, Needs Review и Done; решения, которые должен принять пользователь, остаются на этапе Needs Review.

Агент может запускать повторяющиеся наблюдатели Loops, которые следят за почтовым ящиком, репозиторием или лентой и обращаются к модели, только когда требуется внимание. На Mac компонент Salix может читать локальные файлы, а если это разрешено — изменять файлы, выполнять команды или передавать работу таким инструментам, как Codex и Claude Code. Для доступа к моделям можно использовать собственный API key или подписку ChatGPT либо Claude.

Бэкенд в основном написан на Elixir/OTP; каждый агент работает как отдельный процесс. В репозитории также есть модели TLA+ и проверенные с помощью Lean свойства среды выполнения. Хостинг доступен на comma.surf, а в репозитории есть конфигурация Docker Compose для запуска односерверного экземпляра с PostgreSQL, Redis, MinIO и ClickHouse.

Ключевые возможности

  • 01Превращает крупные запросы в Tasks, которые планируются, выполняются и проверяются до завершения.
  • 02Запускает Loops для наблюдения за почтовыми ящиками, репозиториями или лентами и пробуждает агента только при необходимости.
  • 03Подключает Mac через Salix, чтобы читать локальные файлы и, с разрешения пользователя, выполнять команды.
  • 04Может вызывать Codex, Claude Code и других агентов в роли Workers или Sub-agents.
  • 05Предоставляет конфигурацию Docker Compose для самостоятельного хостинга с PostgreSQL, Redis и MinIO.

Сценарии использования

  • Поручать многоэтапные личные или рабочие дела, выполнение которых должно продолжаться на разных устройствах.
  • Следить за почтовым ящиком или репозиторием и запускать действия агента только при изменениях.
  • Развернуть личного агента на собственном сервере, используя ключ API своего провайдера моделей.
  • Управлять существующими агентами для написания кода, например Claude Code, с общей доски задач.

Быстрый старт

  1. 1

    Скопируйте пример конфигурации

    cp .env.example .env
  2. 2

    Укажите COMMA_OWNER_EMAIL и своего провайдера моделей в .env

  3. 3

    Соберите и запустите стек Docker Compose

    docker compose up -d --build
  4. 4

    Откройте http://localhost:8080, запросите код для входа и получите его на http://localhost:8025

Что важно знать

  • Для самостоятельного размещения требуется Docker Compose версии 2.24 или новее и аккаунт у провайдера моделей для реальных запросов к модели.
  • В стандартный стек не входит имитационная модель, поэтому реальные запросы к модели могут повлечь оплату услуг провайдера.
  • Лицензия AGPL-3.0 требует сохранять исходный код доступным, если вы предоставляете изменённую версию.
  • Для некоторых функций, например облачных компьютеров Group и хостов Agent VMM, нужны дополнительные среды выполнения, которых нет в этом репозитории.

В подборках

Темы

Частые вопросы

Что такое Comma?
Открытый персональный AI-агент без сессий: превращает цели в Tasks и продолжает работать над ними на разных устройствах; можно развернуть самостоятельно через Docker Compose. Comma — персональный AI-агент, который организует работу вокруг постоянных Tasks, а не чатов. На быстрый вопрос он отвечает в чате, а более крупные запросы превращает в Tasks: планирует и выполняет их, проверяет результат, пока цель не будет достигнута. Tasks проходят этапы In progress, Needs Review и Done; решения, которые должен принять пользователь, остаются на этапе Needs Review.
Comma можно использовать бесплатно? Какая у него лицензия?
Comma распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
Comma всё ещё поддерживается?
Активно поддерживается. Последний коммит в Comma — 20 окт. 2026 г..
Для чего можно использовать Comma?
Поручать многоэтапные личные или рабочие дела, выполнение которых должно продолжаться на разных устройствах. Следить за почтовым ящиком или репозиторием и запускать действия агента только при изменениях. Развернуть личного агента на собственном сервере, используя ключ API своего провайдера моделей. Управлять существующими агентами для написания кода, например Claude Code, с общей доски задач.
Как установить Comma?
Скопируйте пример конфигурации: cp .env.example .env Укажите COMMA_OWNER_EMAIL и своего провайдера моделей в .env Соберите и запустите стек Docker Compose: docker compose up -d --build Откройте http://localhost:8080, запросите код для входа и получите его на http://localhost:8025
Где скачать Comma?
Исходный код и инструкции по установке — на GitHub: https://github.com/AFK-surf/Comma

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Локально-ориентированная AI-среда для общения с несколькими агентами, работы coding-агентов и визуальных сценариев — в виде десктопного приложения или собственного веб-консоли.

11,5 тыс.1,4 тыс.TypeScriptOtherОбновлён 2 часа назад