Tracely: CI/CD инструмент для отслеживания фейлов AI агентов
Tracely — это CI/CD инструмент для отслеживания и управления фейлами AI агентов. Он позволяет автоматически превращать ошибки в производственной среде в регрессионные тесты, которые предотвращают идентичные патчи в будущем.
Главное отличие от традиционных CI/CD решений в том, что Tracely не просто фиксирует ошибки, а анализирует и группирует их, создавая замороженные случаи с возможностью воспроизведения. Это упрощает процесс тестирования, поскольку вместо ручного тестирования можно сэкономить время, используя уже задействованные фейлы как основу для новых тестов. Инструмент лучше всего подойдет командам, работающим с AI агентами, которые хотят автоматизировать и улучшить качество своих релизов.
Проект написан на Python 3.10 и выше, и можно быстро развернуть весь стек при помощи одного клика. Однако стоит помнить, что совместимость, лицензия и другие ограничения не раскрыты в README, так что стоит внимательно ознакомиться с документацией.
Проект Tracely — это инструмент для обнаружения и обработки сбоев в AI-агентах, который автоматически превращает эти сбои в регрессионные тесты. Он оценивает каждый трейс агента, группирует неудачные запуски в проблемы, замораживает их в воспроизводимые случаи и блокирует попытки внедрить их в код.
Tracely позволяет использовать фактические данные о сбоях, полученные из продакшена, вместо ручного создания тестовых наборов. Это означает, что тесты создаются на основе реальных неудачных трасс, что делает их более надежными и актуальными. Серверные API и пользовательский интерфейс разворачиваются в одном клике, и проект поддерживает интеграцию с различными языками программирования.
Установка и настройка
Чтобы быстро развернуть Tracely, необходим Docker и Docker Compose. Выполни следующие команды в терминале:
git clone https://github.com/Jwuthri/Tracely-ai && cd Tracely
docker compose --profile demo up -d --build --wait
open http://localhost:3001
Эти команды запустят ClickHouse, Postgres, Redis и MinIO, настроят приложение с начальными данными и откроют интерфейс.
Как это работает
- Наблюдение: Tracely принимает трассы через OTLP, преобразуя их в удобный для анализа формат.
- Обнаружение и классификация: Инструмент автоматически группирует одинаковые сбои, позволяя легко отслеживать проблемы.
- Тестирование: Один клик позволяет заморозить неудачную трассу как регрессионный тест.
- Развертывание и блокировка PR: Тесты выполняются в CI/CD, блокируя пулл-реквесты, если они приводят к сбоям.
- Уведомления: Пользователь может настроить оповещения о неудачных запусках через Slack, email и другие каналы.
Ограничения
В проекте используются автоматизированные механизмы, зависящие от точности трасс. Если трассы будут неполными или некорректными, это может повлиять на их репродукцию в рамках тестов. Кроме того, для полноценной работы могут понадобиться дополнительные настройки и интеграции, в зависимости от используемых технологий и среды.
Ссылки и документация
Для получения более подробной информации об установке и работе с Tracely, можно обратиться к официальной документации по следующим ссылкам:
Радар проекта: 62 из 100 — крепкий проект
- Импульс 0 ≈ 0 звёзд в месяц
- Темп разработки 79 91 коммит за 12 недель
- Зрелость 26 проекту 5 месяцев, релизов нет
- Сообщество 50 9 участников, 131 форк
- Свежесть 97 последний коммит — 5 дней назад
- Быстрый старт 100 есть: команда установки, Docker, сайт/демо, примеры
- Готовность к продакшену 30 автосборка
- Безопасность и доверие 80 лицензия MIT, SECURITY.md
- Документация 100 README 28.9 тыс. знаков, 26 разделов, папка docs
- Экосистема 61 6 подписчиков на обновления, 19 тем
Как считаем
Только открытые данные GitHub на 11.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: Jwuthri/Tracely-ai →
RepoRadar