Pi (earendil-works/pi): обзор AI-агента для разработчиков
Обзор Pi — минималистичного open-source AI-агента и тулкита: unified LLM API, TUI, coding agent CLI. Кому подойдёт, плюсы, минусы, сравнение с альтернативами.
Pi (earendil-works/pi): минималистичный AI-агент для разработчиков
«Adapt pi to your workflows, not the other way around» — официальный девиз проекта.
Что такое Pi и для кого он создан
Pi — это open-source, терминальный AI-агент и agent harness, созданный австрийским инженером Марио Цехнером (Mario Zechner), известным как автор игрового фреймворка libGDX. Впервые выпущенный в августе 2025 года, Pi выделяется на фоне конкурентов философией радикального минимализма: он поставляется всего с четырьмя встроенными инструментами, делегируя всё остальное системе расширений на TypeScript.
Проект опубликован под лицензией MIT компанией Earendil Inc. — venture-backed публичной корпорацией, сооснователем которой является Армин Роначер (Armin Ronacher), создатель Flask для Python.
Для кого Pi?
- Разработчики, которым нужен полный контроль над agent loop и провайдером LLM
- Команды с BYOK (Bring Your Own Key) — без привязки к одному вендору
- Исследователи и power users, строящие собственные рабочие процессы поверх агентов
- OSS-разработчики, работающие в терминале
Архитектура: четыре пакета, одна цель
Проект состоит из четырёх ключевых пакетов:
- pi-ai — unified LLM API с поддержкой множества провайдеров (Anthropic, OpenAI, Google, xAI, Groq, Cerebras, OpenRouter), стримингом, вызовом инструментов через TypeBox-схемы, поддержкой thinking/reasoning и отслеживанием токенов и стоимости.
- pi-agent-core — agent loop с выполнением инструментов, валидацией и event streaming.
- pi-tui — минималистичный TUI-фреймворк с дифференциальным рендерингом, синхронизированным выводом и компонентами вроде редакторов с автодополнением и рендеринга Markdown.
- pi-coding-agent — сам CLI, объединяющий всё вместе: управление сессиями, кастомные инструменты, темы и файлы контекста проекта.
graph TD
A[pi-ai\nUnified LLM API] --> B[pi-agent-core\nAgent Loop]
B --> C[pi-coding-agent\nCLI / Coding Agent]
D[pi-tui\nTerminal UI] --> C
C --> E[Интерактивный режим]
C --> F[Print / JSON режим]
C --> G[RPC-режим]
C --> H[SDK-режим]
Ключевые возможности
1. Unified multi-provider LLM API
Pi интегрируется с более чем 20 провайдерами, включая Anthropic, OpenAI, Google, xAI, DeepSeek, Mistral и Groq, а также поддерживает /login для Claude Pro/Max, ChatGPT Plus/Pro и GitHub Copilot вместо API-ключей.
Библиотека включает только модели, поддерживающие вызов инструментов (function calling), поскольку это принципиально для агентных сценариев. Поддерживаются также любые OpenAI-совместимые API: Ollama, vLLM, LM Studio и другие.
2. Минималистичный четырёхинструментный core
CLI поставляется с минимальным набором из четырёх инструментов: Read, Write, Edit и Bash. Саморасширяется в рантайме через TypeScript Extensions, Skills, Prompt Templates, Themes и Pi-пакеты.
3. Четыре режима работы
Pi работает в четырёх режимах: интерактивном, print или JSON, RPC для интеграции с процессами и SDK для встраивания в собственные приложения.
4. Сверхмалый системный промпт
Claude Code поставляется с системным промптом примерно в 10 000 токенов. Pi по умолчанию — около 200 токенов. Это напрямую влияет на стоимость: меньше токенов = меньше затрат на каждую сессию.
5. Управление сессиями и SQLite-бэкенд
SQLite session backend и адаптер node:sqlite вынесены в отдельный пакет @earendil-works/pi-session-backend-sqlite-node, чтобы core-пакет не тянул за собой runtime-зависимости или нативные SQLite-зависимости по умолчанию.
6. Безопасность: sandboxing на выбор
Pi не включает встроенной системы разрешений для ограничения доступа к файловой системе, процессам, сети или учётным данным. По умолчанию он работает с правами пользователя и процесса, который его запустил. Если нужны более жёсткие границы, Pi рекомендуется контейнеризировать: через Gondolin extension (micro-VM), Plain Docker или OpenShell (policy-controlled sandbox).
Пример кода: быстрый старт с агентом
import { Agent } from "@earendil-works/pi-agent-core";
import { createModels } from "@earendil-works/pi-ai";
import { anthropicProvider } from "@earendil-works/pi-ai/providers/anthropic";
const models = createModels();
models.setProvider(anthropicProvider());
const model = models.getModel("anthropic", "claude-sonnet-4-6");
const agent = new Agent({
initialState: {
systemPrompt: "You are a helpful assistant.",
model,
},
streamFn: models.streamSimple.bind(models),
});
agent.subscribe((event) => {
if (
event.type === "message_update" &&
event.assistantMessageEvent.type === "text_delta"
) {
process.stdout.write(event.assistantMessageEvent.delta);
}
});
await agent.prompt("Hello!");
Установка и запуск Pi не требуют клонирования репозитория:
npx @earendil-works/pi-coding-agent
# или сокращённо:
npx pi
Требуется Node.js >= 22.19.0.
Тарифы и цены
Публичный репозиторий Pi лицензирован под MIT. npm-пакет @earendil-works/pi-coding-agent также распространяется под лицензией MIT.
Pi сам по себе полностью бесплатен и open source. Вы платите только за доступ к LLM-провайдерам там, где это применимо, и полностью контролируете свои учётные данные и инфраструктуру.
| Компонент | Стоимость |
|---|---|
| Pi (сам тулкит) | Бесплатно (MIT) |
| LLM API (напр. Anthropic) | По тарифам провайдера |
| Claude Pro/Max через /login | $20–$200/мес (подписка Anthropic) |
| GitHub Copilot через /login | $10–$39/мес (подписка GitHub) |
| Локальные модели (Ollama и др.) | Бесплатно |
Плюсы и минусы
| ✅ Плюсы | ❌ Минусы |
|---|---|
| Полностью бесплатен (MIT) | Нет встроенного sandbox/разрешений |
| 20+ LLM-провайдеров, BYOK | Нет LSP, браузера и отладчика из коробки |
| Минималистичный системный промпт (~200 токенов) | Sub-agents и plan mode — только через расширения |
| Четыре режима работы (interactive, JSON, RPC, SDK) | Быстро развивающийся API — расширения могут устаревать |
| Расширяем через TypeScript Extensions и Skills | Требует Node.js ≥ 22.19.0 |
| Управление сессиями через SQLite | Отсутствует встроенный MCP |
| Поддержка llama.cpp и локальных моделей | Высокий порог входа для новичков |
| Активное сообщество (105k+ ⭐ на GitHub) | Нет GUI из коробки |
Сравнение с альтернативами
Pi занимает особое место в ландшафте AI coding agents 2026 года, конкурируя прежде всего с Claude Code, Cursor, Aider, OpenCode и GitHub Copilot, выделяясь минималистичной философией и независимостью от конкретной модели.
| Параметр | Pi | Claude Code | Aider |
|---|---|---|---|
| Лицензия | MIT (бесплатно) | Проприетарный | MIT (бесплатно) |
| Провайдеры LLM | 20+ | Только Anthropic | 20+ |
| Системный промпт | ~200 токенов | ~10 000 токенов | Переменный |
| Встроенных инструментов | 4 | 10+ | Пара-программист |
| GUI/IDE интеграция | Нет (TUI) | VS Code extension | Нет |
| Sub-agents / Plan mode | Через расширения | Встроено | Через architect mode |
| Sandbox/разрешения | Нет (опционально) | Встроено | Нет |
| Расширяемость | TypeScript Extensions | MCP / плагины | Частичная |
| Подходит для | Power users, OSS | Автономные задачи | Парное программирование |
По мнению независимых ревьюеров, Pi является более дешёвым, гибким и прозрачным инструментом — особенно если вы платите за токены, переключаетесь между моделями или хотите полного контроля.
Claude Code транслирует философию «инструмент для каждого инженера» — batteries-included, доступный на всех уровнях. Pi придерживается принципа «если мне это не нужно, это не будет встроено» — минимальный, самодостаточный, заточенный под workflow конкретного разработчика.
Вердикт
Pi (earendil-works/pi) — это инструмент для тех, кто хочет понимать и контролировать каждый шаг работы агента. Философия радикального минимализма означает, что по умолчанию модель получает небольшой набор инструментов — read, write, edit, bash — а всё остальное реализуется через расширения. Это делает agent loop быстрым, контекст чистым, а поведение — полностью подконтрольным.
Pi — лучший выбор, если вы хотите полного контроля над агентом, используете несколько LLM-провайдеров и готовы выстраивать собственные рабочие процессы.
Если вы хотите минималистичный инструмент, который можно действительно понять — Pi для вас.
Рейтинг: 8.5 / 10
| Критерий | Оценка |
|---|---|
| Гибкость и провайдеры | ⭐⭐⭐⭐⭐ |
| Экономичность (токены/цена) | ⭐⭐⭐⭐⭐ |
| Расширяемость | ⭐⭐⭐⭐☆ |
| Простота входа | ⭐⭐⭐☆☆ |
| Безопасность из коробки | ⭐⭐☆☆☆ |
| Экосистема и документация | ⭐⭐⭐⭐☆ |
Кому подойдёт:
- 🟢 Senior-разработчикам и OSS-контрибьюторам
- 🟢 Тем, кто хочет BYOK и независимость от вендора
- 🟢 Командам, строящим собственные AI-пайплайны
- 🔴 Новичкам, которым нужен «работающий из коробки» агент с GUI
- 🔴 Проектам, где критична встроенная система безопасности