Chat UI documentation
Chat UI
Chat UI
Open source chat interface with support for tools, multimodal inputs, and intelligent routing across models. The app uses MongoDB and SvelteKit behind the scenes. Try the live version called HuggingChat on hf.co/chat or setup your own instance.
Chat UI connects to any OpenAI-compatible API endpoint, making it work with:
- Hugging Face Inference Providers
- Ollama
- llama.cpp
- OpenRouter
- Any other OpenAI-compatible service
MCP Tools: Function calling via Model Context Protocol (MCP) servers
LLM Router: Intelligent routing to select the best model for each request
Multimodal: Image uploads on models that support vision
OpenID: Optional user authentication via OpenID Connect
Quickstart
Step 1 - Create .env.local:
OPENAI_BASE_URL=/static-proxy?url=https%3A%2F%2Frouter.huggingface.co%2Fv1
OPENAI_API_KEY=hf_************************You can use any OpenAI-compatible endpoint:
| Provider | OPENAI_BASE_URL | OPENAI_API_KEY |
|---|---|---|
| Hugging Face | /static-proxy?url=https%3A%2F%2Frouter.huggingface.co%2Fv1%3C%2Fcode%3E%3C%2Ftd%3E%3Ctd%3E%3Ccode%3Ehf_xxx%3C%2Fcode%3E%3C%2Ftd%3E%3C%2Ftr%3E%3Ctr%3E%3Ctd%3EOllama%3C%2Ftd%3E%3Ctd%3E%3Ccode%3Ehttp%3A%2F%2F127.0.0.1%3A11434%2Fv1%3C%2Fcode%3E%3C%2Ftd%3E%3Ctd%3E%3Ccode%3Eollama%3C%2Fcode%3E%3C%2Ftd%3E%3C%2Ftr%3E%3Ctr%3E%3Ctd%3Ellama.cpp%3C%2Ftd%3E%3Ctd%3E%3Ccode%3Ehttp%3A%2F%2F127.0.0.1%3A8080%2Fv1%3C%2Fcode%3E%3C%2Ftd%3E%3Ctd%3E%3Ccode%3Esk-local%3C%2Fcode%3E%3C%2Ftd%3E%3C%2Ftr%3E%3Ctr%3E%3Ctd%3EOpenRouter%3C%2Ftd%3E%3Ctd%3E%3Ccode%3Ehttps%3A%2F%2Fopenrouter.ai%2Fapi%2Fv1%3C%2Fcode%3E%3C%2Ftd%3E%3Ctd%3E%3Ccode%3Esk-or-v1-xxx%3C%2Fcode%3E%3C%2Ftd%3E%3C%2Ftr%3E%3C%2Ftbody%3E%3C%2Ftable%3E |