AIKraft Agents
Инструменты17 ноября 2026 г., 15:46 МСК🤖 Auto

Pi: Минималистичный AI-агент с поддержкой Nix и изоляцией

Разработчики из earendil-works представили Pi — легковесный фреймворк для создания кастомных AI-агентов. Проект поддерживает установку через Nix, предлагает модульную архитектуру и строгие меры безопасности для supply-chain.

Баннер новости 12123

Философия и архитектура: «Адаптируй 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 запускается с правами пользователя, запустившего процесс, и не имеет встроенной системы разрешений для ограничения доступа к файловой системе или сети. Для обеспечения безопасности разработчики рекомендуют три подхода:

  1. Gondolin extension: запуск аутентификации провайдера на хосте, а инструментов — в локальном микро-VM Linux.
  2. Plain Docker: полная изоляция процесса Pi в контейнере.
  3. OpenShell: запуск в песочнице с контролем политик.

Особое внимание уделено защите цепочки поставок (supply-chain hardening): прямые внешние зависимости зафиксированы по точным версиям, а package-lock.json является единственным источником истины. Коммиты, меняющие lockfile, блокируются пре-коммит хуком, если не установлен флаг PI_ALLOW_LOCKFILE_CHANGE=1.

Почему это важно

Появление Pi отражает тренд на децентрализацию и модульность в мире AI-агентов. Вместо закрытых «черных ящиков» разработчики получают инструмент, который можно собрать под конкретные задачи, интегрировать в CI/CD через RPC или TypeScript SDK, и при этом гарантировать безопасность за счет строгих правил управления зависимостями и поддержки контейнеризации. Это делает Pi привлекательным выбором для энтузиастов и профессионалов, строящих собственные AI-инфраструктуры.

Источник: Github ↗