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-разработчики, работающие в терминале
ℹ Популярность проекта
По данным сентября 2026 года, репозиторий earendil-works/pi набрал более 105 000 звёзд на GitHub и имеет свыше 13 200 форков — один из наиболее популярных open-source coding agents в мире.

Архитектура: четыре пакета, одна цель

Проект состоит из четырёх ключевых пакетов:

  • 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!");
💡 Быстрый запуск через npx

Установка и запуск 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 и др.)Бесплатно
📝 Экономия на токенах
Благодаря минималистичному системному промпту (~200 токенов против ~10 000 у Claude Code), при использовании Claude Opus 4.7 ($5.00/M входных токенов) разница обходится примерно в $0.049 за сессию только на системный промпт. При 200 сессиях в месяц — около $10 чистой экономии только на системных промптах.

Плюсы и минусы

✅ Плюсы❌ Минусы
Полностью бесплатен (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, выделяясь минималистичной философией и независимостью от конкретной модели.

ПараметрPiClaude CodeAider
ЛицензияMIT (бесплатно)ПроприетарныйMIT (бесплатно)
Провайдеры LLM20+Только Anthropic20+
Системный промпт~200 токенов~10 000 токеновПеременный
Встроенных инструментов410+Пара-программист
GUI/IDE интеграцияНет (TUI)VS Code extensionНет
Sub-agents / Plan modeЧерез расширенияВстроеноЧерез architect mode
Sandbox/разрешенияНет (опционально)ВстроеноНет
РасширяемостьTypeScript ExtensionsMCP / плагиныЧастичная
Подходит дляPower users, OSSАвтономные задачиПарное программирование

По мнению независимых ревьюеров, Pi является более дешёвым, гибким и прозрачным инструментом — особенно если вы платите за токены, переключаетесь между моделями или хотите полного контроля.

Claude Code транслирует философию «инструмент для каждого инженера» — batteries-included, доступный на всех уровнях. Pi придерживается принципа «если мне это не нужно, это не будет встроено» — минимальный, самодостаточный, заточенный под workflow конкретного разработчика.

⚠ Важно про безопасность
Pi по умолчанию работает в YOLO-режиме: без разрешений, без sandbox. Перед запуском в продакшн-окружениях или с доступом к чувствительным данным обязательно настройте контейнеризацию (Docker, Gondolin или OpenShell).

Вердикт

Pi (earendil-works/pi) — это инструмент для тех, кто хочет понимать и контролировать каждый шаг работы агента. Философия радикального минимализма означает, что по умолчанию модель получает небольшой набор инструментов — read, write, edit, bash — а всё остальное реализуется через расширения. Это делает agent loop быстрым, контекст чистым, а поведение — полностью подконтрольным.

Pi — лучший выбор, если вы хотите полного контроля над агентом, используете несколько LLM-провайдеров и готовы выстраивать собственные рабочие процессы.

Если вы хотите минималистичный инструмент, который можно действительно понять — Pi для вас.

Рейтинг: 8.5 / 10

КритерийОценка
Гибкость и провайдеры⭐⭐⭐⭐⭐
Экономичность (токены/цена)⭐⭐⭐⭐⭐
Расширяемость⭐⭐⭐⭐☆
Простота входа⭐⭐⭐☆☆
Безопасность из коробки⭐⭐☆☆☆
Экосистема и документация⭐⭐⭐⭐☆

Кому подойдёт:

  • 🟢 Senior-разработчикам и OSS-контрибьюторам
  • 🟢 Тем, кто хочет BYOK и независимость от вендора
  • 🟢 Командам, строящим собственные AI-пайплайны
  • 🔴 Новичкам, которым нужен «работающий из коробки» агент с GUI
  • 🔴 Проектам, где критична встроенная система безопасности