Руководство по Oh My Pi: создаём полноценное приложение с Grok как кодовым агентом

Зачем использовать Oh My Pi?

Хорошему кодовому агенту нужны две вещи: сильная агентная модель и мощная обвязка для кодинга.

Модель обеспечивает интеллект. В этом руководстве мы используем Grok 4.6, который xAI создала для программирования, долгоживущих агентов и многошаговой работы по всему коду. Он поддерживает контекстное окно 500 тыс. токенов, ввод изображений, вызов функций, выполнение кода и веб‑поиск.

Но даже лучшая модель ограничена, если её обвязка позволяет только читать и писать текст. Чтобы работать как настоящий разработчик, модель должна уметь:

• Осматривать репозиторий и надёжно редактировать файлы
• Выполнять команды и запускать тесты
• Читать диагностику и отлаживать сбои
• Искать документацию и проверять, что её изменения действительно работают

Именно это даёт OMP: интеграция LSP, полноценный отладчик, постоянное выполнение кода, инструменты браузера и веба, интеграция с GitHub, память и параллельные субагенты. Вместе с моделью они образуют полный агентный цикл:

Планировать → исследовать → редактировать → запускать → отлаживать → тестировать → проверять

Модель решает, что делать, а OMP даёт инструменты, чтобы это сделать. И поскольку OMP поддерживает более 60 провайдеров ИИ, вы не привязаны к Grok. Тот же рабочий процесс применим, будь то Grok, Claude или другая модель.

Установка Oh My Pi

Oh My Pi — это форк open-source агента Pi, созданный Stencil Labs, и он быстро стал одним из самых популярных терминальных кодовых агентов, набрав более 34 000 звёзд на GitHub. Он рассчитан на разработчиков, которым нужен готовый к работе кодовый контур без траты времени на сборку и настройку кастомного стека агентов.

OMP работает на Linux, macOS и Windows.

На Linux или macOS выполните:

curl -fsSL https://omp.sh/install | shРаботает на

В Windows PowerShell:

irm https://omp.sh/install.ps1 | iexРаботает на

Также можно установить глобально через Bun (версии 1.3.14 и выше):

bun install -g @oh-my-pi/pi-coding-agentРаботает на

Если после установки команда omp не найдена, перезапустите терминал или проверьте вывод установщика, чтобы узнать путь установки.

Затем проверьте установку:

omp --versionРаботает на

Например:

omp/18.0.6Работает на

Если виден номер версии, OMP установлен корректно и командой omp можно пользоваться.

Настройка доступа SpaceXAI

Чтобы использовать Grok с Oh My Pi, есть два варианта.

Если вы просто тестируете модель или следуете этому гайду, рекомендуется использовать xAI API. Создайте аккаунт на https://console.x.ai/, пополните небольшой предоплаченный баланс и сгенерируйте API‑ключ. xAI списывает использование напрямую с вашего баланса, что упрощает контроль расходов.

Если вы планируете регулярно использовать Grok для кодинга, логичнее оформить подписку SuperGrok. OMP поддерживает SuperGrok напрямую через SpaceXAI OAuth, так что вы можете подключить подписку с помощью /login вместо оплаты каждого API‑запроса отдельно.

В этом руководстве мы используем метод с API, поскольку так проще тестировать и контролировать стоимость.

Создайте API‑ключ в консоли разработчика SpaceXAI и сохраните его в надёжном месте. OMP автоматически ищет переменную окружения XAI_API_KEY.

На Linux или macOS:

export XAI_API_KEY="your-xai-api-key"Работает на

Чтобы сохранить после перезапуска терминала:

echo 'export XAI_API_KEY="your-xai-api-key"' >> ~/.bashrc
source ~/.bashrcРаботает на

В Windows PowerShell:

$env:XAI_API_KEY="your-xai-api-key"Работает на

Доступные модели Grok можно посмотреть командой:

omp models xaiРаботает на

Запуск Oh My Pi с Grok

Создайте новый каталог для тестирования кодового агента:

mkdir grok-pi-demo
cd grok-pi-demoРаботает на

Инициализируйте репозиторий Git, чтобы OMP мог отслеживать свои изменения:

git initРаботает на

Теперь запустите Oh My Pi:

ompРаботает на

При первом запуске OMP может открыть короткий мастер настройки провайдеров, веб‑поиска и интерфейса. В любой момент можно запустить omp setup, чтобы открыть его снова.

Поскольку мы уже настроили переменную окружения XAI_API_KEY, повторно входить в xAI не нужно. Нажмите Esc, когда закончите настройку провайдера.

Если вместо API‑кредитов вы используете подписку SuperGrok, выберите на экране входа xAI Grok OAuth (SuperGrok или X Premium+).

Когда OMP откроется, введите:

/modelРаботает на

Выберите xAI в списке провайдеров и укажите:

grok-4.6Работает на

Чтобы вместо этого использовать более новый Grok 4.7, выберите здесь grok-4.7. Всё остальное в руководстве остаётся без изменений.

OMP также показывает полезную информацию о модели, включая контекстное окно, цены, поддержку рассуждений и возможности работы с изображениями.

Теперь у вас есть Grok внутри Oh My Pi как терминальный кодовый агент. Отсюда он может использовать встроенные инструменты OMP для просмотра файлов, модификации кода, выполнения команд, запуска тестов, отладки проблем и решения более крупных задач разработки.

Изучаем встроенные возможности Oh My Pi

Oh My Pi включает 31 встроенный инструмент и поддерживает более 60 провайдеров ИИ, поэтому большинство рабочих процессов разработки работают без установки дополнительных плагинов или MCP‑серверов.

Некоторые из самых полезных встроенных возможностей:

• Управление файлами: Чтение, создание, редактирование, поиск и структурные изменения файлов.

• Доступ к терминалу: Выполнение shell‑команд и управление процессами прямо из агента.

• Выполнение кода: Постоянные сессии Python и JavaScript.

• Интеграция LSP: Переход к определениям, поиск использований, переименование символов, просмотр диагностик и применение действий с кодом.

• Отладчик: Отладка приложений на Python, Go, C/C++ и других при помощи интеграций DAP.

• Веб‑поиск: Поиск по документации, GitHub, Stack Overflow, Reddit, реестрам пакетов, научным работам и всему вебу.

• Автоматизация браузера: Открытие и взаимодействие с сайтами через браузер на базе Chromium.

• Субагенты: Деление крупных задач разработки между несколькими агентами, работающими параллельно.

• Инструменты GitHub: Работа с репозиториями, задачами, pull‑запросами, поиском по коду и GitHub Actions.

• Память: Сохранение и восстановление полезной информации о проекте между сессиями.

• Понимание изображений: Анализ скриншотов, схем и других локальных изображений.

• Генерация изображений: Создание или редактирование изображений через поддерживаемых провайдеров ИИ.

• Синтез речи: Генерация речи с помощью xAI Grok Voice.

• Удалённые файлы: Чтение файлов на удалённых машинах через пути ssh://.

• Управление сессиями: Чекпоинты, откат, ветвление, возобновление и управление длинными сессиями агента.

• Оркестрация агентов: Ключевые слова orchestrate и workflowz в вашем промпте координируют нескольких субагентов для сложных задач.

Некоторые из этих инструментов, включая GitHub, память, генерацию изображений, синтез речи и чекпоинты, по умолчанию отключены. Их можно включить в настройках OMP.

Иными словами, модель может гораздо больше, чем просто генерировать код. Через Oh My Pi она может искать в интернете, понимать кодовую базу, редактировать файлы, выполнять команды, отлаживать ошибки, помнить контекст проекта и координировать несколько агентов из одного терминального интерфейса.

Собираем проект с Oh My Pi и Grok

Вместо проверки настройки на простом вопросе дадим полноценный проект и посмотрим, как Grok и Oh My Pi справятся с планированием, реализацией, тестированием и итерациями.

Сначала переключите OMP в режим планирования (на момент написания — /plan):

/planРаботает на

Затем введите следующий промпт:

Build a simple Hospital Management System in Python.

Use Streamlit for the web interface and SQLite for storing data. Keep the project lightweight and easy to run locally.

The app should let hospital staff register patients, add doctors, schedule appointments, admit and discharge patients, and view available beds.

Create a dashboard showing total patients, doctors, appointments, admitted patients, and available beds.

Use a clean sidebar for navigation, simple forms and tables, and realistic sample data.

Organize the Python code properly, create the database automatically, add basic validation, and make all CRUD operations work.

Install any required dependencies, run the application, test the main workflows, and fix any errors.Работает на

Проверьте план

Прежде чем писать код, Grok использовал встроенные инструменты OMP для изучения соответствующей документации, проверки актуальной информации о Streamlit и экосистеме Python, анализа требований и продумывания структуры приложения.

Затем появился подробный план реализации, разбитый на разделы. OMP делает план интерактивным: можно переходить между разделами, детальнее изучать отдельные решения и вносить изменения, прежде чем разрешить агенту работать с проектом.

Когда всё устраивает, утвердите план и позвольте Grok начать сборку.

Пусть Grok соберёт и протестирует приложение

После утверждения плана реализация оказалась на удивление прямолинейной. Grok создал структуру проекта, слой базы данных, интерфейс Streamlit, примерные данные и CRUD‑функциональность, затем установил зависимости и протестировал приложение.

На сборку и тестирование первоначальной рабочей версии ушло меньше пяти минут.

Здесь и проявляется ценность правильной обвязки для кодинга. Grok не просто сгенерировал блок кода Python и вернул его. Он создавал файлы, запускал приложение, анализировал ошибки, вносил правки и продолжал, пока проект не заработал.

Итерации над интерфейсом

Первая версия работала, но мне не понравился стандартный внешний вид Streamlit. Он выглядел слишком типично для обычного приложения Streamlit.

Поэтому я описал агенту, что хочу изменить: тему, макет дашборда, визуальную иерархию и подачу информации. Grok модифицировал существующий проект, а не пересобирал всё с нуля.

Итог — аккуратная система управления больницей с учётом пациентов, карточками врачей, назначениями, госпитализацией, учётом коек и отчётностью.

Этот процесс также показывает ценность кодовых агентов: можно стартовать с рабочей версии, просмотреть её и продолжать дорабатывать дизайн и функциональность простыми последующими указаниями.

О стоимости

У этого подхода есть один заметный минус: использование Grok через API может оказаться дорогим для агентного кодинга.

В этом проекте дашборд использования SpaceXAI показал итоговые $11,84, около 19,4 млн токенов и 938 API‑запросов. Основные траты пришлись на планирование, веб‑поиск, редактирование файлов, запуск инструментов, тестирование приложения и доработку интерфейса.

Для эпизодического тестирования API‑кредиты по‑прежнему удобны — вы точно контролируете расходы. Но если вы пишете код ежедневно или собираете крупные проекты, подписка SuperGrok, скорее всего, будет предпочтительнее, особенно когда агентные сценарии генерируют сотни запросов за одну сессию.

Grok показал отличные результаты, но этот тест также показал, что при работе кодовых агентов стоимость и расход токенов важны не меньше, чем качество модели.

Напоследок

С кодовыми агентами становится ясно: модель и обвязка для кодинга не обязаны быть от одной компании. Стандартная обвязка вокруг модели не всегда лучший способ её использовать, и разработчики всё чаще сочетают сильные модели, такие как Claude или Grok, с альтернативными кодовыми агентами и терминальными инструментами, которые лучше подходят к их рабочему процессу.

Проблема в том, что сборка собственной конфигурации быстро утомляет. Начинаются установки MCP‑серверов, добавление навыков, настройка плагинов, подключение инструментов и самостоятельное обслуживание всего этого.

Вот что мне нравится в Oh My Pi. Это «всё включено» кодовый агент с большинством возможностей из коробки. Вы устанавливаете его, подключаете провайдера или подписку, выбираете модель — и начинаете писать код. Не нужно тратить часы на сборку агента, прежде чем вы сможете им пользоваться.

Grok отлично работал с OMP и выдал добротное приложение, но стоимость по API оказалась выше ожидаемой. Для редкого тестирования API‑кредиты подходят. Если бы я ежедневно использовал Grok для кодинга, лично я рассмотрел бы связку SuperGrok с OMP.

В конечном счёте важно не только то, у какой компании лучшая кодовая модель. Гораздо важнее найти сочетание модели и обвязки, которое лучше всего подходит под ваш реальный рабочий процесс.