Self-hosting

# Clone the repository
git clone https://github.com/QWED-AI/qwed-verification.git
cd qwed-verification

# Start with Docker Compose
docker-compose up -d

# Check status
docker-compose ps

# .env file

# Required — server will not start without these
API_KEY_SECRET=your-generated-secret
QWED_CORS_ORIGINS=https://app.yourcompany.com

# Infrastructure
DATABASE_URL=postgresql://user:pass@localhost:5432/qwed
REDIS_URL=redis://localhost:6379

# LLM provider
ACTIVE_PROVIDER=openai
OPENAI_API_KEY=sk-...

# Required — server will not start without these
API_KEY_SECRET=your-generated-secret  # python -c "import secrets; print(secrets.token_urlsafe(48))"
QWED_CORS_ORIGINS=https://app.yourcompany.com

# config.py
SETTINGS = {
    "rate_limit_enabled": True,
    "rate_limit_per_minute": 60,
    "cache_ttl_seconds": 3600,
    "max_query_length": 10000,
    "allowed_engines": ["math", "logic", "code", "sql"],
}

FROM python:3.13-slim-bookworm
WORKDIR /app
COPY . .
RUN pip install -e .
EXPOSE 8000
CMD ["uvicorn", "qwed_new.api.main:app", "--host", "0.0.0.0"]

docker build -t qwed-api .
docker run -p 8000:8000 \
  -e QWED_API_KEY=... \
  -e API_KEY_SECRET=... \
  -e QWED_CORS_ORIGINS="https://app.yourcompany.com" \
  qwed-api

apiVersion: apps/v1
kind: Deployment
metadata:
  name: qwed-api
spec:
  replicas: 3
  selector:
    matchLabels:
      app: qwed-api
  template:
    metadata:
      labels:
        app: qwed-api
    spec:
      containers:
      - name: qwed
        image: qwed/qwed-api:latest
        ports:
        - containerPort: 8000
        env:
        - name: QWED_API_KEY
          valueFrom:
            secretKeyRef:
              name: qwed-secrets
              key: api-key

# Increase workers
uvicorn qwed_new.api.main:app --workers 4

# Enable connection pooling
export QWED_DB_POOL_SIZE=20

# Example: a larger host that runs more sandboxed verifications in parallel
export QWED_SANDBOX_MAX_CONCURRENT=8
export QWED_PROVIDER_TIMEOUT=45

curl http://localhost:8000/health

qwed_verification_total{engine="math", status="verified"}
qwed_verification_latency_seconds
qwed_cache_hit_rate

# prometheus scrape config
scrape_configs:
  - job_name: 'qwed-api'
    metrics_path: '/metrics/prometheus'
    static_configs:
      - targets: ['localhost:8000']
    http_headers:
      X-Api-Key:
        values: ['qwed_live_********************************wDHo']  # masked v2 example (see API key format) — render the real one from your secret pipeline