Repolode
huggingface

huggingface/chat-ui

Uma interface de chat em SvelteKit para LLMs, compatível com qualquer API compatível com OpenAI e baseada no código do HuggingChat.

Alternativa open source a:ChatGPT

Estrelas
10,990
Forks
1,721
Issues abertas
316
Último commit
há 13 horas

O que é?

O Chat UI é uma interface web de chat para grandes modelos de linguagem, criada com SvelteKit e TypeScript. É a base de código do app HuggingChat em hf.co/chat e pode ser executado localmente ou hospedado por você para usar seus próprios modelos.

O app se comunica apenas com APIs compatíveis com OpenAI. Configure OPENAI_BASE_URL e OPENAI_API_KEY para conectá-lo ao roteador Hugging Face Inference Providers, a um servidor local do llama.cpp ou Ollama, ao OpenRouter ou a serviços semelhantes. Os modelos disponíveis são detectados pela rota /models do endpoint. O histórico de conversas, os usuários, as configurações e os arquivos são armazenados no MongoDB, que pode ser um cluster gerenciado no Atlas, um container local ou uma instância embarcada usada quando nenhuma string de conexão é definida.

Entre os recursos opcionais estão a chamada de ferramentas MCP por meio de servidores Model Context Protocol configurados, um roteador no servidor que escolhe um modelo para cada mensagem (por exemplo, encaminhando entradas de imagem para um modelo multimodal), a personalização do tema pelas variáveis PUBLIC_APP_* e um modo experimental ML Intern para executar tarefas de machine learning no Hugging Face Hub.

Recursos principais

  • 01Conecta-se a qualquer API compatível com OpenAI por meio de OPENAI_BASE_URL.
  • 02Detecta modelos pela rota /models do endpoint.
  • 03Armazena o histórico de conversas e as configurações no MongoDB, com uma alternativa embarcada para desenvolvimento local.
  • 04Oferece suporte a servidores MCP para chamada de ferramentas com function calling da OpenAI.
  • 05Inclui um roteador Omni opcional que escolhe um modelo para cada mensagem.
  • 06Permite personalizar o nome do app, os recursos visuais e a descrição por meio de variáveis de ambiente.

Casos de uso

  • Executar uma interface no estilo ChatGPT conectada a um servidor próprio de llama.cpp ou Ollama.
  • Criar uma interface de chat interna para uma equipe que usa um gateway compatível com OpenAI.
  • Usar como ponto de partida para um app de chat personalizado em SvelteKit com histórico armazenado no MongoDB.
  • Testar ferramentas MCP com diferentes modelos em uma única interface de chat.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/huggingface/chat-ui
  2. 2

    Acesse a pasta do projeto

    cd chat-ui
  3. 3

    Instale as dependências

    npm install
  4. 4

    Crie o arquivo .env.local com OPENAI_BASE_URL e OPENAI_API_KEY; em seguida, inicie o servidor de desenvolvimento e abra o navegador

    npm run dev -- --open

Antes de usar

  • Funciona apenas com APIs compatíveis com OpenAI; as integrações específicas de provedores foram removidas.
  • É necessário um endpoint de API e uma chave, como um token do Hugging Face ou um servidor local do llama.cpp ou Ollama.
  • O histórico de chat e as configurações precisam do MongoDB, mas uma base de dados embarcada alternativa é usada quando nenhuma URL é definida.

Tópicos

Perguntas frequentes

O que é chat-ui?
Uma interface de chat em SvelteKit para LLMs, compatível com qualquer API compatível com OpenAI e baseada no código do HuggingChat. O Chat UI é uma interface web de chat para grandes modelos de linguagem, criada com SvelteKit e TypeScript. É a base de código do app HuggingChat em hf.co/chat e pode ser executado localmente ou hospedado por você para usar seus próprios modelos.
chat-ui é gratuito? Qual é a licença?
chat-ui é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
chat-ui ainda é mantido?
Manutenção ativa. O último commit de chat-ui foi em 20 de out. de 2026.
Para que posso usar chat-ui?
Executar uma interface no estilo ChatGPT conectada a um servidor próprio de llama.cpp ou Ollama. Criar uma interface de chat interna para uma equipe que usa um gateway compatível com OpenAI. Usar como ponto de partida para um app de chat personalizado em SvelteKit com histórico armazenado no MongoDB. Testar ferramentas MCP com diferentes modelos em uma única interface de chat.
Como instalar chat-ui?
Clone o repositório: git clone https://github.com/huggingface/chat-ui Acesse a pasta do projeto: cd chat-ui Instale as dependências: npm install Crie o arquivo .env.local com OPENAI_BASE_URL e OPENAI_API_KEY; em seguida, inicie o servidor de desenvolvimento e abra o navegador: npm run dev -- --open
Onde consigo chat-ui?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/huggingface/chat-ui

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados