Agora você pode subir um chat de IA sobre dados públicos da Colômbia, do Peru e do México sem construí-lo do zero. Croma Chat Template é um template open source feito com o AI SDK e o AI Elements da Vercel, conectado ao servidor MCP da Croma: o modelo consulta fontes judiciais, tributárias e de registros em tempo real e responde em streaming. Você pode testá-lo ao vivo em chat.usecroma.com antes de fazer o deploy do seu.
O que vem incluído#
- Ferramentas ao vivo: cada conversa expõe ao modelo o catálogo completo da Croma: Rama Judicial, SUNAT, RUES, SECOP e mais de 40 fontes.
- Streaming completo: texto, raciocínio e chamadas de ferramentas chegam token por token.
- Interface pronta: componentes do AI Elements com respostas em markdown, cards de ferramentas recolhíveis, modo escuro e rolagem que acompanha a conversa.
- Seletor de fontes: um buscador na caixa de mensagem (país, categoria, fonte) fixa uma ou várias ferramentas por mensagem, e você pode mudar o escopo no meio da conversa.
- Modelos intercambiáveis: roda com
claude-opus-5se você definirANTHROPIC_API_KEY, e comopenai/gpt-oss-120bno Groq se não definir. Trocar de provedor é editar um arquivo. - Limite de uso opcional: com duas variáveis do Upstash,
/api/chatfica limitado a 10 requisições por minuto por IP. Sem elas, o limitador não faz nada.
Deploy em um clique#
O botão Deploy with Vercel do repositório clona o projeto e pede as chaves no momento da criação. A chave da Croma é gratuita: você consegue a sua em platform.usecroma.com em um minuto.
| Variável | Obrigatória | Para quê |
|---|---|---|
CROMA_API_KEY | sim | autentica as ferramentas de dados ao vivo |
GROQ_API_KEY | uma das duas | roda openai/gpt-oss-120b no Groq |
ANTHROPIC_API_KEY | uma das duas | roda claude-opus-5, tem prioridade se as duas existirem |
Rodar localmente#
git clone https://github.com/croma-ai/croma-chat-template
cd croma-chat-template
pnpm install
cp .env.example .env.local
pnpm devA linha 4 cria o seu arquivo de variáveis: preencha CROMA_API_KEY e uma chave de modelo, abra http://localhost:3000 e teste uma das sugestões da tela inicial.
Feito para ser modificado#
O template é um ponto de partida, não uma caixa fechada. O modelo se troca em um arquivo e aceita qualquer provedor do AI SDK; o prompt de sistema, as sugestões e a taxonomia de fontes ficam em módulos próprios; o design são tokens do Tailwind que você pode substituir pelos da sua marca.
A API por trás do chat é a mesma de sempre: cada fonte está documentada na documentação, e você pode testar os endpoints sem escrever código nas ferramentas. E se preferir não fazer deploy de nada, o mesmo servidor MCP se conecta direto ao Claude, ao ChatGPT ou ao Cursor.