Graphify: un mapa navegable para que un agente entienda un repositorio
Graphify-Labs/graphify · 121.350★ · 11.696 forks
Todo lo que hay que saber sobre safishamsi/graphify, hoy redirigido a Graphify-Labs/graphify: una habilidad y CLI que transforma código y materiales asociados en un grafo de conocimiento consultable.
Qué es Graphify
Graphify convierte un directorio en un grafo de conocimiento local. Para código usa análisis sintáctico determinista con Tree-sitter; para documentación, PDF, imágenes, vídeo y audio ofrece un pase semántico a través del modelo del asistente o de una clave configurada. El resultado se guarda en graphify-out/ como graph.html, GRAPH_REPORT.md y graph.json.
La propuesta no es un índice vectorial: el README y el sitio lo contrastan explícitamente con RAG y la búsqueda por texto. Cada relación conserva procedencia: EXTRACTED si sale explícitamente de la fuente, INFERRED si Graphify la resuelve, y en algunos resultados AMBIGUOUS. El objetivo es que un asistente recorra y pueda justificar una ruta, en lugar de releer o buscar fragmentos del repositorio en cada sesión.

El origen: de una idea de Karpathy a un proyecto y una empresa
El repositorio original safishamsi/graphify fue creado el 3 de abril de 2026 según la API de GitHub. La página oficial sitúa la chispa conceptual en una publicación de Andrej Karpathy sobre una «wiki» legible por modelos para que el asistente no tuviera que deducir la estructura del código desde cero cada sesión; Graphify se presenta como su interpretación abierta y local de esa idea.
El perfil de GitHub de Safi (safishamsi) se identifica como fundador y director ejecutivo de Graphify Labs. La empresa creó su organización de GitHub el 28 de junio de 2026; actualmente la URL histórica redirige a Graphify-Labs/graphify. La transición deja una señal útil de su evolución: pasó de un repositorio personal a una organización y a una plataforma comercial en acceso anticipado, mientras el CLI continúa bajo licencia Apache-2.0.

Hay evidencia contemporánea del lanzamiento, aunque no una crónica independiente extensa. El 6 de abril de 2026, tanelpoder abrió el hilo de Hacker News 47668188, que describía la habilidad para convertir carpetas en grafos consultables. Dos días después, en 47696872, lilwing, autor de Ix, atribuyó el interés inicial a una publicación de Karpathy y dijo que Graphify había sido construido en 48 horas. Es una afirmación del autor de un proyecto competidor, no una medición independiente ni una prueba de la cronología exacta.
Filosofía y principios
- Local primero para el código. El análisis de archivos de código se realiza con AST de Tree-sitter, sin modelo ni salida de código de la máquina. La documentación y los medios son la frontera opcional que puede requerir un proveedor de modelos.
- Trazabilidad antes que una respuesta opaca. Las aristas tienen etiquetas de procedencia y los comandos
pathyexplainmuestran conexiones y fuentes. - Estructura, no similitud. El producto defiende un grafo de entidades y relaciones frente a fragmentos vectoriales o resultados de
grep. - Persistencia para el equipo.
graphify-out/está pensado para versionarse; el proyecto ofrece un gancho de Git para reconstruir el mapa e integración de fusión paragraph.json.
Estas son posiciones del proyecto, no una demostración independiente de que un grafo supere a RAG o a la búsqueda convencional en todos los repositorios.

Cómo funciona
La instalación recomendada es:
uv tool install graphifyy
# o: pipx install graphifyy
graphify install
El paquete se llama graphifyy en PyPI, con dos letras y; el ejecutable se llama graphify. Después, el flujo mínimo es /graphify . dentro del asistente. Para limitar el alcance al repositorio se puede usar graphify install --project; la instalación crea una habilidad y, según la plataforma, un archivo de instrucciones o un gancho.

El README documenta adaptadores para Claude Code, CodeBuddy, Codex, OpenCode, Kilo Code, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Cursor, Gemini CLI, Hermes, Kimi Code, Amp, Agent Skills, Kiro, Pi, Devin CLI y Google Antigravity. En Claude Code y Gemini CLI los ganchos orientan las búsquedas hacia el grafo; en plataformas como Codex, OpenCode o Cursor esa orientación se implementa mediante archivos de instrucciones persistentes.

Los comandos principales son:
/graphify . # construir el mapa
/graphify ./docs --update # actualizar archivos cambiados
/graphify . --no-viz # producir informe y JSON sin HTML
/graphify query "qué conecta autenticación y base de datos?"
/graphify path "UserService" "DatabasePool"
/graphify explain "RateLimiter"
graphify hook install # actualizar tras cada confirmación de Git
graphify merge-graphs a.json b.json
También expone el grafo mediante MCP: python -m graphify.serve graphify-out/graph.json. El transporte estándar es stdio; la opción HTTP permite que un equipo apunte a un proceso compartido. La documentación advierte que, si se expone fuera de 127.0.0.1, debe usarse una clave de API.

Entre las funciones destacadas figuran detección de comunidades con Leiden, nodos muy conectados, enlaces entre archivos, relaciones de importación/llamada/herencia, extracción de comentarios de motivación y referencias de documentación. El README declara soporte AST para unas 36 gramáticas, además de configuraciones MCP, manifiestos de paquetes, SQL, documentación y varios formatos de oficina y multimedia mediante extras.
Estado oficial y semioficial
Graphify es un proyecto abierto publicado en PyPI como graphifyy y bajo licencia Apache-2.0. La versión publicada que devolvió PyPI durante esta investigación es 0.9.32. El README muestra una insignia de Y Combinator S26 y enlaza una ficha de Graphify Labs; también anuncia acceso anticipado a una plataforma empresarial antes de una versión pública 1.0.
No se recuperó evidencia de que Graphify haya sido aceptado en un mercado oficial de Anthropic, OpenAI, Google, Cursor, GitHub o de otro proveedor. Su instalación en muchos asistentes debe leerse como compatibilidad técnica documentada por el proyecto, no como certificación, aval del proveedor ni estándar formal. Su volumen de estrellas, el paquete de PyPI y los adaptadores multiagente sí apuntan a una adopción amplia, pero «estándar de facto» no es una designación verificada en las fuentes consultadas.
El ecosistema
Repositorios del autor y de la organización
La API de la organización Graphify-Labs devolvió únicamente dos repositorios públicos: el repositorio principal y Graphify-Labs/.github (archivos de perfil y salud de comunidad; 0 estrellas). No se identificó un laboratorio, arnés de evaluación o mercado oficial adicional bajo esa organización en esa medición.
El ecosistema oficial dentro del propio repositorio incluye documentación traducida a chino simplificado y tradicional, japonés, coreano, español, francés, alemán, hindi, portugués, ruso, árabe, persa, italiano, polaco, neerlandés, turco, ucraniano, vietnamita, indonesio y otros idiomas. Son traducciones mantenidas en docs/translations/, no bifurcaciones independientes.

Bifurcaciones, puertos y extensiones comunitarias
La API de bifurcaciones y la búsqueda de GitHub permitieron verificar los siguientes derivados o extensiones. Las cifras son estrellas observadas el 3 de agosto de 2026; no equivalen a soporte del proyecto principal.
elbruno/graphify-dotnet: puerto para .NET 10 que declara usar GitHub Copilot SDK y Microsoft.Extensions.AI; 90 estrellas.TtTRz/graphify-rs: reescritura en Rust; 57 estrellas.sjhorn/graphify: puerto y ampliación en Go que enlaza explícitamente al repositorio original; 8 estrellas.Rootly-AI-Labs/rootly-graphify-importer: importador para transformar incidencias, alertas y equipos de Rootly en un grafo consultable; 41 estrellas. Rootly también publicó el artículo de integración enlazado por Graphify.chencore/graphify-knowledge-graph-docs: documentación comunitaria de instalación y uso en chino; 26 estrellas. Es un recurso no inglés separado del conjunto de traducciones oficiales.gaodes/pi-graphify: extensión para Pi que envuelve el CLI; 9 estrellas.yetanotheraryan/graphify-chokidar: vigila cambios para mantener el grafo actualizado sin ejecutar el pase semántico; 6 estrellas.- Entre las bifurcaciones más visibles devueltas por la API están
m8e/graphify(19 estrellas) ysalvatorecastellitti/graphify-qwen(11 estrellas). Se describen como bifurcaciones/habilidades; no hay evidencia recuperada de que sean productos distintos con respaldo oficial.

Números del repositorio
Medición: 3 de agosto de 2026, API y página de GitHub.
| Métrica | Valor |
|---|---|
| Estrellas | 101.638 |
| Bifurcaciones | 9.867 |
| Suscriptores reales | 345 |
| Commits | 1.342 |
| Incidencias abiertas indicadas por la API | 776 |
| Lenguaje principal | Python |
| Licencia actual | Apache-2.0 |
| Creación | 3 de abril de 2026 |
| Último envío de código | 1 de agosto de 2026 |
| Última versión | v0.9.32, 1 de agosto de 2026 |
El total de 1.342 confirmaciones procede de la última página indicada en el encabezado de paginación de la API. Los contribuidores principales devueltos por la API fueron safishamsi (944 contribuciones), TPAteeq (27), oleksii-tumanov (21), Synvoya (17) y Rishet11 (16).
La API devuelve watchers_count igual que las estrellas; por ello se informa subscribers_count como el número de suscriptores reales. open_issues_count puede mezclar incidencias y solicitudes de cambios abiertas, de modo que no debe interpretarse como un conteo exclusivo de incidencias. La página web mostraba 352 incidencias y 424 solicitudes de cambios en el momento de consulta, una desagregación que ilustra esa cautela.
Cómo contribuir
No se recuperó un CONTRIBUTING.md, una plantilla de solicitud de cambios ni un flujo de contribución explícito en el repositorio. Sí hay directorios tests/, docs/ y flujos de GitHub Actions, y la página de discusiones ofrece categorías de ideas, preguntas y respuestas, demostraciones y anuncios. Por tanto, el repositorio muestra actividad comunitaria, pero no es responsable inferir una política de ramas, pruebas obligatorias o aceptación de contribuciones que no esté documentada.
Cómo lo recibió la comunidad
La recepción observable mezcla curiosidad por el mapa persistente, integraciones posteriores y reservas técnicas:
- En Hacker News 47668188, enviado por tanelpoder el 6 de abril, Graphify obtuvo 2 puntos y 1 comentario. kazishariar preguntó concretamente si podía mapear semánticamente una carpeta de PDF, libros, citas y datos; es una señal de interés por el alcance documental, no una reseña positiva concluyente.
- El hilo 48717184, enviado por mdrzn, alcanzó 4 puntos y 1 comentario. gkorland calificó Graphify de «gran proyecto» y propuso probarlo con FalkorDB, con comandos de exportación Cypher. Es elogio individual y una propuesta de integración, no una evaluación comparativa.
- En 47890749, una pregunta sobre bases de código heredadas recibió 13 puntos y 8 comentarios. sds357 enlazó Graphify y explicó que serviría para que el agente encontrase la estructura y relaciones de la base de código. El contexto, planteado por thinkingtoilet, era una base de más de veinte años y el coste de que el asistente relea grandes fragmentos; explica el problema al que se aplica, no verifica una reducción de coste.
- La crítica más específica recuperada está en el comentario de Madsn dentro de 47696872, hilo con 2 puntos y 6 comentarios. Dijo haber elegido Graphify inicialmente por usar OpenCode, pero cuestionó conclusiones que Sonnet había generado al comparar Graphify con Ix, señaló que Ix también tenía un complemento para OpenCode y manifestó su rechazo a que el gancho de Graphify reconstruyera el grafo tras cada confirmación de Git porque quería versionar los archivos del grafo. Es experiencia personal; no demuestra que el comportamiento sea erróneo en general.
No se recuperó una discusión masiva que permita afirmar consenso de la comunidad. Las métricas de Hacker News son modestas frente a la popularidad en GitHub y no deben confundirse con una evaluación de calidad.
Graphify frente a otras propuestas
| Propuesta | Coincidencia verificable | Diferencia verificable |
|---|---|---|
ix-infrastructure/Ix | Ambos se presentan como CLI abiertos que generan un mapa arquitectónico persistente para asistentes. | En el hilo de HN, su autor describe Ix como una herramienta de integración de agentes con un complemento para Claude Code; Graphify documenta adaptadores para más de quince asistentes y etiquetas de procedencia en sus aristas. No se recuperó un benchmark independiente entre ambos. |
getzep/graphiti | Ambos usan grafos de conocimiento para consultas de modelos. | En un comentario de HN, SEJeff los agrupó por usar Tree-sitter y grafos para uso con LLM; Graphify se orienta explícitamente a mapear archivos locales y un repositorio, mientras esa fuente no basta para afirmar una equivalencia de arquitectura o rendimiento. |
trailofbits/trailmark | También fue citado por SEJeff como herramienta basada en Tree-sitter y grafos para LLM. | La fuente recuperada solo acredita esa relación de categoría; no se obtuvo documentación suficiente para una comparación funcional más fuerte. |
La comparación verificable es por enfoque, no por una clasificación de ganadores: Graphify encaja cuando se necesita un artefacto versionable, una visualización y rutas auditables sobre código y documentación; los datos recuperados no prueban que supere a Ix, Graphiti o Trailmark en precisión, coste o cobertura.
Casos de uso y a quién puede ayudar este repositorio
- Equipos que mantienen repositorios grandes o heredados pueden generar
graph.json, consultasquery, rutaspathy explicacionesexplainpara localizar dependencias y relaciones entre módulos sin comenzar cada sesión buscando archivos manualmente. - Equipos que combinan aplicación, esquema SQL, configuración y documentación de arquitectura pueden reunir esos materiales en una sola representación. El valor depende de revisar las aristas
INFERREDy de configurar conscientemente el pase semántico para los materiales que no son código. - Equipos distribuidos que usan asistentes distintos pueden versionar
graphify-out/, instalar la habilidad por proyecto y usar los adaptadores documentados para Codex, Claude Code, Cursor, Gemini CLI, Copilot u otros; el gancho de Git ymerge-graphsapuntan específicamente a mantener un mapa compartido. - Personas que necesitan inspección o trazabilidad pueden usar las etiquetas de procedencia,
graph.htmly el servidor MCP para que las respuestas del agente indiquen qué camino del grafo recorrieron. Si el grafo se comparte por HTTP, deben aplicar las medidas de autenticación que documenta el proyecto.
Recursos
- Repositorio: https://github.com/Graphify-Labs/graphify
- Documentación e instalación: https://graphify.com/docs
- Paquete oficial: https://pypi.org/project/graphifyy/
- Skills oficiales e integraciones: https://github.com/Graphify-Labs/graphify#pick-your-platform-20-assistants-click-to-expand
- Benchmarks del proyecto: https://github.com/Graphify-Labs/graphify/blob/v8/BENCHMARKS.md
- Reviews y conversaciones: https://news.ycombinator.com/item?id=47668188, https://news.ycombinator.com/item?id=48717184, https://news.ycombinator.com/item?id=47696872
- Comunidad y Discord: https://discord.gg/598Ad9zQZ
- Sitio y acceso anticipado: https://graphify.com/
Nota: este artículo combina el README, la documentación y el sitio de Graphify, las APIs de GitHub y PyPI, la búsqueda de repositorios y los hilos de Hacker News recuperados el 3 de agosto de 2026. Las cifras cambian con el tiempo; las afirmaciones de rendimiento del proyecto y las experiencias de usuarios se atribuyen a sus fuentes.
Comentarios