Tutorial Oh My Pi: Construiește o aplicație completă cu Grok ca agentul tău de codare

De ce să folosești Oh My Pi?

Un agent de codare bun are nevoie de două lucruri: un model agentic puternic și un "harness" de codare solid.

Modelul oferă inteligența. Pentru acest tutorial, folosim Grok 4.6, pe care xAI l-a construit pentru codare, agenți care rulează pe termen lung și lucru în mai mulți pași pe întregi codebase-uri. Suportă un context window de 500K tokeni, input de imagini, function calling, execuție de cod și căutare web.

Dar chiar și cel mai bun model este limitat dacă harness-ul îi permite doar să citească și să scrie text. Ca să lucreze ca un dezvoltator real, modelul are nevoie să poată:

• Inspecta un repository și edita fișiere în mod fiabil
• Rula comenzi și executa teste
• Citi diagnostice și depana eșecuri
• Căuta documentație și verifica faptul că modificările chiar funcționează

Asta oferă OMP: integrare LSP, un depanator real, execuție persistentă a codului, instrumente de browser și web, integrare GitHub, memorie și subagenți în paralel. Împreună cu modelul, creează bucla agentică completă:

Plan → inspect → edit → run → debug → test → verify

Modelul decide ce să facă, iar OMP îi oferă uneltele ca să o facă efectiv. Și pentru că OMP suportă peste 60 de provideri de AI, nu ești legat de Grok. Același flux de lucru se aplică indiferent dacă conectezi Grok, Claude sau alt model.

Instalează Oh My Pi

Oh My Pi este un fork al agentului de codare open-source Pi, construit de Stencil Labs, și a devenit rapid unul dintre cei mai populari agenți de codare în terminal, cu peste 34.000 de stele pe GitHub. Este conceput pentru dezvoltatori care vor un mediu de codare gata de folosit fără să piardă timp asamblând și configurând un stack personalizat de agenți.

OMP funcționează pe Linux, macOS și Windows.

Pe Linux sau macOS, rulează:

curl -fsSL https://omp.sh/install | shFuncționează cu

Pe Windows PowerShell:

irm https://omp.sh/install.ps1 | iexFuncționează cu

Îl poți instala și global folosind Bun (versiunea 1.3.14 sau mai nouă):

bun install -g @oh-my-pi/pi-coding-agentFuncționează cu

Dacă comanda omp nu este găsită după instalare, repornește terminalul sau verifică ieșirea installer-ului pentru locația instalării.

Apoi verifică instalarea:

omp --versionFuncționează cu

De exemplu:

omp/18.0.6Funcționează cu

Dacă apare un număr de versiune, OMP este instalat corect și comanda omp e gata de folosit.

Configurează accesul SpaceXAI

Pentru a folosi Grok cu Oh My Pi, ai două opțiuni.

Dacă doar testezi modelul sau urmezi acest tutorial, îți recomand API-ul xAI. Creează un cont la https://console.x.ai/, adaugă o sumă mică de credit preplătit și generează o cheie API. xAI deduce utilizarea direct din soldul de credit, ceea ce face ușor să controlezi cât cheltui.

Dacă plănuiești să folosești Grok regulat pentru codare, un abonament SuperGrok poate avea mai mult sens. OMP suportă SuperGrok direct prin SpaceXAI OAuth, deci îți poți conecta abonamentul folosind /login în loc să plătești separat pentru fiecare cerere API.

Pentru acest tutorial, vom folosi metoda cu API pentru că este mai ușor de testat și controlat costul.

Creează-ți cheia API în consola pentru dezvoltatori SpaceXAI și salveaz-o în siguranță. OMP caută automat variabila de mediu XAI_API_KEY.

Pe Linux sau macOS:

export XAI_API_KEY="your-xai-api-key"Funcționează cu

Pentru a o păstra după repornirea terminalului:

echo 'export XAI_API_KEY="your-xai-api-key"' >> ~/.bashrc
source ~/.bashrcFuncționează cu

Pe Windows PowerShell:

$env:XAI_API_KEY="your-xai-api-key"Funcționează cu

Poți verifica modelele Grok disponibile cu:

omp models xaiFuncționează cu

Pornește Oh My Pi cu Grok

Creează un director nou pentru a testa agentul de codare:

mkdir grok-pi-demo
cd grok-pi-demoFuncționează cu

Inițializează un repository Git ca OMP să poată urmări modificările pe care le face:

git initFuncționează cu

Acum pornește Oh My Pi:

ompFuncționează cu

La prima lansare, OMP poate deschide un mic asistent de configurare pentru provideri, căutare web și interfață. Poți rula și omp setup oricând pentru a-l deschide din nou.

Deoarece am configurat deja variabila de mediu XAI_API_KEY, nu mai trebuie să te autentifici în xAI. Apasă Esc când ai terminat configurarea provider-ului.

Dacă folosești abonamentul SuperGrok în loc de credite API, selectează xAI Grok OAuth (SuperGrok sau X Premium+) din ecranul de autentificare.

După ce OMP se deschide, introdu:

/modelFuncționează cu

Selectează xAI din lista de provideri și alege:

grok-4.6Funcționează cu

Pentru a folosi Grok 4.7, mai nou, selectează aici grok-4.7. Restul tutorialului rămâne neschimbat.

OMP afișează și informații utile despre model, inclusiv context window, prețuri, suport pentru reasoning și capabilități de viziune.

Acum ai Grok rulând în Oh My Pi ca agent de codare bazat pe terminal. De aici, poate folosi instrumentele integrate ale OMP pentru a inspecta fișiere, modifica cod, executa comenzi, rula teste, depana probleme și parcurge sarcini de dezvoltare mai mari.

Explorează funcțiile integrate din Oh My Pi

Oh My Pi vine cu 31 de instrumente integrate și suport pentru peste 60 de provideri de AI, astfel încât majoritatea fluxurilor de lucru pentru codare funcționează fără a instala pluginuri suplimentare sau servere MCP.

Unele dintre cele mai utile capabilități integrate includ:

• Management fișiere: Citește, creează, editează, caută și modifică structural fișiere.

• Acces la terminal: Rulează comenzi shell și gestionează procese direct din agent.

• Execuție cod: Rulează sesiuni persistente de Python și JavaScript.

• Integrare LSP: Navighează definiții, găsește referințe, redenumește simboluri, vezi diagnostice și aplică acțiuni de cod.

• Depanator: Depanează aplicații Python, Go, C/C++ și altele suportate prin integrări DAP.

• Căutare web: Caută documentație, GitHub, Stack Overflow, Reddit, registre de pachete, lucrări de cercetare și web-ul larg.

• Automatizare browser: Deschide și interacționează cu site-uri printr-un browser bazat pe Chromium.

• Subagenți: Împarte sarcini mai mari de codare între mai mulți agenți care lucrează în paralel.

• Instrumente GitHub: Lucrează cu repository-uri, issue-uri, pull request-uri, căutare de cod și GitHub Actions.

• Memorie: Stochează și reamintește informații utile despre proiect între sesiunile de codare.

• Înțelegere imagini: Inspectează capturi de ecran, diagrame și alte imagini locale.

• Generare imagini: Generează sau editează imagini folosind provideri de AI suportați.

• Text-to-speech: Generează vorbire folosind xAI Grok Voice.

• Fișiere remote: Citește fișiere pe mașini remote prin căi ssh://.

• Management sesiuni: Checkpoint, rewind, branch, resume și gestionează sesiuni de agent mai lungi.

• Orchestrare agenți: Cuvinte-cheie precum orchestrate și workflowz în prompt coordonează mai mulți subagenți pentru sarcini complexe.

Unele dintre aceste instrumente, inclusiv GitHub, memoria, generarea de imagini, text-to-speech și checkpoint-urile, sunt dezactivate implicit. Le poți activa în setările OMP.

Cu alte cuvinte, modelul poate face mult mai mult decât să genereze cod. Prin Oh My Pi, poate căuta pe web, înțelege un codebase, edita fișiere, rula comenzi, depana erori, memora contextul proiectului și coordona mai mulți agenți din aceeași interfață de terminal.

Construiește un proiect cu Oh My Pi și Grok

În loc să testăm configurația cu o întrebare simplă de codare, hai să-i dăm un proiect complet și să vedem cât de bine gestionează Grok și Oh My Pi planificarea, implementarea, testarea și iterația.

Mai întâi, comută OMP în modul de planificare (/plan la momentul scrierii):

/planFuncționează cu

Apoi introdu următorul 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.Funcționează cu

Revizuiește planul

Înainte de a scrie cod, Grok a folosit instrumentele integrate ale OMP pentru a cerceta documentația relevantă, a verifica informații actuale despre Streamlit și ecosistemul Python, a inspecta cerințele și a raționa despre cum ar trebui structurată aplicația.

Apoi a produs un plan detaliat de implementare împărțit pe secțiuni. OMP face planul interactiv, astfel încât poți naviga între secțiuni, inspecta decizii individuale în detaliu și face modificări înainte de a permite agentului să atingă proiectul.

Când ești mulțumit, aprobă planul și lasă-l pe Grok să înceapă construcția.

Lasă-l pe Grok să construiască și să testeze aplicația

După aprobarea planului, implementarea propriu-zisă a fost surprinzător de directă. Grok a creat structura proiectului, stratul de bază de date, interfața Streamlit, datele de exemplu și funcționalitatea CRUD, apoi a instalat dependențele și a testat aplicația.

Versiunea inițială funcțională a durat mai puțin de cinci minute să fie construită și testată.

Aici contează să ai un harness de codare adecvat. Grok nu a generat pur și simplu un bloc de cod Python pe care să mi-l dea înapoi. A putut crea fișiere, rula aplicația, inspecta erori, face corecții și continua până când proiectul a rulat.

Iterează pe UI

Prima versiune funcționa, dar nu mi-a plăcut aspectul implicit Streamlit. Arăta prea mult ca o aplicație standard Streamlit.

Așa că i-am spus agentului ce vreau schimbat, inclusiv tema, layout-ul dashboard-ului, ierarhia vizuală și cum ar trebui prezentate informațiile. Grok a modificat proiectul existent în loc să reconstruiască totul de la zero.

Rezultatul final a fost un Sistem de Management al Spitalului finisat, cu gestionarea pacienților, evidența medicilor, programări, internări, urmărirea paturilor și raportare.

Procesul arată și valoarea agenților de codare: poți începe cu o versiune funcțională, o poți revizui și continua să rafinezi designul și funcționalitatea prin instrucțiuni simple de follow-up.

O notă despre cost

Există un mare dezavantaj la această configurație: Grok prin API poate deveni scump pentru codare agentică.

Pentru acest proiect, dashboard-ul de utilizare SpaceXAI a arătat 11,84 USD cheltuiți în total, cu aproximativ 19,4 milioane de tokeni procesați în 938 de cereri API. Majoritatea utilizării a venit din planificare, căutare web, editarea fișierelor, rularea uneltelor, testarea aplicației și rafinarea UI-ului.

Pentru testări ocazionale, creditele API sunt totuși utile deoarece poți controla exact cât cheltui. Dar dacă codezi zilnic sau construiești proiecte mai mari, un abonament SuperGrok este probabil opțiunea mai bună, mai ales când fluxurile agentice generează sute de cereri într-o singură sesiune.

Grok a livrat rezultate excelente, dar acest test a arătat și că, odată cu agenții de codare, costul și consumul de tokeni contează la fel de mult ca și calitatea modelului.

Gânduri finale

Un lucru devine clar cu agenții de codare: modelul și harness-ul de codare nu trebuie să provină de la aceeași companie. Harness-ul implicit din jurul unui model nu este întotdeauna cel mai bun mod de a-l folosi, iar dezvoltatorii asociază din ce în ce mai mult modele puternice precum Claude sau Grok cu agenți de codare alternativi și instrumente pe terminal care se potrivesc mai bine fluxului lor de lucru.

Problema este că să-ți construiești propria configurație poate deveni rapid obositor. Începi să instalezi servere MCP, să adaugi skill-uri, să configurezi pluginuri, să conectezi unelte și să întreții totul singur.

Asta îmi place la Oh My Pi. Este un agent de codare „batteries-included” cu majoritatea capabilităților integrate. Îl instalezi, îți conectezi provider-ul sau abonamentul, alegi un model și începi să codezi. Nu trebuie să petreci ore asamblând agentul înainte să-l poți folosi efectiv.

Grok a mers foarte bine cu OMP și a produs o aplicație solidă, dar costul API-ului a fost mai mare decât mă așteptam. Pentru testări ocazionale, creditele API sunt în regulă. Dacă aș folosi Grok pentru codare în fiecare zi, personal m-aș uita la SuperGrok cu OMP.

În cele din urmă, partea interesantă nu este doar ce companie are cel mai bun model de codare. Este să găsești combinația optimă între model și harness pentru modul în care lucrezi tu, în practică.