Plataforma open source para explorar, analizar y consultar legislación española mediante grafos de conocimiento, IA y dashboards interactivos.
LexFlow transforma el repositorio legalize-es — una colección de leyes españolas en Markdown versionada con Git — en una plataforma interactiva con cuatro capas:
| Capa | Descripción |
|---|---|
| API REST | Endpoints FastAPI para leyes, artículos, versiones, diffs, búsqueda y estadísticas |
| Grafo interactivo | Visualización tipo Obsidian de relaciones entre normas, artículos y referencias |
| Chat legal | Chatbot con acceso a herramientas reales vía MCP (Ollama, LM Studio, OpenAI, Anthropic, Google) |
| Dashboards | Paneles de compliance y analítica legislativa con Plotly |
Todo construido en Python puro (backend + frontend con Reflex), pensado para ser descargado y usado por cualquier persona — sin necesidad de Docker, terminales ni dependencias.
- Python 3.12+
- uv (gestor de paquetes recomendado)
# Clonar el repositorio
git clone https://github.com/VforVitorio/LexFlow.git
cd LexFlow
# Instalar dependencias
uv sync --all-extras
# Arrancar el servidor de desarrollo
uv run python main.pyLa API estará disponible en http://localhost:8000. Documentación interactiva en /docs.
Nota: En futuras versiones LexFlow se distribuirá como aplicación de escritorio descargable (
.exe,.dmg,.AppImage) para que no necesites instalar nada.
LexFlow/
├── src/lexflow/
│ ├── api/ # FastAPI — endpoints REST
│ ├── core/ # Modelos de dominio, parsers, lógica de negocio
│ ├── chat/ # Chatbot legal con MCP tools
│ ├── graph/ # Grafo de conocimiento (NetworkX)
│ ├── dashboards/ # Paneles analíticos (Plotly + Reflex)
│ └── utils/ # Configuración, logging, helpers
├── tests/ # Test suite
├── docs/ # Documentación del proyecto
├── assets/ # Imágenes y recursos estáticos
├── .github/ # CI/CD, issue templates, PR template
├── main.py # Punto de entrada
└── pyproject.toml # Configuración del proyecto
| Componente | Tecnología |
|---|---|
| Backend | FastAPI, Pydantic, Uvicorn |
| Frontend | Reflex |
| Grafo | NetworkX |
| Chat / RAG | FastMCP, Ollama, LM Studio, OpenAI, Anthropic, Google |
| Dashboards | Plotly |
| Testing | pytest, pytest-asyncio |
| Linting | Ruff |
| Type checking | mypy |
| Packaging | uv, PyInstaller |
Consulta el ROADMAP.md completo para ver todas las fases, hitos y objetivos del proyecto.
Resumen de fases:
- Cimientos — API base, parseo de leyes, modelos de dominio
- Grafo — Construcción y visualización del grafo de relaciones legales
- Chat — Chatbot legal con herramientas MCP conectadas a la API
- Dashboards — Paneles de compliance y analítica legislativa
- Producto — Empaquetado como app de escritorio, instaladores, distribución
Las contribuciones son bienvenidas. Lee la guía de contribución antes de empezar.
Flujo rápido:
- Abre o busca un issue
- Crea una rama desde
dev(feat/xxxofix/xxx) - Desarrolla y añade tests
- Abre PR hacia
dev - Review y merge (sin squash)
Este proyecto existe gracias a legalize-es, el repositorio open source que recopila y versiona legislación española en Markdown. LexFlow construye sobre esa base para convertirla en una plataforma interactiva completa.
LexFlow se distribuye bajo la licencia Apache 2.0.
Copyright 2026 VforVitorio
Licensed under the Apache License, Version 2.0