Chat UI documentation

Problemas comuns

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Problemas comuns

403: Você não tem acesso a esta conversa

Isso geralmente acontece ao executar a Chat UI via HTTP sem a configuração adequada de cookies.

Recomendado: Configure um proxy reverso (NGINX, Caddy) para lidar com HTTPS.

Alternativa: Se você precisar executar via HTTP, defina a seguinte variável de ambiente:

COOKIE_SECURE=false

Isso define automaticamente COOKIE_SAMESITE como lax, que é o valor correto para implantações HTTP.

Também verifique se PUBLIC_ORIGIN corresponde à sua URL real:

PUBLIC_ORIGIN=http://localhost:5173

Modelos não carregando

Se os modelos não estiverem aparecendo na interface:

  1. Verifique se OPENAI_BASE_URL está correto e acessível
  2. Verifique se OPENAI_API_KEY é válido
  3. Certifique-se de que o endpoint retorne os modelos em ${OPENAI_BASE_URL}/models

Erros de conexão com o banco de dados

Para desenvolvimento, você pode ignorar o MongoDB por completo - a Chat UI usará um banco de dados embutido.

Para produção, verifique:

  • MONGODB_URL é uma string de conexão válida
  • Seu IP está na lista de permissões (para o MongoDB Atlas)
  • O usuário do banco de dados tem permissões de leitura/escrita
Update on GitHub