@earendil-works/pi-coding-agent tilbyr en interaktiv CLI for kodeagenter med arbeidsflyter for filer, shell, redigering, skriving, økter, utskrift, JSON, RPC og SDK. Pi kan laste inn egendefinerte leverandører fra ~/.pi/agent/models.json, slik at du kan legge til CometAPI som OpenAI-kompatible leverandøroppføringer uten å endre kildekoden til Pi.
Offisielle referanser:
Modelltilgjengelighet endrer seg over tid. Erstatt
your-model-id med en tilgjengelig model ID fra CometAPI Models page.Forutsetninger
- Node.js
>=22.19.0 - npm
- En CometAPI-konto med en aktiv API-nøkkel fra dashboard
- Pi installert fra den offisielle npm-pakken
Forstå kjøretidstillatelser
Pi kjører med tillatelsene til brukeren og prosessen som starter det. Start Pi i prosjektkatalogen du vil at det skal arbeide i, behold en tilbakeføringsmulighet som git, og bruk en container eller sandbox hvis du trenger sterkere grenser for filsystem, prosesser, nettverk eller legitimasjon.Konfigurer leverandøren
1
Installer Pi
Installer Pi globalt med npm:Bekreft at CLI-en er tilgjengelig:
2
Angi CometAPI API-nøkkelen din
Lagre CometAPI API-nøkkelen din i miljøvariabelen Legg til export-kommandoen i shell-profilen din hvis du vil at den skal vedvare på tvers av terminaløkter. Ikke commit API-nøkler til versjonskontroll.
COMETAPI_KEY:3
Legg til CometAPI-leverandører i models.json
Opprett Bruk
~/.pi/agent/models.json hvis den ikke finnes. Hvis filen allerede inneholder providers, flett oppføringene cometapi-responses og cometapi-chat inn i det eksisterende providers-objektet:cometapi-responses for modeller eller arbeidsflyter som krever OpenAI Responses API. Bruk cometapi-chat for modeller som er kompatible med OpenAI Chat Completions. Pi løser opp $COMETAPI_KEY når forespørselen sendes. Behold API-nøkkelen i miljøet ditt eller i din egen secrets-arbeidsflyt.4
Bekreft begge leverandørene
List opp modellene som Pi kan se for Responses-leverandøren:Kjør en kort engangsprompt med Responses-leverandøren:List opp modellene som Pi kan se for Chat Completions-leverandøren:Kjør en kort engangsprompt med Chat Completions-leverandøren:For interaktiv bruk, start Pi i prosjektet ditt og velg CometAPI-leverandøren og modellen med
/model. Hvis du redigerer models.json under en interaktiv økt, åpner du /model igjen slik at Pi laster inn de egendefinerte modelloppføringene på nytt.Feilsøking
Pi viser ikke CometAPI-modellen
Pi viser ikke CometAPI-modellen
Bekreft at
~/.pi/agent/models.json er gyldig JSON og at hver provider-oppføring ligger inne i providers-objektet på toppnivå. Kjør pi --list-models cometapi-responses eller pi --list-models cometapi-chat etter at du har lagret filen.Pi rapporterer at ingen API-nøkkel er tilgjengelig
Pi rapporterer at ingen API-nøkkel er tilgjengelig
Bekreft at
COMETAPI_KEY er satt i den samme shell-økten som starter Pi. Hvis du bruker en shell-profil, åpne et nytt terminalvindu eller source profilen før du kjører Pi.Forespørsler mislykkes på grunn av base URL
Forespørsler mislykkes på grunn av base URL
Bruk
https://api.cometapi.com/v1 som baseUrl i models.json. Ikke pek Pi til dashboard-URL-en eller utelat /v1-suffikset for OpenAI-kompatible ruter.Pi feiler før den sender en modellforespørsel
Pi feiler før den sender en modellforespørsel
Sjekk Node.js-versjonen din med
node --version. Pi-pakken krever Node.js >=22.19.0.Modellen fungerer på én rute, men ikke den andre
Modellen fungerer på én rute, men ikke den andre
Bruk provider-oppføringen der
api-feltet samsvarer med ruten modellen din støtter. openai-responses bruker Responses API, mens openai-completions bruker Chat Completions.Pi har mer tilgang enn forventet
Pi har mer tilgang enn forventet
Pi kjører med tillatelsene til brukeren og prosessen som startet den. Kjør Pi i en container eller sandkasse når du trenger sterkere grenser rundt filer, prosesser, nettverkstilgang eller legitimasjon.