Хватит ломать глаза об консоль: я написал интерактивный open-source граф для отладки AI-агентов на LangChain

Если вы пробовали собирать AI-агентов, кастомных чат-ботов или сложные RAG-системы на фреймворке LangChain, то точно знаете главную боль этой разработки — отладку.Стоит добавить в цепочку один системный промпт, вызов нейросети, выходной парсер и пару инструментов (tools) — и лог в терминале превращается в бесконечную, нечитаемую стену текста и JSON. Понять, на каком именно этапе модель сломала логику, какой точный промпт улетел в API, почему она выдала галлюцинацию или где споткнулся парсер — задача, требующая крепких нервов.Мне надоело бесконечно скроллить консоль и выискивать ошибки в тоннах текста. Поэтому я написалZengin AI Debugger— легковесную утилиту, которая перехватывает шаги ИИ-агента и превращает их в красивый интерактивный граф прямо в браузере в реальном времени.Как это устроено и почему это удобно Идея простая: инструмент работает полностью локально, не требует облачных подписок и не отправляет ваши промпты на сторонние сервера. Система состоит из двух частей:

Плагин-перехватчик — незаметно встраивается в ваш проект, слушает родные события LangChain и мгновенно отправляет данные через веб-сокеты.
Интерактивный дашборд — работает на движках React и ReactFlow. Он принимает данные от вашего скрипта и «на лету» рисует связи между блоками.

Как строится процесс работы Интеграция занимает буквально минуту — достаточно установить визуальный дашборд через менеджер пакетов Node.js (npm), поставить библиотеку в свой Python-проект черезpipи передать специальный маркер (колбэк) в настройки запуска вашей нейросетевой цепочки.Никакую внутреннюю логику самого агента, архитектуру или системные промпты переписывать не нужно.Ваш привычный процесс разработки теперь выглядит так:

Вы запускаете локальный дашборд одной командой в терминале. В браузере открывается чистый холст.
Вы запускаете своего ИИ-агента.
На холсте в браузере сами собой начинают появляться и связываться стрелочками блоки: вот узел промпта, вот блок вызова GPT-4 или локальной Ollama, а вот финальный парсер.
Вы кликаете на любой блок, и справа открывается аккуратная боковая панель. В ней четко видно: какой точный текст пришел на вход этому узлу (Input) и что именно он выдал на выходе (Output).
Нашли ошибку в промпте? Исправили в коде, нажали кнопку «Очистить экран» на холсте и запустили заново. Больше никакого текстового мусора в консоли.

Для тех, кто не любит лишние вкладки, я дополнительно упаковал интерфейс в Chrome-расширение. Его можно закрепить в панели браузера и открывать визуальный дебаггер в один клик.Полный Open-Source и планы развитияПроект полностью бесплатный, открытый и распространяется под лицензиейLGPL-2.1. Изначально я создавал эту утилиту исключительно для себя, чтобы ускорить тестирование локальных моделей. Но в итоге решил упаковать её в полноценные npm и pypi пакеты, так как простых, легковесных альтернатив без привязки к тяжелым и платным облачным платформам (вроде LangSmith) на рынке просто нет.Сейчас проект активно развивается. В ближайших планах:

Полноценная поддержка сложных ветвлений и циклов в LangGraph.
Экспорт получившегося визуального графа в JSON-файл, чтобы логом ошибки можно было быстро поделиться с коллегами.
Интеграция с другими популярными ИИ-фреймворками (например, LlamaIndex).

🎯 Просьба к ИИ-сообществуЯ попытался добавить инструмент в официальный глобальный список полезных утилитAwesome LangChain. Однако их автоматический бот-модератор мгновенно отклонил пул-реквест. Причина простая: репозиторий проекта совсем новый и еще не успел набрать «тягу» (traction) в виде звездочек от реальных пользователей на GitHub. По правилам списка, совсем «свежие» проекты туда не пускают.Если инструмент кажется вам полезным, вы часто работаете с ИИ и хотите поддержать локальный open-source — загляните на страницу проекта и поставьте репозиторию звёздочку ⭐. Это очень поможет продвинуть утилиту в глобальном сообществе и пройти модерацию!

🔗 GitHub (исходный код и документация): https://github.com/zengin0201/AI_Debuggerhttps://github.com/zengin0201/AI_Debugger
📦 Страница пакета на PyPI: pypi.org/project/zengin-ai-debugger
📦 Страница пакета на NPM: https://www.npmjs.com/package/zengin-ai-debuggerhttps://www.npmjs.com/package/zengin-ai-debugger

Буду искренне рад вашей критике, предложениям по улучшению интерфейса и идеям по развитию функционала в комментариях!