Samouczek Oh My Pi: zbuduj pełną aplikację z Grokiem jako twoim agentem do kodowania

Dlaczego warto używać Oh My Pi?

Dobry agent do kodowania potrzebuje dwóch rzeczy: mocnego modelu agentowego i mocnego „uprzęża” do kodu.

Model dostarcza inteligencję. W tym samouczku używamy Groka 4.6, który xAI zbudowało do kodowania, długotrwałych agentów i wieloetapowej pracy na całych bazach kodu. Obsługuje okno kontekstu 500 tys. tokenów, wejście obrazów, wywoływanie funkcji, wykonywanie kodu i wyszukiwanie w sieci.

Nawet najlepszy model jest jednak ograniczony, jeśli jego uprząż pozwala mu tylko czytać i pisać tekst. By pracować jak prawdziwy deweloper, model musi umieć:

• Przeglądać repozytorium i niezawodnie edytować pliki
• Uruchamiać polecenia i wykonywać testy
• Czytać diagnostykę i debugować awarie
• Szukać w dokumentacji i weryfikować, że wprowadzone zmiany rzeczywiście działają

To właśnie zapewnia OMP: integrację z LSP, prawdziwy debugger, trwałe wykonywanie kodu, narzędzia przeglądarkowe i webowe, integrację z GitHubem, pamięć i równoległych subagentów. Razem z modelem tworzą pełną pętlę agentową:

Plan → inspekcja → edycja → uruchomienie → debugowanie → test → weryfikacja

Model decyduje, co zrobić, a OMP daje mu narzędzia, by to faktycznie zrobić. I ponieważ OMP obsługuje ponad 60 dostawców AI, nie jesteś przywiązany do Groka. Ten sam przepływ działa, czy podłączysz Groka, Claude’a, czy inny model.

Zainstaluj Oh My Pi

Oh My Pi to fork otwartoźródłowego agenta Pi do kodowania, zbudowany przez Stencil Labs, który szybko stał się jednym z popularniejszych terminalowych agentów do kodowania, z ponad 34 000 gwiazdek na GitHubie. Jest przeznaczony dla deweloperów, którzy chcą gotowego środowiska do kodowania bez spędzania czasu na składaniu i konfigurowaniu własnego stosu agenta.

OMP działa na Linuksie, macOS i Windowsie.

Na Linuksie lub macOS uruchom:

curl -fsSL https://omp.sh/install | shObsługiwane przez

W Windows PowerShell:

irm https://omp.sh/install.ps1 | iexObsługiwane przez

Możesz też zainstalować globalnie przy użyciu Bun (wersja 1.3.14 lub nowsza):

bun install -g @oh-my-pi/pi-coding-agentObsługiwane przez

Jeśli po instalacji nie znaleziono polecenia omp, zrestartuj terminal lub sprawdź w logach instalatora lokalizację instalacji.

Następnie zweryfikuj instalację:

omp --versionObsługiwane przez

Na przykład:

omp/18.0.6Obsługiwane przez

Jeśli pojawi się numer wersji, OMP zostało zainstalowane poprawnie i polecenie omp jest gotowe do użycia.

Skonfiguruj dostęp SpaceXAI

Aby używać Groka z Oh My Pi, masz dwie opcje.

Jeśli tylko testujesz model lub podążasz za tym samouczkiem, polecam użycie API xAI. Załóż konto na https://console.x.ai/, dodaj niewielką przedpłatę i wygeneruj klucz API. xAI pobiera opłaty bezpośrednio z salda kredytów, co ułatwia kontrolę wydatków.

Jeśli planujesz regularnie używać Groka do kodowania, subskrypcja SuperGrok może mieć więcej sensu. OMP obsługuje SuperGrok bezpośrednio przez SpaceXAI OAuth, więc możesz podłączyć swoją subskrypcję używając /login zamiast płacić osobno za każde żądanie API.

W tym samouczku użyjemy metody przez API, bo łatwiej ją przetestować i kontrolować koszty.

Utwórz klucz API w konsoli deweloperskiej SpaceXAI i zapisz go bezpiecznie. OMP automatycznie szuka zmiennej środowiskowej XAI_API_KEY.

Na Linuksie lub macOS:

export XAI_API_KEY="your-xai-api-key"Obsługiwane przez

Aby zachować ją po restarcie terminala:

echo 'export XAI_API_KEY="your-xai-api-key"' >> ~/.bashrc
source ~/.bashrcObsługiwane przez

W Windows PowerShell:

$env:XAI_API_KEY="your-xai-api-key"Obsługiwane przez

Dostępne modele Groka sprawdzisz poleceniem:

omp models xaiObsługiwane przez

Uruchom Oh My Pi z Grokiem

Utwórz nowy katalog do testowania agenta:

mkdir grok-pi-demo
cd grok-pi-demoObsługiwane przez

Zainicjuj repozytorium Git, aby OMP mógł śledzić wprowadzane zmiany:

git initObsługiwane przez

Teraz uruchom Oh My Pi:

ompObsługiwane przez

Przy pierwszym uruchomieniu OMP może otworzyć krótki kreator konfiguracji dostawców, wyszukiwania w sieci i interfejsu. W każdej chwili możesz też uruchomić omp setup, aby otworzyć go ponownie.

Ponieważ skonfigurowaliśmy już zmienną środowiskową XAI_API_KEY, nie musisz ponownie logować się do xAI. Naciśnij Esc po zakończeniu konfiguracji dostawców.

Jeśli zamiast kredytów API używasz subskrypcji SuperGrok, wybierz na ekranie logowania xAI Grok OAuth (SuperGrok lub X Premium+).

Gdy OMP się otworzy, wpisz:

/modelObsługiwane przez

Wybierz xAI z listy dostawców i wskaż:

grok-4.6Obsługiwane przez

Aby zamiast tego użyć nowszego Groka 4.7, wybierz tutaj grok-4.7. Cała reszta w tym samouczku pozostaje bez zmian.

OMP pokazuje też przydatne informacje o modelu, w tym okno kontekstu, ceny, wsparcie dla rozumowania i możliwości wizji.

Masz teraz Groka działającego w Oh My Pi jako terminalowego agenta do kodowania. Od tego momentu może używać wbudowanych narzędzi OMP do inspekcji plików, modyfikowania kodu, wykonywania poleceń, uruchamiania testów, debugowania problemów i realizowania większych zadań deweloperskich.

Poznaj wbudowane funkcje Oh My Pi

Oh My Pi ma 31 narzędzi wbudowanych i obsługuje ponad 60 dostawców AI, więc większość przepływów pracy działa bez instalowania dodatkowych wtyczek czy serwerów MCP.

Najbardziej przydatne możliwości obejmują:

• Zarządzanie plikami: Odczyt, tworzenie, edycja, wyszukiwanie i strukturalne modyfikacje plików.

• Dostęp do terminala: Uruchamianie poleceń powłoki i zarządzanie procesami bezpośrednio z agenta.

• Wykonywanie kodu: Trwałe sesje Pythona i JavaScriptu.

• Integracja z LSP: Nawigacja po definicjach, znajdowanie referencji, zmiana nazw symboli, podgląd diagnostyki i stosowanie akcji na kodzie.

• Debugger: Debuggowanie aplikacji w Pythonie, Go, C/C++ i innych wspieranych językach przez integracje DAP.

• Wyszukiwanie w sieci: Szukanie w dokumentacji, GitHubie, Stack Overflow, Reddicie, rejestrach pakietów, publikacjach naukowych i całej sieci.

• Automatyzacja przeglądarki: Otwieranie i interakcja ze stronami przez przeglądarkę opartą na Chromium.

• Subagenci: Dzielenie większych zadań kodowych między wielu agentów pracujących równolegle.

• Narzędzia GitHub: Praca z repozytoriami, zgłoszeniami, pull requestami, wyszukiwaniem kodu i GitHub Actions.

• Pamięć: Przechowywanie i przywoływanie istotnych informacji o projekcie między sesjami.

• Rozumienie obrazów: Inspekcja zrzutów ekranu, diagramów i innych lokalnych obrazów.

• Generowanie obrazów: Generowanie lub edycja obrazów z użyciem wspieranych dostawców AI.

• Text-to-speech: Generowanie mowy przy użyciu xAI Grok Voice.

• Pliki zdalne: Odczyt plików na zdalnych maszynach przez ścieżki ssh://.

• Zarządzanie sesjami: Checkpointy, przewijanie, rozgałęzianie, wznawianie i zarządzanie dłuższymi sesjami agenta.

• Orkiestracja agentów: Słowa kluczowe takie jak orchestrate i workflowz w promptach koordynują wielu subagentów przy złożonych zadaniach.

Część narzędzi, m.in. GitHub, pamięć, generowanie obrazów, synteza mowy i checkpointy, jest domyślnie wyłączona. Możesz je włączyć w ustawieniach OMP.

Innymi słowy, model potrafi dużo więcej niż generować kod. Dzięki Oh My Pi potrafi szukać w sieci, rozumieć bazę kodu, edytować pliki, uruchamiać polecenia, debugować błędy, pamiętać kontekst projektu i koordynować wielu agentów – wszystko z jednego interfejsu terminalowego.

Zbuduj projekt z Oh My Pi i Grokiem

Zamiast testować konfigurację prostym pytaniem o kod, dajmy jej cały projekt i zobaczmy, jak Grok i Oh My Pi radzą sobie z planowaniem, implementacją, testami i iteracją.

Najpierw przełącz OMP w tryb planowania (w momencie pisania: /plan):

/planObsługiwane przez

Następnie wprowadź poniższy prompt:

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.Obsługiwane przez

Przejrzyj plan

Zanim napisał kod, Grok użył wbudowanych narzędzi OMP, by zbadać odpowiednią dokumentację, sprawdzić bieżące informacje o Streamlit i ekosystemie Pythona, przeanalizować wymagania i rozważyć, jak powinna wyglądać struktura aplikacji.

Następnie powstał szczegółowy plan wdrożenia podzielony na sekcje. OMP czyni plan interaktywnym, więc możesz przechodzić między sekcjami, analizować poszczególne decyzje i wprowadzać zmiany, zanim agent dotknie projektu.

Gdy będziesz zadowolony, zatwierdź plan i pozwól Grokowi zacząć budowę.

Pozwól Grokowi zbudować i przetestować aplikację

Po zatwierdzeniu planu właściwa implementacja była zaskakująco prosta. Grok utworzył strukturę projektu, warstwę bazy danych, interfejs Streamlit, przykładowe dane i funkcjonalności CRUD, po czym zainstalował zależności i przetestował aplikację.

Pierwsza działająca wersja powstała i została przetestowana w mniej niż pięć minut.

I tu widać, jak ważna jest porządna uprząż do kodowania. Grok nie po prostu wygenerował blok Pythona i oddał mi go. Potrafił tworzyć pliki, uruchamiać aplikację, analizować błędy, wprowadzać poprawki i kontynuować, aż projekt działał.

Iteruj nad interfejsem

Pierwsza wersja działała, ale nie podobał mi się domyślny wygląd Streamlit. Zbyt przypominał standardową aplikację Streamlit.

Więc powiedziałem agentowi, co chcę zmienić: motyw, układ pulpitu, hierarchię wizualną i sposób prezentacji informacji. Grok zmodyfikował istniejący projekt zamiast budować wszystko od zera.

Końcowy efekt to dopracowany System Zarządzania Szpitalem z obsługą pacjentów, kart lekarzy, wizyt, przyjęć, śledzenia łóżek i raportowania.

Proces pokazuje też wartość agentów do kodowania: możesz zacząć od działającej wersji, przejrzeć ją i dalej dopracowywać wygląd oraz funkcje prostymi, kolejnymi instrukcjami.

Słowo o kosztach

Jest jedna istotna wada tej konfiguracji: Grok przez API może być drogi przy agentowym kodowaniu.

W tym projekcie pulpit użycia SpaceXAI pokazał łączne wydatki 11,84 USD, ok. 19,4 mln tokenów przetworzonych w 938 żądaniach API. Większość zużycia pochodziła z planowania, wyszukiwania w sieci, edycji plików, uruchamiania narzędzi, testowania aplikacji i dopracowywania UI.

Do okazjonalnych testów kredyty API są nadal użyteczne, bo możesz dokładnie kontrolować wydatki. Ale jeśli kodujesz codziennie lub budujesz większe projekty, subskrypcja SuperGrok to prawdopodobnie lepsza opcja, zwłaszcza gdy agentowe przepływy generują setki żądań w jednej sesji.

Grok dostarczył świetnych rezultatów, ale ten test pokazał też, że przy agentach do kodowania koszty i zużycie tokenów są równie ważne, co jakość modelu.

Na koniec

Coraz bardziej widać, że model i uprząż do kodowania nie muszą pochodzić od tej samej firmy. Domyślna uprząż wokół modelu nie zawsze jest najlepszym sposobem jego użycia, a deweloperzy coraz częściej łączą mocne modele, takie jak Claude czy Grok, z alternatywnymi agentami i narzędziami terminalowymi lepiej dopasowanymi do ich pracy.

Problem w tym, że budowanie własnej konfiguracji szybko staje się uciążliwe. Zaczynasz instalować serwery MCP, dodawać umiejętności, konfigurować wtyczki, podłączać narzędzia i samodzielnie to wszystko utrzymywać.

To właśnie lubię w Oh My Pi. To agent „z bateriami w zestawie” z większością tych możliwości na starcie. Instalujesz, podłączasz dostawcę lub subskrypcję, wybierasz model i zaczynasz kodować. Nie musisz spędzać godzin na składaniu agenta, zanim w ogóle zaczniesz go używać.

Grok działał z OMP bardzo dobrze i stworzył solidną aplikację, ale koszt API był wyższy, niż się spodziewałem. Do okazjonalnych testów kredyty API są w porządku. Gdybym używał Groka do codziennego kodowania, sam rozważyłbym raczej SuperGrok z OMP.

Ostatecznie najciekawsze nie jest tylko to, która firma ma najlepszy model do kodowania. Chodzi o znalezienie najlepszego połączenia modelu i uprzęży do tego, jak naprawdę pracujesz.