VibeOS Bootstrap Groq Proxy

API-only service. No browser UI. Hands out free 300-message bootstrap tokens to fresh VibeOS installs so Vibbey (the 3D AI assistant) has a smart backend before the user has signed up for their own Groq key.

Endpoints

GET /health

Service status and call counters.

curl https://groq.mwmai.no/health

POST /bootstrap

Issue a fresh 300-message token. Optional label in the body.

curl -X POST https://groq.mwmai.no/bootstrap \
  -H "Content-Type: application/json" \
  -d '{"label":"my-vibeos-laptop"}'

POST /v1/chat/completions

OpenAI-compatible chat. Requires Authorization: Bearer <bootstrap-token>. Response headers include X-Bootstrap-Remaining and X-Bootstrap-Quota so clients can warn the user as they approach zero.

curl -X POST https://groq.mwmai.no/v1/chat/completions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"hello"}]}'

Source

github.com/Matswm86/vibeos/tree/main/services/groq-proxy

Part of the VibeOS project — free OSS Linux distro with a 3D AI assistant.