Chat UI documentation
Interface de chat
Interface de chat
Interface de chat de código aberto com suporte a ferramentas, entradas multimodais e roteamento inteligente entre modelos. O aplicativo usa MongoDB e SvelteKit nos bastidores. Experimente a versão ao vivo chamada HuggingChat em hf.co/chat ou configure sua própria instância.
A interface de chat se conecta a qualquer endpoint de API compatível com a OpenAI, funcionando com:
- Provedores de Inferência do Hugging Face
- Ollama
- llama.cpp
- OpenRouter
- Qualquer outro serviço compatível com a OpenAI
Ferramentas MCP: Chamadas de função via servidores do Model Context Protocol (MCP)
LLM Router: roteamento inteligente para selecionar o melhor modelo para cada solicitação
Multimodal: Uploads de imagens em modelos que suportam visão
OpenID: Autenticação de usuário opcional via OpenID Connect
Início rápido
Etapa 1 - Crie .env.local:
OPENAI_BASE_URL=https://router.huggingface.co/v1
OPENAI_API_KEY=hf_************************Você pode usar qualquer endpoint compatível com a OpenAI:
| Provedor | OPENAI_BASE_URL | OPENAI_API_KEY |
|---|---|---|
| Hugging Face | https://router.huggingface.co/v1 | hf_xxx |
| Ollama | http://127.0.0.1:11434/v1 | ollama |
| llama.cpp | http://127.0.0.1:8080/v1 | sk-local |
| OpenRouter | https://openrouter.ai/api/v1 | sk-or-v1-xxx |
Etapa 2 - Instalar e executar:
git clone https://github.com/huggingface/chat-ui
cd chat-ui
npm install
npm run dev -- --openÉ isso! A Chat UI descobrirá automaticamente os modelos disponíveis a partir do seu endpoint.
MongoDB é opcional para desenvolvimento. Quando
MONGODB_URLnão está definido, o Chat UI usa um banco de dados embutido que persiste em./db.
Para implantações em produção, consulte os guias de instalação.
Update on GitHub