regionroute

README

RegionRoute

Data residency routing for GDPR.

RegionRoute routes requests to region-specific provider endpoints based on tenant, header, or IP geolocation. Keep EU data in EU.

Quickstart

export OPENAI_API_KEY=sk-...
npx @stockyard/regionroute

# Your app:   http://localhost:5920/v1/chat/completions
# Dashboard:  http://localhost:5920/ui

What You Get

• Region-based request routing
• Header/tenant/IP geolocation routing
• Map regions to endpoints
• ComplianceLog integration
• GDPR data residency compliance
• Dashboard with regional traffic

Config

# regionroute.yaml
port: 5920
providers:
  openai_us:
    base_url: https://api.openai.com/v1
    api_key: ${OPENAI_API_KEY}
  openai_eu:
    base_url: https://eu.api.openai.com/v1
    api_key: ${OPENAI_API_KEY_EU}
regionroute:
  rules:
    - region: EU
      provider: openai_eu
    - region: "*"
      provider: openai_us
  detect_by: header  # header | ip | tenant

Docker

docker run -p 5920:5920 -e OPENAI_API_KEY=sk-... stockyard/regionroute

Part of Stockyard

RegionRoute is part of Stockyard — an open-source LLM proxy and control plane. MIT licensed.

Documentation

Overview

RegionRoute — Stockyard Phase 3 P2 product.