AmoxSQL
El Códice Moderno para el Análisis Local de Datos.
Un IDE de datos local-first, de alto rendimiento, construido desde Latinoamérica para la comunidad global.
🌐 English · Español
AmoxSQL es un IDE de datos de escritorio construido para DuckDB: una mesa de trabajo local donde entran archivos, se analizan y se explican, y salen como un Excel, una presentación o un proceso que corre solo. Para analistas e ingenieros de datos que necesitan velocidad y privacidad: tus datos, el motor y hasta la IA viven en tu máquina.
✨ Capacidades
| Qué hace | Guía |
|---|
| Editor SQL | Monaco con autocompletado que conoce tu esquema real (las columnas de cada alias, las CTE, tus métricas como funciones), depuración de CTE, variables, historial y snippets. | → |
| Cuadernos | .sqlnb en markdown: cada celda deja una vista con su nombre, la siguiente la lee y Refresh las corre en orden de dependencias. Parámetros, borradores, exporta a Word y HTML. | → |
| Canvas | Un lienzo infinito para pensar un análisis: fuentes, consultas, gráficos, cifras y notas conectadas por lo que lee cada consulta. Se presenta por marcos y sale a un deck, un cuaderno o un proceso. | → |
| Story Flow | Gráficos que dicen algo: 17 tipos en 6 etapas (tipo, datos, formato, estilo, historia, exportar), con conclusión, anotaciones y líneas de meta. | → |
| Report Flow | Presentaciones .amoxdeck con gráficos que se refrescan contra los datos; exporta a PowerPoint editable y Word. | → |
| Los datos donde están | Fuentes con nombre sobre un archivo, una carpeta de archivos mensuales, un bucket o un lago, con un contrato que detiene un proceso si el cliente cambia una columna. | → |
| Data Flow | Procesos visuales (37 tipos de paso): de la fuente a un Excel con formato, a la plantilla del cliente o a un Parquet publicado. Parámetros con tipo, formularios y lotes. | → |
| Que corra solo | Programación (días hábiles, el N-ésimo hábil, al llegar un archivo), avisos, ficha de cada ejecución y el panel de Operations. | → |
| Workspaces | Agrupa proyectos por cliente, equipo o marca: contexto, métricas y snippets compartidos, política de IA por cliente y lo que necesita atención. | → |
| dbt y DuckLake | dbt dentro del editor (barra del modelo, vista previa, completado, linaje con resultados) y lagos DuckLake con versiones y «como estaba». | → |
| IA agéntica | Asistente en el editor y Deep Dive, con tu contexto (métricas, uniones, glosario). 100 % local con Ollama o en la nube. | → |
| Perfil y plan | Perfilado con hallazgos (duplicados, atípicos, huecos) y el plan de ejecución real con pistas. | → |
🧭 Un caso real: el cierre de ventas
El proyecto de ejemplo recorre un caso completo con datos reales: una tienda en línea manda un CSV de ventas cada mes y Finanzas sus metas en Excel. En un solo proyecto: una fuente con nombre y su contrato, una base modelada, ocho consultas, un cuaderno, gráficos, un Canvas, la presentación del comité y un cierre en Data Flow programado para el tercer día hábil que entrega un Excel de dos hojas.
📚 Documentación
La guía completa (bilingüe ES/EN) vive en docs/:
⬇️ Instalación
Descargar: los instaladores están en GitHub Releases.
- Windows —
AmoxSQL Setup <versión>.exe (NSIS, sin firmar: Windows puede pedirte confirmación).
- macOS (Apple Silicon · M1–M4) —
AmoxSQL-<versión>-arm64.dmg. ⚠️ Beta sin verificar en hardware Mac real — pruébalo y danos feedback. Primer arranque: xattr -cr /Applications/AmoxSQL.app (ver guía).
Compilar desde fuente (siempre gratis): requiere Node.js 22.13+, pnpm 11+ y herramientas de C++.
git clone https://github.com/dsandovalflavio/amoxsql.git && cd amoxsql
pnpm install && pnpm --dir client install
pnpm start
Guía completa: Instalación.
🆕 Novedades
La versión actual es v5.15.0 — El Canvas: un lienzo infinito para pensar un análisis, con tarjetas conectadas por lo que lee cada consulta, una foto que abre sin ejecutar nada y salida a un deck, un cuaderno o un proceso. Reúne además todo lo hecho desde la 5.10: los datos donde están (fuentes con nombre, carpetas, buckets, lagos), procesos que corren solos (programación, Excel y plantillas, parámetros, Operations), dbt y DuckLake dentro del editor, flujos fiables (contratos de fuente, «Needs attention», métricas como funciones) y el día a día (donde lo dejaste, proyectos en un archivo, comparar entregas).
Historial completo en CHANGELOG.md.
📜 El nombre
"Amox" viene del náhuatl Amoxtli ("libro" o "códice"). En Mesoamérica, los códices registraban conocimiento — historia, cálculos, saber. AmoxSQL es un códice digital moderno para la era de los datos: transforma datos crudos y opacos en visualizaciones claras y luminosas. El glifo luminoso fusiona estructura antigua y energía moderna.
🛠️ Tech Stack
Escritorio (Electron) · Frontend React + Vite + Monaco + Recharts · Backend Node.js + Express · Motor DuckDB · IA Ollama (local) + nube (Google Gemini, Anthropic, OpenAI, Google Vertex) vía Vercel AI SDK.
Más en Arquitectura.
❤️ Sponsor
AmoxSQL lo construye y mantiene un desarrollador solo desde Latinoamérica. Si te resulta útil, considera patrocinarlo. Los sponsors obtienen instaladores pre-construidos, acceso anticipado, prioridad en features y canal directo.
👉 Conviértete en Sponsor
⚖️ Licencia
Source-available bajo la AmoxSQL Community License. Puedes ver, modificar y compilar el código para uso personal o educativo. La redistribución comercial y el uso SaaS están prohibidos. Ver LICENSE.
"AmoxSQL" y su logo son marcas de Flavio Sandoval.
🤝 Contribuir
¡Bienvenidas las contribuciones! Ver CONTRIBUTING.md. Al contribuir, aceptas licenciar tu aporte bajo la AmoxSQL Community License.
