omp (Oh My Pi) + JoinGonka Gateway: agent na may mga model role

Hakbang 1: i-install ang omp. Mga opisyal na paraan mula sa README ng proyekto:

# macOS and Linux
curl -fsSL https://omp.sh/install | sh

# Homebrew
brew install can1357/tap/omp

# via Bun (requires Bun 1.3.14 or newer)
bun install -g @oh-my-pi/pi-coding-agent

# Windows (PowerShell)
irm https://omp.sh/install.ps1 | iex

Hakbang 2: kumuha ng key. Magrehistro sa gate.joingonka.ai/register, i-verify ang email at gumawa ng key na may prefix na jg- sa seksyong «Mga API key». Isang key at isang balanse ang gumagana para sa lahat ng modelo ng network.

Hakbang 3: patakbuhin ang installer.

npx @joingonka/setup --tool omp

Tatanungin ng installer ang key — hindi ito ipinapasa sa command-line arguments para hindi ito maitala sa shell history — at gagawin ang apat na bagay:

• isusulat ang provider na joingonka sa ~/.omp/agent/models.yml: address ng gateway, protocol na openai-completions, ang key bilang literal at tatlong modelo ng network na may tunay na context windows at response ceilings; ang file ay makakakuha ng 600 na permiso;
• itakda ang default na modelo — modelRoles.default sa ~/.omp/agent/config.yml — sa DeepSeek V4 Flash, pero kung ang role ay walang laman o tumutukoy sa isang modelong wala na sa network: hindi nito sinasapawan ang pinili ng iba, sa halip ay sinasabi kung paano magpalit;
• bago magsulat, gagawa ng backup ng dating file, at ang iba pang provider, role at komento ay iiwan kung ano sila;
• sa huli, magpapadala ng live na request sa gateway at direktang sasabihin kung tinanggap ang key, address at modelo.

Ang ibang default na modelo ay itinatakda ng --model flag na may shorthand na deepseek, glm o minimax — ang tahasang tinukoy na modelo ay palaging isinusulat. Para sa dotfiles at server, may mode na walang tanong, kung saan ang key ay kinukuha mula sa environment variable:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool omp --model glm --non-interactive

Ang hindi karaniwang lokasyon ng config ay awtomatikong isinasaalang-alang ng installer: pinangalanang profile (OMP_PROFILE) at inilipat na agent directory (PI_CODING_AGENT_DIR). Ang minanang models.json ay inililipat nito sa models.yml tulad ng gagawin mismo ng omp — hindi mawawala ang mga dating provider. At kung may katabing lumang settings.json na walang config.yml, hindi gagawa ang installer ng config.yml para hindi laktawan ng omp ang sarili nitong migration ng settings: hihilingin nitong patakbuhin ang omp nang isang beses at ulitin ang command.

Lahat ng ginagawa ng installer ay maaari mong isulat nang manu-mano. Dalawa lang ang file, at may kanya-kanya silang trabaho: inilalarawan ng models.yml ang mga provider at modelo, habang iniimbak ng config.yml ang mga setting — kasama na kung aling modelo ang nakatoka sa aling role.

# ~/.omp/agent/models.yml
providers:
  joingonka:
    baseUrl: https://gate.joingonka.ai/v1
    api: openai-completions
    apiKey: jg-your-key
    models:
      - id: deepseek-ai/DeepSeek-V4-Flash-0731
        name: DeepSeek V4 Flash (Gonka)
        input: [text]
        contextWindow: 380000
        maxTokens: 32768
        reasoning: true
      - id: zai-org/GLM-5.3-Flash
        name: GLM-5.3 Flash (Gonka)
        input: [text]
        contextWindow: 390000
        maxTokens: 8192
        reasoning: true
      - id: MiniMaxAI/MiniMax-M2.7
        name: MiniMax M2.7 (Gonka)
        input: [text]
        contextWindow: 200000
        maxTokens: 8192

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

Ang key na literal ang pinakamadaling opsyon: nagba-boot ang omp mula sa kahit anong environment, at sapat nang isara ang file gamit ang command na chmod 600 ~/.omp/agent/models.yml. Kung gusto mong nasa labas ng file ang key, isulat sa apiKey ang pangalan ng variable, halimbawa JOINGONKA_API_KEY, at i-export ito sa shell kung saan mo pinapatakbo ang omp: ito mismo ang pagkakasunod-sunod ng pag-resolve ng key na nakasaad sa dokumentasyon ng proyekto.

Ang opsyonal na field na cost (presyo bawat milyong token) ay kailangan lang para tantiyahin ang gastos ng session sa interface ng omp. Isinusulat doon ng installer ang live na presyo ng gateway sa oras ng pag-install; sa manu-manong config, maaari nang laktawan ang field — walang kinalaman ang tantiyang ito sa iyong bill, ang aktwal na gastos ay makikita sa dashboard.

Isinusulat ang model selector bilang provider/model-id. Hinihiwalay ang pangalan ng provider sa unang slash, kaya ang mga identifier ng network na may sariling slash ay isinusulat nang ganito mismo: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731. Sa halip na i-edit ang config.yml, maaari mong itakda ang role mula sa interface — gamit ang command na /model sa loob ng session o sa wizard na omp setup.

Sa omp, hindi iisang modelo ang pinipili para sa lahat, kundi ayon sa mga papel (roles) — ito ang pangunahing mekanismo ng pagsasaayos. Mga built-in na role para sa chat: default, smol, slow, plan, commit, task, tiny, memory, advisor at vision. Hindi kailangang italaga ang lahat: ang mga hindi nakatakdang smol at slow ay kukunin muna ang modelo ng role na default, ang mga sub-agent na walang role na task ay gumagana sa modelo ng kasalukuyang session, ang commit at tiny ay sumusunod sa smol. Ang configuration na may isang linya na default ay ganap na gumagana.

Ang paghahati ng mga role sa pagitan ng mga modelo ng network ay hindi para sa pagtitipid — pare-pareho lang ang presyo ng DeepSeek V4 Flash, GLM-5.3 Flash, at MiniMax M2.7 — kundi para sa gawi (behavior) at kapasidad: ang modelong nag-iisip (reasoning model) ay mas mahusay sa pagpaplano, ang modelong may mahabang sagot ay mas mahusay sa pagsusulat, at ang mga background na detalye ay hindi kailangang isabay sa queue ng pangunahing gawain.

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
  slow: joingonka/zai-org/GLM-5.3-Flash
  plan: joingonka/zai-org/GLM-5.3-Flash
  tiny: joingonka/MiniMaxAI/MiniMax-M2.7

retry:
  fallbackChains:
    default:
      - joingonka/zai-org/GLM-5.3-Flash

Ang block na retry.fallbackChains ay insurance sa oras ng peak: kapag ang pangunahing modelo ay patuloy na sumasagot ng 429, ipapasa ng omp ang natitirang bahagi ng turn sa susunod na entry sa chain, at pagkatapos ng pause ay babalik sa pangunahing modelo. Ang key ng chain ay maaaring role, tiyak na modelo, o buong provider (joingonka/*).

Para sa isang execution, ang role ay maaaring i-redefine gamit ang flag: omp --model slow ay nagpapatakbo ng session sa modelo ng role na slow, habang ang --smol, --slow, at --plan ay pumapalit sa modelo ng mismong role. Sa loob ng session, ang Ctrl+P ay nag-i-scroll sa mga modelo ng role, at ang /model ay nagbubukas ng pagpipilian; sa tab na Roles, maaari ring magtakda ng mga role at ang kanilang mga backup.

Sa value ng role, maaaring magdagdag ng antas ng pag-iisip — :low, :medium, :high. Ito ay syntax ng omp, at kung paano intindihin ng partikular na modelo ang antas ay depende sa mismong modelo: sa GLM-5.3 Flash, halimbawa, ito ay isang binary switch — mga detalye sa overview ng modelo. At isa pang kapaki-pakinabang na detalye: ang mga role ay maaaring i-redefine para sa isang repository gamit ang file na <repo>/.omp/config.yml na may parehong modelRoles block. Ang mga provider at key ay mananatili sa home directory, kaya ang key ay hindi mapupunta sa repository.

Una, siguraduhin munang nakikita ng omp ang provider:

omp models joingonka

Bilang tugon, may darating na talahanayang may tatlong linya na naglalaman ng mga window ng konteksto at pinakamataas na tugon mula sa models.yml, na ni-round sa libu-libo (pinaikli ang output: may mga karagdagang column pa ang omp na thinking at images):

joingonka (3)
model                                context  max-out
deepseek-ai/DeepSeek-V4-Flash-0731      380K      33K
MiniMaxAI/MiniMax-M2.7                  200K     8.2K
zai-org/GLM-5.3-Flash                   390K     8.2K

Pagkatapos — isang beses na pagpapatakbo na walang interface. Maglagay ng file na may malinaw na bug sa isang walang laman na direktoryo at ipahanap ito:

omp -p "Read calc.py and tell me in one sentence whether it has a bug."

Dapat mismo na tawagin ng agent ang tool sa pagbasa at sumagot nang tuwiran — kasama ang pagtukoy sa expression kung saan naroon ang bug. Sa aming pagpapatakbo noong Setyembre 21, 2026, ang cycle na ito — kahilingan, pagtawag sa tool, resulta, tugon — ay malinis na naipasa ng DeepSeek V4 Flash at GLM-5.3 Flash; tungkol sa MiniMax M2.7 — nasa huling linya ng talahanayan sa ibaba.

Ang ikatlong pagsusuri — mula sa panig ng gateway: sa dashboard, sa seksyong "Paggamit", lalabas ang kahilingan sa breakdown na "Ayon sa mga modelo", at sa bloke na "Ayon sa mga key" mag-a-update ang oras ng huling kahilingan. Kung walang laman doon, sa ibang provider pumupunta ang omp: tingnan kung ano ang nakatakda sa mga role gamit ang command na omp config get modelRoles.

Kung may nangyaring mali, kadalasang mababasa nang direkta mula sa mensahe ang diagnosis:

Ang tool ng ahente ay gumagamit ng mga token nang iba kaysa sa chat: sa bawat parirala mo, nagdaragdag ang omp ng system prompt at mga deskripsyon ng tool, at ang gawain ay karaniwang tumatagal ng ilang hakbang. Sa aming run, kahit sa iisang tool na reader lang ang nakabukas, bawat hakbang ay may dala nang humigit-kumulang 3.5 libong input tokens; mas marami pa kung kompleto ang set. Kaya naman napakahalaga ng presyo bawat token dito.

Sa pamamagitan ng JoinGonka Gateway, ang mga token ay nagkakahalaga ng $0.0069 bawat milyon sa input at $0.021 bawat milyon sa output — ang presyo ay pareho para sa lahat ng mga modelo sa network at kinukuha sa pahinang ito mula sa live source.

Ang mga estimate sa kanang column ay base sa mga presyo noong Setyembre 2026. Para sa paghahambing — paano ka magbabayad para sa mga modelo sa omp:

Ang status line ng omp ay nagpapakita ng estimate ng gastos sa session. Kinakalkula ito gamit ang field na cost mula sa models.yml: inilalagay ng installer ang presyo ng gateway sa oras ng pag-install, at ang presyo sa dolyar sa network ay nagbabago kasabay ng rate ng GNK, kaya ang estimate ay gabay lamang. Ang eksaktong konsumo at balanse ay makikita sa account, sa mga seksyong "Usage" at "Billing". Bakit ang DeepSeek V4 Flash ang napili bilang default ay detalyadong tinalakay sa model overview.

Mode ng mga pagpapatibay. Bilang default, gumagana ang omp sa mode na yolo: kusa nitong inaaprubahan ang pagbasa, pagsulat at pagpapatakbo ng mga command. Sa sarili mong proyekto, maginhawa ito; sa code ng iba, dahilan ito para higpitan ang mode o pumasok sa container:

omp config set tools.approvalMode write

Sa mode na write, humihingi ng pahintulot ang agent para sa pagpapatakbo ng mga command lamang; sa always-ask, pati na rin sa pagsulat. Para sa isang pagpapatakbo, ito rin ang itinatakda ng flag na --approval-mode. Katangian ito ng omp mismo, hindi ito nakadepende sa provider ng modelo.

Magkamag-anak ang Pi at omp na may magkaibang config. Hindi naipapasa sa isa pa ang setup ng isang tool: may sarili silang mga direktoryo, format at pangalan ng field.

Maraming environment. Ang pinangalanang profile (omp --profile work o ang variable na OMP_PROFILE) ay naglilipat ng lahat ng setting sa ~/.omp/profiles/<name>/agent — maginhawa para paghiwalayin ang trabaho at personal na mga key. Ang kasalukuyang direktoryo ng agent ay ipinapakita ng omp config path.

Kung kailangan ang agent sa editor. Marunong gumana ang omp sa loob ng Zed gamit ang protocol na ACP — pareho pa rin itong agent na may parehong settings, hindi na kailangang i-set up muli ang provider at mga role.