Construye agentes de chat
con IA que de verdad son tuyos.

Chasqui es un stack open-source y self-hosted para agentes de chat con IA a medida: motor de conversación, memoria, RAG, handoff humano y un sistema de tools enchufable — todo cableado y listo, para que tu energía vaya a la lógica de tu agente. WhatsApp hoy, más canales en el roadmap.

$ uvx chasqui new my-agent

Apache-2.0 · beta · un comando crea y aprovisiona todo el stack

Panel de operación de Chasqui: una conversación con handoff humano, con mensajes de imagen y voz
Baterías incluidas

Todo lo que un agente necesita, ya cableado

Las decisiones de plomería ya están tomadas — Postgres + pgvector, un contrato de mensajes canónico, convención sobre configuración. Tú construyes lo que hace diferente a tu agente.

Motor de conversación

Un orquestador LangGraph mantiene un hilo continuo por contacto — contexto, manejo de silencios y errores de entrega ya están resueltos.

Memoria + RAG de FAQs

Memoria de largo plazo y una base de conocimiento de FAQs sobre Postgres + pgvector. Respuestas ancladas en tu contenido, no alucinaciones.

Multimodal, en ambos sentidos

Imágenes, documentos y notas de voz — entendidos a la entrada, enviados a la salida.

Inbox de handoff humano

El agente detecta cuándo hace falta una persona; los operadores toman el control y responden desde el panel, con multimedia incluida.

Tool Modules

Paquetes autocontenidos que el core descubre solo: tools, tablas, rutas y formularios de configuración que el panel renderiza gratis.

Cualquier LLM, un cambio de .env

Gemini, Claude, GPT, OpenRouter u Ollama local. Cambia de proveedor y el siguiente mensaje ya lo usa — sin redeploy.

Agnóstico al canal por diseño

El core nunca sabe que existe un canal

Los canales son gateways delgados y sin estado que traducen su plataforma a un contrato canónico — dos endpoints y ya agregaste un canal. Handoff, multimedia, silencios y errores de entrega se expresan una sola vez y todos los canales los heredan gratis.

Cada decisión no obvia queda escrita como un ADR — lee la arquitectura.

Panel de operación

Opera el agente sin tocar código

  • Edita el system prompt y mira el comportamiento cambiar en el siguiente mensaje
  • Cura la base de FAQs que ancla las respuestas del RAG
  • Configura los tool modules con formularios auto-renderizados
  • Mira las conversaciones en vivo y toma el control cuando importa
  • Captura y revisa leads
Dashboard del panel de Chasqui en modo oscuro Una conversación completa: respuestas de la IA, handoff humano y toma de control del operador
Quickstart

De cero a un agente corriendo

1

Crea el proyecto

uvx chasqui new my-agent

El wizard pregunta: LLM, embeddings, Postgres, puertos, credenciales de WhatsApp (opcional), idioma, primer admin — y aprovisiona dependencias, base de datos y migraciones.

2

Levanta los servicios

cd core && make dev
cd whatsapp && make dev
cd admin && npm run dev

API, gateway de WhatsApp y panel de operación — cada uno con una línea.

3

Conecta WhatsApp

docs/WHATSAPP-SETUP.md

Una app gratuita de Meta developers basta para empezar. Guía paso a paso incluida, con registro automático del webhook vía ngrok en dev.

Prerequisitos: uv, Node 22 y PostgreSQL con pgvector (o el docker-compose generado).

Roadmap

Hacia dónde va esto

Canal de Telegram un segundo gateway que habla el mismo contrato
Widget de chat web canal embebible para cualquier sitio
Analytics módulo de estadísticas de conversación para el panel
RAG de documentos base de conocimiento más allá de FAQs — PDFs, docs

Issues e ideas bienvenidos — súmate en GitHub.

Contacto

¿Quieres que construyamos tu agente?

Construimos agentes a medida sobre Chasqui y ayudamos a equipos a poner el suyo en marcha. Bugs e ideas van a los issues de GitHub — para todo lo demás, hablemos: