Open WebUI Integration
Connect Open WebUI to Antbase for a self-hosted ChatGPT alternative with intelligent model routing. All Antbase virtual models appear in the model selector, and every conversation gets automatic failover across 30+ providers.
What this enables
- Full ChatGPT-like UI with Antbase as the backend
- All virtual models available in the model dropdown
- Multi-user support with shared Antbase credentials
- Conversation history, file uploads, and web search built in
Quick Start
1. Run Open WebUI with Docker
docker run -d \
-p 3000:8080 \
-e OPENAI_API_BASE_URLS="https://antbase.ai/v1" \
-e OPENAI_API_KEYS="your-ant-api-key" \
-v open-webui:/app/backend/data \
--name open-webui \
ghcr.io/open-webui/open-webui:main2. Open the UI
Navigate to http://localhost:3000 and create an admin account. All Antbase models will appear in the model selector automatically.
Ready to chat
Select ant:auto from the model dropdown and start chatting.
Configuration
Admin Settings (UI)
You can also configure Antbase through the admin panel:
- Go to Admin Panel > Settings > Connections
- Under OpenAI API, set the URL to
https://antbase.ai/v1 - Enter your Antbase API key
- Click the refresh button to load available models
Docker Compose
# docker-compose.yml
version: '3'
services:
open-webui:
image: ghcr.io/open-webui/open-webui:main
ports:
- "3000:8080"
environment:
- OPENAI_API_BASE_URLS=https://antbase.ai/v1
- OPENAI_API_KEYS=your-ant-api-key
- DEFAULT_MODELS=ant:auto
volumes:
- open-webui:/app/backend/data
volumes:
open-webui:Usage Examples
Set a default model
In Admin > Settings > Interface, set the default model to ant:auto so new conversations start with intelligent routing.
Model presets for users
Create model presets with different system prompts and assign them virtual models:
- Quick Chat --
ant:fastfor casual questions - Deep Analysis --
ant:reasoningfor research tasks - Code Helper --
ant:coderfor programming assistance
Virtual Models
| Model | Best for | Notes |
|---|---|---|
| ant:auto | General use | Recommended default for all users |
| ant:fast | Quick questions | Snappy responses for casual chat |
| ant:best | Complex tasks | Frontier models for demanding prompts |
| ant:free | Testing | Zero cost for evaluation |
| ant:reasoning | Research, analysis | Deep reasoning with chain-of-thought |
| ant:coder | Programming | Code-optimized models |
See Virtual Models for the full list.
Troubleshooting
No models showing up
Click the refresh icon next to the OpenAI connection in admin settings. Verify the URL includes /v1 at the end.
Connection refused in Docker
If running Antbase locally, use host.docker.internal instead of localhost in the base URL.