Asistente open source de trámites de la Ciudad de México. Preguntas algo como "¿cuánto cuesta renovar la licencia tipo A?" y recibes una respuesta corta en español, siempre con la liga oficial de donde salió. Si la respuesta no está en las fuentes oficiales, lo dice. Nunca inventa requisitos ni costos.
Proyecto para Hacktoberfest México. Licencia AGPL-3.0.
UI (TanStack Start, src/lib/ask.ts)
│ POST {question, history: últimas 3 interacciones}
▼
Edge function `ask` (supabase/functions/ask)
├─ si hay historial: Gemma 4 26b reescribe la pregunta como independiente
│ ("¿dónde puedo pagar?" → "¿Dónde pago la copia del acta de nacimiento?");
│ va en el header x-ventanilla-query (URL-encoded) para depurar
├─ embedding de la pregunta (gemini-embedding-2, 768 dims)
├─ buscar_docs(): búsqueda híbrida en Postgres
│ pgvector (coseno) + full-text en español, fusionados con RRF
│ (si el embedding falla, sigue funcionando solo con full-text)
├─ Gemma 4 vía Gemini API: responde SOLO con los fragmentos y cita [n]
├─ el servidor arma `sources` con los fragmentos citados
└─ sin fuente: si el tema está en `derivaciones` del config, agrega la
autoridad que lo atiende y su liga curada
▼
{answer, sources: [{titulo, url}], derivacion?: {autoridad, url}}
- Fuentes: páginas oficiales de
*.cdmx.gob.mx, descubiertas y rastreadas con Firecrawl porscripts/ingest.py, divididas en fragmentos y guardadas en la tabladocs. - Citas a prueba de alucinaciones: el modelo nunca escribe URLs. Solo cita
números de fragmento y el servidor los convierte en ligas reales de la base.
Si no cita nada o responde
NO_LO_SE,sourcesva vacío y la UI muestra "No encontré una fuente oficial". - Embeddings: se usa
gemini-embedding-2(multilingüe, misma llave que Gemma). Preferíamos un modelo open-weight, pero el modelo nativo de Supabase Edge (gte-small) solo sirve para inglés, y correr un e5 multilingüe dentro de la edge function con transformers.js hace lento el arranque y choca con el límite de memoria. Es una decisión pragmática para la hackathon.
- Copia
.env.examplea.envy llena las llaves..envestá en.gitignore: nunca lo subas. - Base de datos: aplica
supabase/migrations/*.sqla tu proyecto de Supabase (SQL editor osupabase db push). - Ingesta (requiere uv):
uv run scripts/ingest.py --discover # escribe scripts/urls.json para revisarlo uv run scripts/ingest.py --ingest # rastrea, divide, genera embeddings y carga a `docs`
- Edge function: define el secreto
GEMINI_API_KEYen Supabase (Edge Functions → Secrets) y despliegasupabase/functions/askconverify_jwt = false. - Frontend:
npm i && npm run dev. Para apuntar a otra función, usaVITE_ASK_URL.
⚠️ askes pública (no pide JWT) para que el frontend no necesite llaves. Cualquiera puede gastar la cuota de Gemini. Es aceptable para una demo, no para producción.
Para comparar modelos: uv run scripts/bench.py corre preguntas de prueba contra
gemma-4-31b-it y gemma-4-26b-a4b-it y muestra latencia, respuesta y fuentes.
Ventanilla no está atada a la CDMX: cualquier ciudad o estado con portales oficiales puede tener la suya.
-
Haz fork y edita
ventanilla.config.json.nombreaparece en "Hola, {nombre}";subtituloyejemplos(las preguntas que rotan en el buscador) son textos de la portada;repoes tu fork;dominios_permitidoslimita las fuentes, por ejemplo["jalisco.gob.mx"](se aceptan sus subdominios). Envoz(en construcción) van elvoice_idde ElevenLabs, unvoice_id_respaldoy ladescripcion_vozcon la que se diseñó en Voice Design, para que puedas recrear una voz equivalente para tu ciudad. Los IDs de voz no son secretos; el único secreto de voz esELEVENLABS_API_KEYy va en.env.En
derivacionescada institución define qué no le toca y a dónde mandar a la gente. Cada entrada tienetemas(palabras o frases), laautoridady unaurloficial que tú verificas:{ "temas": ["pasaporte"], "autoridad": "Secretaría de Relaciones Exteriores (SRE)", "url": "https://www.gob.mx/pasaporte" }Solo se usan cuando Ventanilla no encontró fuente propia: si un tema aparece en la pregunta (sin acentos ni mayúsculas, por palabra completa), la respuesta dice "Este trámite lo atiende {autoridad}" y muestra la liga. Una respuesta que sí tiene fuentes nunca se deriva, y el modelo nunca genera estas ligas. Mejor pocas derivaciones correctas que muchas dudosas: si no puedes verificar la URL, no la agregues.
-
Define tus trámites y descubre fuentes. Cambia
TRAMITESenscripts/ingest.pypor los de tu ciudad, correuv run scripts/ingest.py --discovery revisa a mano el archivo defuentes(scripts/urls.json): borra apps, noticias viejas y duplicados. -
Crea tu backend. En un proyecto nuevo de Supabase aplica
supabase/migrations/*.sql, llena.env, correuv run scripts/ingest.py --ingesty despliegasupabase/functions/askcon el secretoGEMINI_API_KEY(incluyeventanilla.config.jsonen el despliegue:askyvoicelo importan). Ajusta en el prompt de sistema deask/index.tsel nombre de tu ciudad y qué fuente manda en costos. -
Publica el frontend. Pon la URL de tu función en
VITE_ASK_URL, correnpm run buildy despliega donde quieras.
This project was built with Lovable.
Continue developing this project in the Lovable editor.
- Ship faster: describe what you want to build and Lovable handles the code.
- Stay in sync: every change made in Lovable is committed straight to this repository.
- Full ownership: this code is yours. Push to
mainon GitHub and your changes sync back into Lovable, ready for your next prompt.
Prefer working locally? You need Node.js and npm — install with nvm.
git clone <this-repository-url>
cd <repository-name>
npm i
npm run dev