{"title":"Pi — не «ещё один кодинг-агент», а рабочий набор для тех, кто устал от беспомощных ассистентов","url":"https://verapointmedia.com/tools/earendil-works-pi/","markdownUrl":"https://verapointmedia.com/tools/earendil-works-pi.md","language":"ru","category":"tools","publishedAt":"2026-05-24T17:00:03.000Z","updatedAt":"2026-05-24T17:00:03.000Z","references":["https://github.com/earendil-works/pi","https://pi.dev","https://discord.com/invite/3cU7Bz4UPx","https://img.shields.io/badge/discord-community-5865F2?style=flat-square&logo=discord&logoColor=white"],"rights":"Public user-requested reading, summarization and citation allowed. Model training requires separate permission.","contentMarkdown":"# Pi — не «ещё один кодинг-агент», а рабочий набор для тех, кто устал от беспомощных ассистентов\n\n- Site: VeraPoint News\n- Section: Инструменты\n- Date: 2026-05-24\n- Canonical: https://verapointmedia.com/tools/earendil-works-pi/\n- Markdown: https://verapointmedia.com/tools/earendil-works-pi.md\n- Summary: Pi — это набор инструментов (TypeScript) для создания и запуска агентов: CLI-агент для кодинга, ядро агентов с управлением состоянием и единый API для LLM.\n- SEO title: Pi: карта проекта и анализ кода для AI-ассистента\n- SEO description: Pi — это набор инструментов (TypeScript) для создания и запуска агентов: CLI-агент для кодинга, ядро агентов с управлением состоянием и единый API для LLM\n- Target queries: Pi; Pi github; что такое Pi; как использовать Pi\n- Tags: #agents #coding #typescript #toolkit #opensource #automation\n- Image: https://verapointmedia.com/static/content-assets/tools/earendil-works-pi/cover.webp\n\n## Sources\n\n- https://github.com/earendil-works/pi\n- https://pi.dev\n- https://discord.com/invite/3cU7Bz4UPx\n- https://img.shields.io/badge/discord-community-5865F2?style=flat-square&logo=discord&logoColor=white\n\n---\n\nPi — https://github.com/earendil-works/pi — это не готовый продукт с кнопкой «запустить», а набор инструментов для разработчиков, которые хотят собрать своего умного агента для кодинга, чат-бота или рабочего процесса. Основное ядро — это три пакета: единый API для моделей (OpenAI, Anthropic, Google), рантайм для управления состоянием и вызова инструментов (tool calling) и интерактивный CLI-агент для кодинга. Проще говоря, это конструктор, чтобы не писать всё с нуля.\n\n## Если просто\n\nВы помните ощущение, когда просите ChatGPT написать скрипт, а он предлагает код, который не запускается? Или когда нужно попросить модель поработать с файлами, прочитать лог, попробовать запустить команду, понять ошибку и исправить — и всё это в одной сессии? В одиночку обычный чат с ИИ на это не способен. Нужен *агент* — программа, которая умеет управлять этим диалогом, вызывать реальные инструменты (терминал, редактор, API) и помнить, что уже сделала.\n\nPi даёт готовые кирпичики для такого агента. Самый простой способ почувствовать — это их CLI-агент для кодинга. Устанавливаешь одну команду, говоришь «сделай мне простой HTTP-сервер на Node.js», и он не просто выдаст код, а создаст файлы, проверит, что они компилируются, и даже предложит запустить. Всё в интерактивном режиме, прямо в терминале.\n\n## Что это решает\n\nГлавная боль — это разрозненность. Чтобы собрать рабочего агента сегодня, нужно: 1) выбрать провайдера LLM и написать к нему обёртку, 2) придумать, как управлять состоянием разговора и инструментами, 3) сделать интерфейс (CLI, веб, Slack). Каждый шаг — это куча кода и потенциальных багов. Pi упаковывает первый и второй пункты в готовые, протестированные библиотеки. А третий — даёт заготовки: CLI-агент уже есть, TUI-библиотека для терминальных интерфейсов — тоже, Slack-бот вынесен в отдельный репозиторий.\n\nДля разработчика это значит, что можно сосредоточиться на логике своего агента («что он должен делать»), а не на инфраструктуре («как ему работать с Anthropic и где хранить историю»).\n\n## Как попробовать\n\nСамый быстрый старт — через их готовый CLI-агент для кодинга. Устанавливается через npm (нужен Node.js 18+):\n\n```bash\nnpm install -g @earendil-works/pi-coding-agent\n```\n\nПосле установки вводишь `pi` в терминале. Тебе предложат настроить API-ключи для моделей (можно начать с OpenAI). Дальше можно прямо в интерактивном режиме давать задачи. Например, перейди в пустую директорию и скажи:\n\n```\npi: создай простой скрипт на Python, который читает CSV-файл и выводит первые 5 строк\n```\n\nАгент создаст файл, проверит его синтаксис и предложит следующий шаг. Это не магия, а демонстрация того, как работает связка «модель + инструменты (создание файлов, запуск команд) + управление диалогом».\n\nЧтобы собрать что-то своё на основе их библиотек, придётся зайти в репозиторий и покопаться в `packages/`. Но для первого знакомства CLI достаточно.\n\n## 3 сценария с примерами\n\n**1. Автоматизация рутинного рефакторинга.** Допустим, у вас в проекте десятки старых JS-файлов, которые нужно переписать на TypeScript с определёнными правилами (типы интерфейсов, никаких `any`). Вместо того чтобы делать это вручную или писать одноразовый скрипт, вы можете настроить агента на основе `pi-agent-core`. Вы даёте ему задание: «Просканируй папку `src/`, найди все `.js` файлы, конвертируй их в `.ts`, добавь явные типы для аргументов функций и экспортов». Агент будет поочерёдно брать файлы, использовать LLM для трансформации кода, запускать `tsc` для проверки и фиксировать ошибки, пока файл не станет валидным. Вся сессия (что сделал, какие ошибки возникли, как исправил) будет записана и её можно проанализировать.\n\n**2. Интерактивный помощник для исследования багов.** Представьте, что в логах продакшена появилась странная ошибка «Cannot read property 'x' of undefined». Вы копируете кусок лога и контекст кода, а затем в терминале запускаете своего агента (на базе того же CLI, но кастомизированного) с командой: `pi-debug --log \"...\" --file src/app.js`. Агент проанализирует лог, найдёт в коде потенциальные места, где могла возникнуть ошибка, предложит несколько гипотез, а затем — самое главное — сможет запустить тесты для этих гипотез или даже сгенерировать и применить патч, чтобы посмотреть, исчезнет ли ошибка. Это как пара программистов, сидящих у одного терминала.\n\n**3. Создание чат-бота с доступом к внутренним API.** Ваша команда использует Slack. Нужно, чтобы бот по запросу `/deploy-status` брал данные из трёх разных внутренних API (GitHub, Kubernetes, мониторинга), сводил их воедино и выдавал сводку в канал. Вместо того чтобы городить сложный бэкенд, вы берёте `pi-agent-core` (для логики агента) и `pi-ai` (для работы с LLM, которая поможет сформулировать ответ). Вы описываете доступные инструменты (функции для вызова тех самых API), а LLM сама решает, в каком порядке их вызывать и как интерпретировать результаты. Бот становится «умным»: на вопрос «что сломано в продакшене?» он не просто даст сырые логи, а проанализирует их и предложит гипотезу.\n\n## Где можно застрять\n\nВо-первых, это не no-code решение. Чтобы собрать своего агента, нужны базовые навыки программирования на TypeScript/JavaScript и понимание, как работают LLM API. Готовый CLI — лишь верхушка айсберга.\n\nВо-вторых, проект серьёзно относится к безопасности цепочки поставок (supply-chain hardening). Это хорошо, но это означает, что установка зависимостей (`npm install`) может быть чуть менее гибкой, а некоторые скрипты блокируются флагом `--ignore-scripts`. Для новичка это может быть неочевидно, если что-то пойдёт не так.\n\nВ-третьих, документация есть на pi.dev, но она, судя по всему, в процессе развития. Авторы честно пишут: «вы можете прочитать документацию, но также можете просто спросить агента, и он сам объяснит». Звучит круто, пока агент не запутается в собственном устройстве.\n\nИ главное: это всё ещё активно развивающийся проект. Новые issues и PR от новых контрибьюторов по умолчанию автоматически закрываются (модераторы потом их просматривают). С одной стороны, это защита от спама, с другой — барьер для тех, кто хочет помочь или задать вопрос через GitHub.\n\n## Кому это нужно\n\n1.  **Разработчикам, которые устали копировать код из чата в терминал.** Pi-coding-agent — это следующий шаг: не просто генерация кода, а его проверка и исполнение в изолированной среде.\n2.  **Инженерам, которые строят внутренние инструменты с ИИ.** Если вам нужен бот, который умеет работать с вашей кодобазой, API или логами, `pi-agent-core` и `pi-ai` сэкономят недели работы.\n3.  **Энтузиастам, изучающим архитектуру агентов.** Это отличный open-source пример того, как устроен рантайм для агентов, управление состоянием и вызов инструментов. Можно учиться по коду.\n\n## Кому это не нужно\n\n1.  **Пользователям, которые хотят «просто нажать кнопку и получить волшебного помощника».** Pi — это инструментарий для разработчиков, а не конечный продукт вроде Cursor или Github Copilot Chat.\n2.  **Тем, кто боится терминала и Node.js.** Установка, настройка API-ключей, работа с npm — обязательные шаги.\n3.  **Командам, у которых нет времени разбираться в сыроватых open-source решениях.** Хотя проект популярен (53k stars), он требует технических вложений. Если вам нужна стабильная, готовая коробка, возможно, стоит посмотреть на коммерческие предложения.\n\n## Вердикт Веры\n\nМне нравится прагматичный подход Pi. Это не попытка сделать самого умного агента в мире, а попытка дать нормальные, качественные инструменты тем, кто этих агентов собирает. Особенно впечатляет их акцент на безопасности зависимостей — в мире, где npm-пакеты стали вектором атак, это не паранойя, а необходимость.\n\nЧто мне не нравится — это некоторая закрытость для сообщества (авто-закрытие issues от новых людей) и то, что реальная мощь скрыта за необходимостью кодить на TypeScript. Готовый CLI — отличная игрушка, но чтобы извлечь настоящую пользу, нужно карабкаться в их mono-repo.\n\nТем не менее, если вы разработчик и вам надоело каждый раз изобретать велосипед для подключения к GPT или Anthropic, если вы хотите попробовать собра\n\n## Что читать дальше\n\n- [Все материалы про AI-агентов](/topics/ai-agents/)\n- [Что такое AI-агент простыми словами](https://verapointmedia.com/guides/chto-takoe-ai-agent-prostymi-slovami/)\n- [Все материалы про AI-инструменты](/topics/ai-tools/)\n- [Как отличить рабочий AI-инструмент от красивой демки](https://verapointmedia.com/guides/kak-otlichit-rabochiy-ai-instrument-ot-krasivoy-demki/)\n\n## Материалы\n\n- [earendil-works/pi] earendil-works/pi: https://github.com/earendil-works/pi\n- [pi.dev] supporting context: https://pi.dev\n- [discord.com] supporting context: https://discord.com/invite/3cU7Bz4UPx\n- [img.shields.io] supporting context: https://img.shields.io/badge/discord-community-5865F2?style=flat-square&logo=discord&logoColor=white\n"}