Skip to main content
Pi is het Pi Agent Harness-project. Het pakket @earendil-works/pi-coding-agent biedt een interactieve coding agent-CLI met bestands-, shell-, edit-, write-, session-, print-, JSON-, RPC- en SDK-workflows. Pi kan aangepaste providers laden vanuit ~/.pi/agent/models.json, zodat je CometAPI kunt toevoegen als OpenAI-compatible provider-vermeldingen zonder de broncode van Pi te wijzigen. Officiële referenties:
Beschikbaarheid van modellen verandert in de loop van de tijd. Vervang your-model-id door een beschikbaar model ID van de CometAPI Models page.

​
Vereisten

  • Node.js >=22.19.0
  • npm
  • Een CometAPI-account met een actieve API key uit het dashboard
  • Pi geïnstalleerd vanuit het officiële npm-pakket

​
Runtime-machtigingen begrijpen

Pi draait met de machtigingen van de gebruiker en het proces die het starten. Start Pi in de projectmap waarop het moet werken, houd een rollback-pad zoals git beschikbaar, en gebruik een container of sandbox als je sterkere grenzen nodig hebt voor bestandssysteem, processen, netwerk of credentials.

​
Configureer de provider

1

Installeer Pi

Installeer Pi globaal met npm:
Bevestig dat de CLI beschikbaar is:
2

Stel je CometAPI API-sleutel in

Sla je CometAPI API-sleutel op in de omgevingsvariabele COMETAPI_KEY:
Voeg het exportcommando toe aan je shellprofiel als je wilt dat het behouden blijft tussen terminalsessies. Commit geen API-sleutels naar versiebeheer.
3

Voeg CometAPI-providers toe aan models.json

Maak ~/.pi/agent/models.json aan als het nog niet bestaat. Als het bestand al providers bevat, voeg dan de items cometapi-responses en cometapi-chat samen in het bestaande object providers:
Gebruik cometapi-responses voor modellen of workflows die de OpenAI Responses API vereisen. Gebruik cometapi-chat voor modellen die compatibel zijn met OpenAI Chat Completions. Pi verwerkt $COMETAPI_KEY op het moment van de request. Bewaar de API-sleutel in je omgeving of in je eigen secrets-workflow.
4

Verifieer beide providers

Geef de modellen weer die Pi kan zien voor de Responses-provider:
Voer een korte eenmalige prompt uit met de Responses-provider:
Geef de modellen weer die Pi kan zien voor de Chat Completions-provider:
Voer een korte eenmalige prompt uit met de Chat Completions-provider:
Voor interactief gebruik start je Pi in je project en selecteer je de CometAPI-provider en het model met /model. Als je models.json bewerkt tijdens een interactieve sessie, open dan /model opnieuw zodat Pi de aangepaste modelitems opnieuw laadt.

​
Probleemoplossing

Bevestig dat ~/.pi/agent/models.json geldige JSON is en dat elke provider-vermelding zich binnen het bovenliggende object providers bevindt. Voer pi --list-models cometapi-responses of pi --list-models cometapi-chat uit nadat je het bestand hebt opgeslagen.
Bevestig dat COMETAPI_KEY is ingesteld in dezelfde shellsessie waarmee Pi wordt gestart. Als je een shellprofiel gebruikt, open dan een nieuwe terminal of laad het profiel voordat je Pi uitvoert.
Gebruik https://api.cometapi.com/v1 als de baseUrl in models.json. Laat Pi niet verwijzen naar de dashboard-URL en laat het achtervoegsel /v1 niet weg voor OpenAI-compatibele routes.
Controleer je Node.js-versie met node --version. Het Pi-pakket vereist Node.js >=22.19.0.
Gebruik de provider-vermelding waarvan het veld api overeenkomt met de route die je model ondersteunt. openai-responses gebruikt de Responses API, terwijl openai-completions Chat Completions gebruikt.
Pi draait met de rechten van de gebruiker en het proces waarmee het is gestart. Voer Pi uit binnen een container of sandbox wanneer je sterkere afbakening nodig hebt rond bestanden, processen, netwerktoegang of credentials.

​
Gerelateerde bronnen