DEVUP Docs
Back to Dashboard

Integrations

Open WebUI

Open WebUI is a self-hosted chat interface. Connect it to DEVUP AI and your team chats with DEVUP AI models and asks questions about its own documents.

Requirements

Connect DEVUP AI in the Open WebUI admin panel

  1. Open Admin Panel → Settings → Connections.
  2. Under OpenAI API, add a connection with URL https://api.devupai.com/v1 and your DEVUP AI key as the Bearer token.
  3. Leave API Type on Chat Completions or switch it to Responses; DEVUP AI works with both. Click the refresh icon to verify, then save.
Open WebUI connections with the DEVUP AI endpoint enabled
Open WebUI Edit Connection dialog showing Server connection verified for DEVUP AI

Connection settings

SettingValue
URLhttps://api.devupai.com/v1
AuthBearer, your DEVUP AI key
API TypeChat Completions or Responses
Model IDsempty for the full catalog, or a list of IDs
Forward cookiesoff
Open WebUI Edit Connection with API Type set to Responses for DEVUP AI

Configure Open WebUI with environment variables

Set these variables before you start Open WebUI. This PowerShell example also starts it on your own machine only.

powershell
$env:OPENAI_API_BASE_URL = "https://api.devupai.com/v1"
$env:OPENAI_API_KEY = "YOUR_DEVUP_API_KEY"
$env:ENABLE_OLLAMA_API = "false"
$env:RAG_EMBEDDING_ENGINE = "openai"
$env:RAG_EMBEDDING_MODEL = "BAAI/bge-m3"
$env:RAG_OPENAI_API_BASE_URL = "https://api.devupai.com/v1"
$env:RAG_OPENAI_API_KEY = "YOUR_DEVUP_API_KEY"
uv tool run --python 3.12 --from open-webui open-webui serve --host 127.0.0.1

Environment variables

VariableValue
OPENAI_API_BASE_URLhttps://api.devupai.com/v1
OPENAI_API_KEYyour DEVUP AI key
ENABLE_OLLAMA_APIfalse
RAG_EMBEDDING_ENGINEopenai
RAG_EMBEDDING_MODELBAAI/bge-m3
RAG_OPENAI_API_BASE_URLhttps://api.devupai.com/v1
RAG_OPENAI_API_KEYyour DEVUP AI key

With RAG_EMBEDDING_ENGINE set to openai, Open WebUI creates document embeddings on DEVUP AI instead of downloading a local embedding model.

Chat with DEVUP AI models

Open WebUI model picker listing DEVUP AI models

Pick a model and send:

text
Reply with exactly: Salam DEVUP
Open WebUI replying Salam DEVUP on DeepSeek-V4-Pro through DEVUP AI

Use DEVUP AI embeddings for documents (RAG)

  1. Open Admin Panel → Settings → Documents.
  2. Set Embedding Model Engine to OpenAI, API Base URL to https://api.devupai.com/v1, your DEVUP AI key, and Embedding Model to BAAI/bge-m3.
  3. Upload a file in a chat and ask about it.
Open WebUI document settings using DEVUP AI embeddings with BAAI/bge-m3

Try it with this file:

text
DEVUP AI internal note.
The warehouse access code for the Oran branch is DZ-7719.
The Algiers branch opens at 8:30.
text
What is the warehouse access code for the Oran branch?
Open WebUI answering from an uploaded document with DEVUP AI embeddings and DeepSeek-V4-Pro

Open WebUI retrieved the file and answered DZ-7719, citing it as the source.

Show only the models your team needs

Open the connection's Advanced settings and add model IDs. Open WebUI then lists only those models; leave the list empty to show the full catalog.

Open WebUI model picker limited to two DEVUP AI models

Keep Open WebUI private

  • Start it with --host 127.0.0.1 to keep it on your own machine. By default it listens on all network interfaces.
  • Create the admin account right after the first start: the first account becomes the admin.
  • Keep Forward cookies off on the DEVUP AI connection.

Choosing models

Use exact catalog IDs for chat models and for the embedding model. See Models and Embeddings for the full catalog and specifications.

Troubleshooting

  • Open WebUI stops at first start with "memory allocation failed":It was downloading a local embedding model. Set RAG_EMBEDDING_ENGINE to openai with the DEVUP AI variables above, and embeddings run on DEVUP AI instead.
  • The reply appears only after reloading the page:The reply is saved in the chat. Reload the page to see it.
  • The model list is empty:Check that the URL is https://api.devupai.com/v1 and the key is correct, then click the refresh icon in Edit Connection. It should show Server connection verified.

FAQ

Does Open WebUI work with DEVUP AI?

Yes. Add an OpenAI API connection with URL https://api.devupai.com/v1 and your DEVUP AI key, and the DEVUP AI models appear in the model picker.

Can Open WebUI answer questions from my documents with DEVUP AI?

Yes. Set the embedding engine to OpenAI with the DEVUP AI URL and key, and use BAAI/bge-m3 as the embedding model.

How is Open WebUI usage billed on DEVUP AI?

Every chat and embedding request is a regular DEVUP AI API call, metered in Algerian Dinar on your account.

Can I limit which models my team sees?

Yes. Add the model IDs you want under the connection's Advanced settings. Leave the list empty to show the full catalog.

What is Arena Model in the model list?

A built-in Open WebUI feature for comparing models. It is not a DEVUP AI model.

Does Open WebUI work in Arabic?

Yes. Open WebUI follows the browser language, including Arabic.

Related integrations

  • n8n: Workflow automation with AI agents.
  • LlamaIndex: Retrieval and RAG pipelines in Python.
  • OpenAI SDK: OpenAI SDKs pointed at DEVUP AI.
  • Python: The official OpenAI Python SDK on DEVUP AI.