Философия и архитектура: «Адаптируй Pi под себя»
Pi позиционируется как минималистичная «harness» (основа) для агентов, которая не навязывает жестких сценариев использования, в отличие от многих монолитных решений. В отличие от конкурентов, Pi намеренно исключает из базовой поставки такие функции, как суб-агенты (sub-agents) и режим планирования (plan mode). Разработчики предлагают либо просить самого агента построить нужный функционал, либо использовать готовые Pi packages, распространяемые через npm или git.
Ключевая особенность — глубокая кастомизация через расширения, навыки (skills), шаблоны промптов и темы. Архитектура построена на модульных библиотеках, что позволяет интегрировать Pi в существующие рабочие процессы, а не перестраивать их под агента.
Технические детали и установка
Проект требует Node.js версии 22.19 или новее. Поддерживаются платформы macOS, Linux и Windows (архитектуры ARM64 и x86-64). Установка осуществляется несколькими способами:
- Стандартная: через скрипт установки
pi.dev/install.sh(Linux/macOS) или PowerShell (Windows). Установщик фиксирует все зависимости. - NPM:
npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Важно: при установке через npm транзитивные зависимости не фиксируются жестко. - Nix:
nix run github:earendil-works/pi/stable. Nix-сборки выполняются офлайн, используя зафиксированные данные моделей из каталога pi.dev.
Модульная структура (Monorepo)
Репозиторий содержит набор специализированных пакетов, каждый из которых отвечает за определенный слой функциональности:
| Пакет | Назначение |
|---|---|
@earendil-works/pi-ai |
Единый API для работы с несколькими провайдерами LLM (OpenAI, Anthropic, Google и др.) |
@earendil-works/pi-agent-core |
Ядро агента: управление состоянием и вызов инструментов (tool calling) |
@earendil-works/pi-durable |
Среда выполнения для долговременных разговоров, задач и документов |
@earendil-works/chord |
Объектная среда выполнения для приложений между процессами (хот-релог, HTTP, workers) |
@earendil-works/pi-tui |
Библиотека терминального интерфейса с дифференциальным рендерингом |
@earendil-works/pi-telemetry |
Вендор-нейтральные контракты телеметрии и тесты соответствия |
Безопасность и изоляция
По умолчанию Pi запускается с правами пользователя, запустившего процесс, и не имеет встроенной системы разрешений для ограничения доступа к файловой системе или сети. Для обеспечения безопасности разработчики рекомендуют три подхода:
- Gondolin extension: запуск аутентификации провайдера на хосте, а инструментов — в локальном микро-VM Linux.
- Plain Docker: полная изоляция процесса Pi в контейнере.
- OpenShell: запуск в песочнице с контролем политик.
Особое внимание уделено защите цепочки поставок (supply-chain hardening): прямые внешние зависимости зафиксированы по точным версиям, а package-lock.json является единственным источником истины. Коммиты, меняющие lockfile, блокируются пре-коммит хуком, если не установлен флаг PI_ALLOW_LOCKFILE_CHANGE=1.
Почему это важно
Появление Pi отражает тренд на децентрализацию и модульность в мире AI-агентов. Вместо закрытых «черных ящиков» разработчики получают инструмент, который можно собрать под конкретные задачи, интегрировать в CI/CD через RPC или TypeScript SDK, и при этом гарантировать безопасность за счет строгих правил управления зависимостями и поддержки контейнеризации. Это делает Pi привлекательным выбором для энтузиастов и профессионалов, строящих собственные AI-инфраструктуры.
Источник: Github ↗
