Testing with Open WebUI

Open WebUI is a popular open-source chat interface that can be used to manually test the Gamaliel Public API. It provides a user-friendly interface similar to ChatGPT.

Quick Setup

  1. Install Docker Desktop (if not already installed)

  2. Create a directory for Open WebUI: 
    mkdir open-webui-gamaliel
cd open-webui-gamaliel
  3. Create docker-compose.yml: 
    services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    environment:
      - OPENAI_API_BASE_URL=https://api.gamaliel.ai/v1
    restart: unless-stopped
    volumes:
      - open-webui-data:/app/backend/data

volumes:
  open-webui-data:
  4. Start Open WebUI: 
    docker-compose up -d
  5. Access Open WebUI:
    • Open http://localhost:3000 in your browser
    • Sign in or create an account
  6. Configure API Connection:
    • Go to Admin Panel → Settings → Connections
    • Enable the “Direct Connections” toggle
    • Click the gear icon next to “Manage OpenAI API Connections”
    • Add/edit connection:
      • API Base URL: https://api.gamaliel.ai/v1
      • Save the connection
  7. Configure Your API Key:
    • Go to Settings (user menu in top right)
    • Add your OpenAI API key for OpenAI models, or your Anthropic key (sk-ant-...) if your client lists anthropic/... models from Gamaliel
    • Select a model from the dropdown (e.g., gpt-4.1-mini or anthropic/claude-sonnet-4-20250514 when exposed by GET /v1/models)
  8. Test:
    • Start a new chat
    • Ask a biblical question (e.g., “What does the Bible say about forgiveness?”)
    • Verify the response includes biblical citations and context

Useful Commands

View logs:

docker-compose logs -f

Stop:

docker-compose down

Stop and reset data:

docker-compose down -v

Notes

  • Open WebUI uses Direct Connections mode, so each user provides their own provider API key (OpenAI and/or Anthropic, matching the model)
  • The API Base URL should be https://api.gamaliel.ai/v1 (production) or http://host.docker.internal:8000/v1 (local development)
  • Gamaliel’s model list comes from GET /v1/models; OpenAI and Anthropic rows depend on server configuration (OPENAI_API_KEY / ANTHROPIC_API_KEY)
  • Models are automatically fetched from /v1/models endpoint