Desarrollo local

Para el desarrollo, ejecuta Postgres y Redis en Docker y el gateway en el host con recarga en caliente.

Dependencias

git clone https://github.com/boelabs/ai-gateway.git && cd ai-gateway
bun install
docker compose -f docker/compose.yaml -f docker/compose.local.yaml up -d postgres redis

Esto inicia solo Postgres y Redis localmente (texto sin formato en localhost), a los que llega el gateway sin TLS, por lo que no hay Solución de problemas.

Configurar y ejecutar

Crea apps/api/.env (consulta Configuración inicial) con las cadenas de conexión local:

DATABASE_URL=postgres://gateway:gateway@localhost:5432/ai_gateway
REDIS_URL=redis://localhost:6379

Aplique las migraciones e inícielo en Bun con recarga en caliente:

bun run --filter @boelabs/ai-gateway-api db:migrate
bun run --filter @boelabs/ai-gateway-api dev
curl http://localhost:4000/health/ready

dev ejecuta el gateway en Bun con --watch (reinicia al realizar el cambio). A continuación, el Inicio rápido registra un proveedor y realiza su primera llamada.

Pila completa localmente

Para ejecutar todo (gateway + panel + dependencias) en contenedores en lugar de en el host:

docker compose -f docker/compose.yaml -f docker/compose.local.yaml up -d

La anulación vincula Postgres, Redis, el gateway y el panel a 127.0.0.1; intencionalmente no se carga mediante deployments de PaaS de producción.

Consulta deployment → La stack de Compose.