Ya puedes levantar un chat de IA sobre datos públicos de Colombia, Perú y México sin construirlo desde cero. Croma Chat Template es una plantilla open source hecha con el AI SDK y AI Elements de Vercel, conectada al servidor MCP de Croma: el modelo consulta fuentes judiciales, tributarias y registrales en tiempo real y responde en streaming. Puedes probarla en vivo en chat.usecroma.com antes de desplegar la tuya.
Qué incluye#
- Herramientas en vivo: cada conversación le expone al modelo el catálogo completo de Croma: Rama Judicial, SUNAT, RUES, SECOP y más de 40 fuentes.
- Streaming completo: texto, razonamiento y llamadas a herramientas llegan token por token.
- Interfaz terminada: componentes de AI Elements con respuestas en markdown, tarjetas de herramientas plegables, modo oscuro y scroll que sigue la conversación.
- Selector de fuentes: un buscador en el compositor (país, categoría, fuente) fija una o varias herramientas por mensaje, y puedes cambiar el alcance a mitad de conversación.
- Modelos intercambiables: corre con
claude-opus-5si definesANTHROPIC_API_KEY, y conopenai/gpt-oss-120ben Groq si no. Cambiar de proveedor es editar un archivo. - Límite de uso opcional: con dos variables de Upstash,
/api/chatqueda limitado a 10 solicitudes por minuto por IP. Sin ellas, el limitador no hace nada.
Desplegar en un clic#
El botón Deploy with Vercel del repositorio clona el proyecto y pide las llaves al momento de crearlo. La de Croma es gratis: se obtiene en platform.usecroma.com en un minuto.
| Variable | Requerida | Para qué |
|---|---|---|
CROMA_API_KEY | sí | autentica las herramientas de datos en vivo |
GROQ_API_KEY | una de las dos | corre openai/gpt-oss-120b en Groq |
ANTHROPIC_API_KEY | una de las dos | corre claude-opus-5, tiene prioridad si ambas existen |
Correrlo local#
git clone https://github.com/croma-ai/croma-chat-template
cd croma-chat-template
pnpm install
cp .env.example .env.local
pnpm devLa línea 4 crea tu archivo de variables: llena CROMA_API_KEY y una llave de modelo, abre http://localhost:3000 y prueba una de las sugerencias del inicio.
Hecho para modificarse#
La plantilla es un punto de partida, no una caja cerrada. El modelo se cambia en un archivo y acepta cualquier proveedor del AI SDK; el prompt del sistema, las sugerencias y la taxonomía de fuentes viven en módulos propios; el diseño son tokens de Tailwind que puedes reemplazar por tu marca.
La API que alimenta el chat es la misma de siempre: cada fuente está documentada en la documentación y puedes probar los endpoints sin escribir código en las herramientas. Y si prefieres no desplegar nada, el mismo servidor MCP se conecta directo a Claude, ChatGPT o Cursor.