Documentation

docker pull g8kepr/api:latest
docker run -d \
  -e API_KEY=your_api_key \
  -e DATABASE_URL=postgresql://user:pass@db:5432/g8kepr \
  -p 8000:8000 \
  --name g8kepr \
  g8kepr/api:latest

curl -X POST https://api.g8kepr.com/v1/gateway/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{ "role": "user", "content": "Hello from G8KEPR!" }]
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-4o-mini",
  "choices": [{ "message": { "role": "assistant", "content": "Hello! How can I help?" } }],
  "g8kepr": {
    "threat_score": 0.01,
    "latency_ms": 312,
    "gateway_id": "gw_prod_01"
  }
}

from g8kepr import G8KPRClient

client = G8KPRClient(api_key="YOUR_API_KEY")

response = client.gateway.complete(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Explain zero-trust security"}],
)
print(response.choices[0].message.content)

{
  "rule_name": "block-high-risk-countries",
  "action": "block",
  "countries": ["CN", "RU", "KP", "IR"],
  "response_code": 403,
  "log": true
}

# All requests in a session share the same X-Session-ID
curl -X POST https://api.g8kepr.com/v1/gateway/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Session-ID: sess_abc123xyz" \
  -H "Content-Type: application/json" \
  -d '{ "model": "gpt-4o", "messages": [...] }'

{
  "allowed": false,
  "threat_score": 0.87,
  "decision": "block",
  "explanation": "Prompt injection pattern detected: role confusion + instruction override",
  "patterns_matched": [
    { "id": "PI-001", "name": "Role Confusion", "confidence": 0.92 },
    { "id": "PI-007", "name": "Instruction Override", "confidence": 0.81 }
  ],
  "session_escalation_factor": 2.0,
  "session_request_count": 4
}

curl https://api.g8kepr.com/v1/mcp/audit?session_id=sess_abc123xyz \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "strategy": "round_robin",
  "providers": ["openai", "anthropic", "cohere"],
  "health_check_interval_s": 30
}

import httpx

with httpx.stream("POST", "https://api.g8kepr.com/v1/gateway/completions",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"model": "gpt-4o", "messages": [...], "stream": True},
) as resp:
    for line in resp.iter_lines():
        if line.startswith("data: "):
            print(line[6:])  # SSE payload

brew tap g8kepr/tap
brew install g8kepr
g8kepr --version
# g8kepr v2.1.0

# Login with browser OAuth
g8kepr login

# Or supply API key directly
g8kepr login --api-key YOUR_API_KEY

# Verify auth status
g8kepr auth status
# Logged in as: wesley@example.com (org: acme-corp)

# All requests require Bearer token
curl https://api.g8kepr.com/v1/gateways \
  -H "Authorization: Bearer YOUR_API_KEY"

# Rotate a key (old key remains valid for 15 min)
curl -X POST https://api.g8kepr.com/v1/api-keys/rotate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "key_id": "key_abc123" }'

services:
  backend:
    image: g8kepr/api:2.1.0
    environment:
      DATABASE_URL: ${DATABASE_URL}
      REDIS_URL: ${REDIS_URL}
      SECRET_KEY: ${SECRET_KEY}
      API_ENCRYPTION_KEY: ${API_ENCRYPTION_KEY}
      ENVIRONMENT: production
      LOG_LEVEL: info
      WORKERS: 4
    env_file:
      - .env.production  # blocked from git by pre-commit hook

# Enable verbose logging
LOG_LEVEL=debug g8kepr serve

# Or set in environment
export LOG_LEVEL=debug
docker compose up backend

scrape_configs:
  - job_name: 'g8kepr'
    scrape_interval: 15s
    static_configs:
      - targets: ['g8kepr-backend:8000']
    metrics_path: /metrics
    bearer_token: YOUR_METRICS_TOKEN

# Import via Grafana CLI
grafana-cli dashboards import monitoring/grafana/dashboards/overview.json
grafana-cli dashboards import monitoring/grafana/dashboards/threats.json
grafana-cli dashboards import monitoring/grafana/dashboards/ai-gateway.json

# Or via API
curl -X POST http://grafana:3000/api/dashboards/import \
  -H "Authorization: Basic admin:admin" \
  -H "Content-Type: application/json" \
  -d @monitoring/grafana/dashboards/overview.json

{
  "level": "info",
  "time": "2026-03-31T14:22:01.432Z",
  "request_id": "req_xyz789",
  "org_id": "org_abc123",
  "gateway_id": "gw_prod_01",
  "method": "POST",
  "path": "/v1/completions",
  "status": 403,
  "duration_ms": 4,
  "threat_score": 0.91,
  "decision": "block",
  "pattern": "PI-001"
}