Мой блог
Консольный агент Oh-My-Pi: установка, адвайзеры, субагенты и память
Инструментарий разработчика пополнился консольным помощником Oh-My-Pi (OMP), предлагающим продвинутую архитектуру для работы с языковыми моделями. Проект выделяется на фоне аналогов за счет встроенной модели-рецензента и масштабируемой системы субагентов.
Консольный агент Oh-My-Pi объединяет в себе гибкие механизмы автоматизации разработки, позволяя подключать локальные и облачные языковые модели, настраивать изолированные воркеры и управлять контекстом выполнения задач прямо из терминала.





Установка и запуск
Инсталляция утилиты Oh-My-Pi выполняется с помощью нескольких стандартных команд в зависимости от используемой операционной системы. Для Linux и macOS доступен установочный скрипт через curl:
curl -fsSL https://omp.sh/install | sh
В операционной системе Windows через PowerShell применяется команда:
irm https://omp.sh/install.ps1 | iex
Альтернативным способом установки для любой платформы выступает глобальная установка через пакетный менеджер Node.js с помощью команды npm install -g @oh-my-pi/pi-coding-agent.
Запуск с локальными моделями через LiteLLM, Ollama, LM Studio или llama.cpp
Для запуска утилиты с локальными прокси-серверами и моделями применяются специальные переменные окружения. При использовании LiteLLM задается базовый адрес и при необходимости ключ API:
LITELLM_BASE_URL="http://<ip:port>/v1" LITELLM_API_KEY="ваш-ключ" omp
Для работы с Ollama используется переменная OLLAMA_BASE_URL="http://<ip:port>" omp, для LM Studio — LM_STUDIO_BASE_URL="http://<ip:port>/v1" omp, а для llama.cpp — LLAMA_CPP_BASE_URL="http://<ip:port>" omp.
Стоит учитывать формат адресов: для LM Studio обязательно указывается путь /v1, тогда как для Ollama и llama.cpp прописывается корневой адрес сервера. Параметры можно заранее зафиксировать в конфигурации или системных настройках.
Advisor: модель-рецензент для контроля действий
Одной из ключевых особенностей инструмента является подключение к сессии модуля advisor — отдельной модели, которая наблюдает за основным агентом в реальном времени. Такой подход помогает оптимизировать затраты токенов и повысить качество получаемого кода.
Советник не вносит изменения в текущую сессию напрямую. Он анализирует вывод основного исполнителя, может самостоятельно считывать файлы через специализированные инструменты и передавать в поток краткие замечания, предупреждения или строгие блокировки.

Активация советника происходит через команду \advisor. Если модель не задана явно, система задействует цепочку slow или встроенный приоритетный набор. Функция резервного рецензента позволяет автоматически переключаться на запасной вариант при сбоях или превышении лимитов.
Субагенты и распределение задач
Архитектура OMP поддерживает распределение крупных задач на изолированные воркеры через команду /agents. Каждый субъект работает в собственной рабочей среде, а результаты возвращаются в виде структурированных объектов, исключая конфликты при слиянии правок.
Интерактивный интерфейс Agent Hub, вызываемый комбинацией клавиш Alt+A или Ctrl+S, предназначен для мониторинга состояния воркеров. Панель отображает текущие статусы, затраты времени, количество запросов, а также позволяет отправлять управляющие сообщения или прерывать выполнение зависших процессов.
Агентные циклы и Vibe-mode
Система ролей распределяет нагрузку по назначению: отдельные модели отвечают за планирование, генерацию кода, создание коммитов или глубокий анализ. Настройка параметров позволяет гибко адаптировать окружение под конкретные задачи разработки.
Оркестрация через Vibe-mode
Включение специального режима превращает верхнюю сессию в оркестратора, который управляет фоновыми воркерами, не выполняя правки самостоятельно. Команда /vibe запускает процесс или принимает первую задачу, а повторный ввод отключает режим.

Инструментарий оркестратора при этом ограничивается чтением и управлением воркерами, а всю трудоемкую работу по поиску и редактированию берут на себя фоновые процессы. Для этого используются встроенные уровни исполнения с предопределенными ролями.
Управление долгосрочной памятью агента
Для сохранения контекста между сессиями в Oh-My-Pi предусмотрена настраиваемая система памяти. Функция отключается по умолчанию и активируется через конфигурационные файлы или команду /settings.
Бэкенды и фазы работы с памятью
Доступны несколько вариантов бэкендов: локальные сводки, удаленное хранилище Hindsight, а также SQLite-решение Mnemopi. Процесс обработки делится на две фазы: первичное извлечение полезных сведений из истории сессий и последующая консолидация в долгосрочные файлы документации и процедурные навыки.
Команды управления позволяют просматривать текущий инжект, диагностировать состояние бэкенда, запускать принудительную синхронизацию или очищать локальные данные сессии.
