Crear informes y paneles de datos con un agente de programación

A quién le sirve. Analistas de datos y equipos con una base de datos o un almacén de datos que quieren que un agente de programación responda preguntas y publique informes y paneles con gráficos.

Qué hicieron

Graphene es una herramienta de línea de comandos de npm que se añade a un proyecto, solo o dentro de un repositorio como dbt. Se definen los modelos semánticos (los nombres y las reglas de negocio de los datos) en archivos .gsql y las páginas en archivos markdown. Se arranca el servidor de desarrollo y se pide al agente de programación que responda una pregunta, cree un panel o edite el modelo. El agente escribe consultas GSQL y componentes de gráficos, y la herramienta comprueba la sintaxis, genera las páginas e imprime capturas para que el agente pueda iterar.

Cómo salió

La fuente no da resultados medidos. Afirma que el análisis es 10 veces más rápido y que las páginas se ven coherentes por defecto, y lista Snowflake, BigQuery, ClickHouse, Postgres, MotherDuck y DuckDB como orígenes admitidos.

Conviene saber

La licencia Elastic License 2.0 permite solo uso interno gratuito. Construir un producto comercial encima exige un acuerdo aparte, y para usarlo sin Graphene Cloud hacen falta git y un agente de programación.

Qué necesitas

• Un agente de programación, como Claude Code o Codex
• Node.js y git instalados en tu ordenador (Graphene se instala con npm, el gestor de paquetes de Node)
• Tus datos en un almacén o base de datos compatible, como Postgres o BigQuery, con un acceso de solo lectura
• Una pregunta de negocio concreta que quieras responder
• Alguien que sepa revisar consultas, o tiempo para comprobar a mano algunas cifras

Cómo hacerlo tú, paso a paso

1. Añade Graphene a tu proyecto siguiendo las instrucciones de su repositorio, que es la página donde está publicado su código. Puede ir solo o dentro de un repositorio que ya uses.
2. Define el modelo semántico en archivos .gsql: las tablas, métricas y relaciones clave de tu área. Es el diccionario con los nombres y las reglas de negocio de tus datos.
3. Conecta tu almacén de datos con un usuario que solo pueda leer.
4. Arranca el servidor de desarrollo y pide al agente de programación una pregunta, un panel o un cambio en el modelo.
5. Deja que el agente escriba las consultas y los gráficos. La herramienta comprueba la sintaxis, genera las páginas y devuelve capturas para que el agente corrija solo.
6. Abre el informe y comprueba que cada gráfico indica la consulta que lo respalda. Verifica una o dos cifras con una consulta tuya.

Ayúdame a crear un informe de análisis de datos a partir de [mi almacén de datos o mis archivos, por ejemplo una base Postgres o una carpeta de CSV]. Primero define en archivos una capa semántica sencilla, con las tablas, métricas y relaciones clave de [mi área de negocio]. Después consulta los datos, responde a [mi pregunta principal] y publica un panel o informe con gráficos como archivos en esta carpeta. Habrás terminado cuando yo pueda abrir el informe y cada gráfico indique la consulta que lo respalda. Pregúntame antes de ejecutar nada que escriba en la base de datos.

Consejos

• Usa siempre un usuario de base de datos de solo lectura. El agente no necesita escribir para analizar.
• La licencia gratuita es solo para uso interno. Si quieres construir un producto comercial encima, hace falta un acuerdo aparte.
• Escribe bien el modelo semántico. Si los nombres y reglas no están claros, el agente inventará su propia interpretación.

Preguntas frecuentes

Fuentes

• graphene-data/graphene en GitHub ↗
• La conversación en Hacker News, 1 de octubre de 2026 ↗

En el directorio desde el 5 de octubre de 2026.