pi-omniroute

Extensão de provider para o Pi Coding Agent que conecta o Pi ao OmniRoute — um gateway de IA open-source que agrega 236+ providers em um único endpoint OpenAI-compatible.

Recursos

• Registra o provider omniroute no Pi
• Descoberta dinâmica de modelos via GET /v1/models (modelos auto-routing são filtrados)
• Configuração via /login omniroute (interativo) ou variáveis de ambiente
• Credenciais persistidas no ~/.pi/agent/auth.json do próprio Pi

Instalação

Via npm (recomendado):

pi install npm:@igor-guari/pi-omniroute

Ou direto do GitHub:

pi install https://github.com/IgorGuariroba/pi-omniroute

Ou manualmente, copiando o arquivo para a pasta de extensões do Pi:

mkdir -p ~/.pi/agent/extensions
curl -fsSL https://raw.githubusercontent.com/IgorGuariroba/pi-omniroute/main/extensions/omniroute.ts \
  -o ~/.pi/agent/extensions/omniroute.ts

Em sessões do Pi já abertas, rode /reload para carregar a extensão.

Configuração

Escolha uma das opções:

A) Via /login (recomendado)

No Pi, execute:

/login omniroute

A extensão pergunta a URL do servidor e a API key.

B) Via variáveis de ambiente

export OMNIROUTE_BASE_URL="http://<servidor>:20128/v1"
export OMNIROUTE_API_KEY="sk-..."

Uso

Depois de configurado, selecione um modelo:

/model

Os modelos do OmniRoute aparecem sob o provider omniroute.

Uso com PI WEB / Docker / Dokploy

Funciona normalmente em sessões do PI WEB. Em containers, monte ~/.pi como volume persistente e defina as variáveis de ambiente OMNIROUTE_BASE_URL / OMNIROUTE_API_KEY, ou faça /login omniroute uma vez em qualquer sessão.

Para instalar automaticamente no boot do container (idempotente):

pi install npm:@igor-guari/pi-omniroute

🚀 Deploy pronto: veja pi-web-dokploy — PI WEB no Dokploy com Traefik, Basic Auth e esta extensão já integrada.

Atualização

pi update npm:@igor-guari/pi-omniroute   # ou: pi update --all

Depois rode /reload nas sessões do Pi abertas.

Licença

MIT