Paperclip
Open-source платформа управления командой AI-агентов: задачи, пайплайны, проекты, ретро - но не для людей, а для роя агентов внутри вашей инфраструктуры. Развернули self-hosted, прошли онбординг и замерили ресурсы стека.
Вердикт
- командам, которые уже запустили нескольких AI-агентов и им нужна общая доска: задачи, статусы, пайплайны, история решений
- тем, кому важно держать логи и данные агентов на своем сервере, а не отдавать в чужое облако
- кто хочет ранний, но живой взгляд на AgentOps как отдельный слой: не runtime и не фреймворк, а система координации
- одному разработчику с одним агентом: онбординг требует компании, команды, ролей - лишняя форма ради одной задачи
- если нужен именно runtime-фреймворк (LangGraph, CrewAI, AutoGen) - у Paperclip другой слой ответственности
- кому нужен зрелый продукт с продовыми интеграциями - проекту меньше полугода на момент обзора
Зачем это в наборе AI-инфраструктуры
Self-hosted стек для работы с AI-агентами собирают многие: свои модели за прокси, оркестрация задач, память, наблюдаемость. В этой картине легко найти runtime-слой (LangGraph, CrewAI, свои узлы) и легко найти LLM-провайдера. Тяжелее с тем, что посередине: где ставить задачи агентам, где хранить их историю, где отслеживать, какая задача была передана какому агенту и что из этого вышло. Paperclip претендует именно на этот слой - доска задач и проектов для команды агентов.
Что это и какую задачу решает
Paperclip - платформа для координации команд AI-агентов внутри компании. Вы создаете организацию, добавляете агентов (как участников), заводите проекты, задачи, пайплайны и правила эскалации. Каждый агент видит только то, что относится к его роли; задачи маршрутизируются между агентами и людьми; вся история хранится в системе. По сути это трекер задач и проектов, только основные исполнители не люди, а автономные ИИ-агенты.
Проект молодой: первая публикация - март 2026 года, версии в схеме CalVer (v2026.817.0 на момент обзора). Стоит компания paperclip.ing. Ядро под MIT: клонируешь монорепу, поднимаешь docker compose, получаешь standalone-инстанс. Дистрибутив содержит сервер (Node.js/pnpm-моно) и PostgreSQL 17; UI - React, авторизация - Better Auth с локальной базой.
За лето стек заметно вырос. В монорепе появились MCP-серверы и адаптеры-плагины (агенты ходят во внешние инструменты), каталог скиллов (create-agent, планы в задачи, доска, память) и teams-catalog для сборки команд. Из простой доски задач Paperclip дозревает в полноценный control-plane для команд агентов - за что и держится в GitHub Trending с 78 тысячами звезд. Мы перепроверили установку на свежей версии: карта в маркетплейсе собирает актуальный релиз и поднимается чисто.
Чем отличается от соседних решений
У Paperclip нет прямого коммерческого аналога - категория молодая. Сравниваем по соседним нишам.
| Параметр | Paperclip | Трекер задач для людей | LangGraph/CrewAI |
|---|---|---|---|
| Основной исполнитель | AI-агент как участник | человек | функция/узел в графе |
| Модель цены | бесплатно, MIT | подписка | бесплатно |
| Self-hosted | да | ограниченно | да, как библиотека |
| Задачи и статусы | да, встроено | да | нет, только runtime |
| Логи и история решений | да, единая доска | только через интеграции | надо строить самому |
| Зрелость / экосистема | меньше полугода | годы на рынке | сформировалась в 2024-2025 |
Тех-стек и первый экран
Дистрибутив идет монорепой на pnpm. В docker/ лежит один docker-compose.yml: сервис server (мультистейдж Node.js Dockerfile) и db на PostgreSQL 17-alpine. Никакого ClickHouse, никакого Redis, никакого worker-контейнера - вся оркестрация задач и очередей внутри одного Node-процесса. По дефолту compose публикует порты 3100 и 5432 на 0.0.0.0 - при выкладке наружу привязываем их к 127.0.0.1, дальше через реверс-прокси.
Минимальная конфигурация
Реальные требования против того, что просит сам продукт.
| Реально в простое (наш замер) | ~811 MiB на 3 контейнера |
| server (Node.js) | ~525 MiB |
| postgres 17 | ~56 MiB |
| Образ приложения на диске | ~5.11 GB |
| Docker build cache | ~8.8 GB (первая сборка) |
| Тариф Fatmetal | CPU4-RAM8-DISK100 |
По памяти в простое - удобный уровень (сравнимо с Twenty CRM, легче Dittofeed). А вот образ 5.11 GB и build cache 8.8 GB - типичная плата за pnpm-монорепу с UI-бандлом Vite. На диске это чувствуется - минимальный DISK50 не берите, есть риск упереться при первой сборке.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация: CPU4-RAM8-DISK100
Развертывание на Fatmetal
Fatmetal Cloud Server (CPU4-RAM8) + Ubuntu 24.04 + Docker из маркетплейса, наружу через Caddy с TLS.
Взять VM с предустановленным Docker
Marketplace-приложение Docker уже кладет Docker 29.6.1 и Compose v5.3.0. Сразу же поставили swap 4 GB - страховка на первую сборку, чтобы Node.js pnpm build при пике не уперся в 8 GB RAM.
Клонировать репозиторий и собрать
git clone --depth 1 https://github.com/paperclipai/paperclip.git /opt/paperclip cd /opt/paperclip/docker # порты 3100 и 5432 - привязать к 127.0.0.1 # .env: BETTER_AUTH_SECRET (openssl rand -hex 32) + PAPERCLIP_PUBLIC_URL docker compose build docker compose up -dСобранный образ - 5.11 GB, сборка заняла около 5 минут (pnpm install 30 s, Vite UI build 27 s, plugin-sdk 12 s, tsc + docker export 90 s).
Реверс-прокси и TLS
paperclip.fatmetal.net { reverse_proxy 127.0.0.1:3100 }Caddy 2.11.4 из репозитория Cloudsmith. Сертификат Let's Encrypt по HTTP-01 выпускается сам при первом внешнем запросе. Никаких дополнительных ходов.
Заклаймить инстанс и завести компанию
Первый вход не пускает в UI:
/onboardсообщает, что администратор еще не заклаймлен. Регистрируешься в/auth, жмешь «Claim this instance» - открывается онбординг-визард с обязательной первой компанией.
Что измерили после запуска
Цифры со свежей установки на нашем сервере, без нагрузки.
| RAM в простое (всего, 3 контейнера) | ~811 MiB |
| server (Node.js) | ~525 MiB |
| postgres 17 | ~56 MiB |
| Образ приложения | 5.11 GB |
| Health-check внутренний (HTTP 127.0.0.1:3100) | 35 ms |
| Health-check внешний (HTTPS через Caddy) | 61-92 ms |
| Время старта после docker compose up | несколько секунд до healthy |
Приятная деталь: сервер по умолчанию включает автоматические PG-бэкапы (retention 7 дней), heartbeat 30 s и делает миграции сам. Никаких отдельных cron, sidecars и «не забудьте поднять бэкап».
Проверено на версии v2026.817.0 - заказ-тест карты 17 августа 2026. Проект молодой, релизы почти ежедневные - на новых версиях цифры могут заметно отличаться.
Что чувствуешь, когда разворачиваешь это
Paperclip оставляет двойное впечатление. Первое - «до боли простой стек»: три контейнера, одна база, один Node-процесс, ни одного лишнего сервиса. По современным меркам self-hosted AI-инструментов это редкость - обычно вокруг агентов сразу вырастает Redis, Temporal, векторное хранилище и брокер сообщений. Здесь всего три контейнера, и это не выглядит недоработкой, а выглядит выбором.
Второе - «онбординг сделан для команды, а не для одиночки». Ни в одну рабочую сцену продукт не пускает без создания компании и первой роли. Внутри все через сущность организации: агенты - ее участники, задачи - ее задачи, проекты - ее проекты. Если вы хотите просто запустить одного агента и пощупать - это не сюда. Если вы уже дошли до состояния, когда у вас есть несколько агентов и хочется общей доски - модель ощущается родной.
Третье - «продукт молодой, и это видно». Часть онбординг-визарда после первого шага проходится не с первой попытки: обязательные поля не всегда очевидны, часть визуальных состояний еще сыровата. Но при этом ядро уже работает: инстанс поднимается, база мигрируется, авторизация уверенная, health возвращает адекватный статус. Ощущение, будто наблюдаешь категорию AgentOps в самой ранней стадии - когда еще не понятно, кто из игроков вырастет, но уже понятно, что слой нужен.
Где может сломаться
Что стоит учитывать до запуска на реальном проекте.
Порты по умолчанию наружу. Compose из репозитория публикует 3100 и 5432 на 0.0.0.0. Прод-выкладка без замены на 127.0.0.1 откроет базу интернету - обязательно правьте до первого up.
BETTER_AUTH_SECRET. В стандартном .env стоит слабый или пустой секрет. Сгенерируйте свой (openssl rand -hex 32) до старта, иначе будете переизлачивать пользователей.
Сборка на 8 GB RAM. Node.js-монорепа с Vite UI при пиковой сборке может съесть до 6-7 GB. На стандартной VM CPU4-RAM8 это идет впритык - страхуемся 4 GB swap заранее, чтобы не поймать OOM в середине tsc.
Без компании внутрь workspace не пускают. Онбординг-визард обязателен. Автоматизировать flow первого запуска в headless-скрипте нужно осознанно; глазами - минута работы.
Когда это НЕ ваш выбор
Если у вас один агент и вы им играете - Paperclip будет избыточен: онбординг требует компании, команды, ролей, и все внутри строится через организацию. Заведете лишние сущности ради одной задачи - через две недели забросите.
Если ищете runtime-фреймворк для запуска LLM-цепочек - это другой слой. LangGraph, CrewAI, AutoGen работают ниже: они собирают из инструментов и промптов работающего агента. Paperclip не запускает LLM-цепочки, а координирует то, что уже запускается снаружи.
Если нужен зрелый продукт с продовыми интеграциями и SLA - категория AgentOps только оформляется, а Paperclip меньше полугода на рынке. Для критичного внешнего сервиса пока рано; для внутренней agent-команды или R&D-контура - самое время посмотреть.
Безопасность и обновления
Проект живет релизами в схеме CalVer: v2026.817.0 в момент обзора, релизы выходят почти ежедневно (CalVer). Продукт молодой - при обновлениях полагайтесь на full-clone-approach: git fetch, тест на staging, docker compose build --no-cache. Автоматических миграций схемы данных сервер делает сам при старте, но откатов из коробки нет - до обновления сделайте руками snapshot базы или воспользуйтесь встроенным backup-каталогом.
Порты не открывайте наружу вообще. Все внешнее - через Caddy или Traefik с TLS. База - на 127.0.0.1. Auth-стек Better Auth хранит сессии и пароли в той же Postgres - при бэкапе базы бэкапите и credentials.
Связь с другими стеками
- Runtime агентов - LangGraph, CrewAI, AutoGen: живут ниже Paperclip; сам Paperclip не запускает LLM-цепочку, а координирует то, что запускается снаружи.
- Наблюдаемость - Langfuse, Helicone: смотрят трассы вызовов моделей; Paperclip смотрит на «задачи и решения», это перпендикулярные слои.
- Реверс-прокси - Caddy или Traefik для TLS и домена; ставим отдельно и держим сам продукт закрытым за ним.
Частые вопросы
Сколько Paperclip ест в простое?
Около 811 MiB на 3 контейнерах: server (Node.js) ~525 MiB и postgres 17 ~56 MiB.
На чем написан?
Node.js/TypeScript в pnpm-монорепе, React-фронтенд, PostgreSQL 17, авторизация - Better Auth. Никакого Redis и очередей.
Это правда бесплатно?
Да, ядро под MIT-лицензией. За продуктом стоит компания paperclip.ing, но клонируешь monorepo - и получаешь самостоятельный инстанс.
Он сам запускает моих агентов?
Нет. Paperclip - это слой координации: задачи, статусы, пайплайны, история. Сам запуск ИИ-цепочек живет в вашем runtime (LangGraph, CrewAI, свой код).
Что нужно для запуска?
Docker + docker compose, ~10 GB места на диске под сборку, 4-8 GB RAM. Для внешнего доступа - реверс-прокси с TLS.
Какая версия у вас?
v2026.817.0, single-tenant, за Caddy с TLS. Проект живет в CalVer-схеме, релизы регулярные.
На проде стоит ставить?
С оговоркой «продукт молодой». Для внутренней agent-команды или R&D-контура - вполне; для критичной внешней услуги пока рано - категория AgentOps только формируется.
Итог
Paperclip - ранний, но живой self-hosted подход к слою AgentOps: платформа для координации команды AI-агентов, где каждая задача проходит через доску, а не растворяется в чатах и файлах. Стек аккуратный - три контейнера, одна база, честный Node.js без лишнего. Модель работы - не «одиночный агент», а «команда агентов внутри организации». Для тех, кто уже пришел к нескольким агентам и хочет системный взгляд - подходящий стартовый инструмент; для одиночного эксперимента - избыточен. Развернуто на Fatmetal Cloud Server за Caddy с TLS.
Стек развернут на тарифе CPU4-RAM8-DISK100 за Caddy с TLS. Замечания и уточнения по гайду - напишите, поправим.