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 de conocimiento | Modelo NetworkX con PageRank, clustering y endpoints /graph/neighbors, /graph/path, /graph/subgraph, /graph/stats, /graph/top |
| 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 |
Backend en Python 3.12 (FastAPI + Pydantic + NetworkX + FastMCP). Frontend en React + TypeScript (Vite + TanStack + Zustand + Tailwind + shadcn/ui). El objetivo final es distribuirlo como app de escritorio standalone — un único binario por sistema operativo, sin Docker ni Python requerido para el usuario final.
| Fase | Estado |
|---|---|
| 0 — Fundación (repo, CI/CD, branch protection, dependabot) | ✅ Hecho |
| 1 — API base + parseo legalize-es + búsqueda full-text | ✅ Hecho |
| 2 — Grafo de conocimiento (modelo + algoritmos + endpoints + persistencia + xyflow viz) | ✅ Hecho |
| 3 — Chatbot (Ollama + LM Studio + OpenAI + Anthropic + Google + FastMCP + tool-use loop) | ✅ Hecho |
| 4 — Dashboards (Plotly: compliance + analytics) | ✅ Hecho |
| 5 — Frontend React (layout + explorador + grafo + chat + dashboards + i18n + settings) | ✅ Hecho |
| 6 — Empaquetado y distribución (PyInstaller spec + landing) | Parcial — Tauri/signing/auto-update pendientes |
| 7 — Búsqueda semántica y RAG | Infra placeholder en main — falta embedder real |
| 8 — UX y onboarding (greeting, tour, wizard de modelos, accesibilidad) | ✅ Hecho |
9 — Personalización y MCP extensibility (plantillas, servers externos, .mcpb) |
✅ Hecho |
Roadmap detallado: ROADMAP.md. Issues activas: GitHub Issues.
Requisitos: Python 3.12+ y uv.
git clone https://github.com/VforVitorio/LexFlow.git
cd LexFlow
# Inicializar el submódulo de legalize-es (corpus de leyes)
git submodule update --init --recursive
# 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.
El scaffold ya está en frontend/. Vite proxia /api/* → :8000, así que no hay configuración de CORS en dev — basta con que el backend esté corriendo.
cd frontend
npm install # primera vez
npm run dev # Vite en :5173 con proxy /api → :8000
npm run typecheck # tsc --noEmit
npm run build # → frontend/dist/
npm run lint # ESLintAtajo: desde la raíz del repo,
./scripts/dev.ps1arranca backend + frontend en dos terminales y dejafrontend/.env.localcon la única combinación que funciona (VITE_USE_MOCK=false, sinVITE_API_URL).
cd frontend && npm run build && cd ..
uv run python main.py # FastAPI sirve la API en /api/v1 y el SPA en /Nota: la distribución final será un binario standalone (
.exe,.dmg,.AppImage) que empaqueta backend + frontend con PyInstaller. Docker es opcional (para despliegues en servidor).
LexFlow/
├── src/lexflow/ # Backend Python
│ ├── api/ # FastAPI — endpoints REST
│ ├── core/ # Modelos de dominio, parsers, lógica de negocio
│ ├── chat/ # Chatbot + proveedores LLM + MCP server
│ │ └── providers/ # Ollama, LM Studio, OpenAI, Anthropic, Google
│ ├── graph/ # Grafo de conocimiento (NetworkX) + algoritmos + cache
│ ├── dashboards/ # Figuras Plotly (compliance + analytics)
│ └── utils/ # Configuración, logging, helpers
├── frontend/ # React + TypeScript (Vite)
│ └── src/
│ ├── api/ # schema.ts generado de /openapi.json + cliente tipado
│ ├── pages/ # Rutas (TanStack Router)
│ ├── components/ # shadcn/ui primitivos + UI compuesta
│ ├── stores/ # Estado cliente (Zustand)
│ ├── hooks/ # Hooks de TanStack Query
│ └── lib/ # Utilidades, formatters
├── tests/ # pytest (backend)
├── docs/ # Documentación
├── data/legalize-es/ # Submódulo: corpus de leyes
├── scripts/ # Scripts de mantenimiento (setup-github.sh)
├── .github/ # CI/CD, dependabot, labeler, release-please
├── main.py # Entry point del backend
├── Dockerfile # Imagen para despliegue en servidor (opcional)
├── docker-compose.yml # Stack completo dockerizado
└── pyproject.toml # Configuración Python
| Componente | Tecnología |
|---|---|
| Framework web | FastAPI + Uvicorn |
| Validación | Pydantic v2 |
| Grafo | NetworkX (PageRank, clustering, shortest path) |
| Chat | FastMCP, Ollama, LM Studio, OpenAI, Anthropic, Google |
| Dashboards | Plotly (figuras como JSON) |
| Gestor de paquetes | uv |
| Linter / formatter | Ruff (line-length 120) |
| Type checker | mypy strict |
| Tests | pytest + pytest-asyncio |
| Empaquetado | PyInstaller |
| Componente | Tecnología |
|---|---|
| Build | Vite |
| Framework | React 18 + TypeScript strict |
| Routing | TanStack Router (typed, file-based) |
| Server state | TanStack Query |
| Client state | Zustand |
| Styling | Tailwind CSS + shadcn/ui (Radix) |
| Graph viz | @xyflow/react (formerly react-flow, migrated in #73) |
| Charts | plotly.js-dist + react-plotly.js |
| HTTP client | ky sobre tipos generados con openapi-typescript |
| Tests | Vitest + Playwright |
| i18n | react-i18next (ES por defecto, EN como segundo idioma) |
| Gestor de paquetes | npm |
Reflex fue el framework original. Se descartó el 2026-05-22 — los detalles del cambio y el contrato FastAPI ↔ React están en CLAUDE.md §2 y §6.
# Listar leyes (paginado, con filtros opcionales)
curl http://localhost:8000/api/v1/laws?page=1
# Detalle de una ley
curl http://localhost:8000/api/v1/laws/BOE-A-2018-16673
# Solo las cross-referencias (payload ~10× más pequeño que el detalle)
curl http://localhost:8000/api/v1/laws/BOE-A-2018-16673/references
# Búsqueda full-text
curl "http://localhost:8000/api/v1/search?q=protección+de+datos"
# Búsqueda semántica (cosine sobre embeddings)
curl "http://localhost:8000/api/v1/laws/search/semantic?q=protección+de+datos&limit=10"
# Grafo: vecinos directos
curl http://localhost:8000/api/v1/graph/neighbors/BOE-A-2018-16673
# Grafo: el corpus entero filtrado (Obsidian-style)
curl "http://localhost:8000/api/v1/graph?rank=ley_organica&limit=200"
# Camino más corto entre dos normas
curl "http://localhost:8000/api/v1/graph/path?from=BOE-A-2018-16673&to=BOE-A-1978-31229"
# Top 20 por PageRank
curl "http://localhost:8000/api/v1/graph/top?limit=20"
# Salud extendida (memoria, disco, corpus, chat DB)
curl http://localhost:8000/api/v1/system/healthToda la API vive bajo /api/v1/*. Cambios breaking bumpean a /api/v2/. Inventario completo: docs/backend/api-endpoints.md.
Las contribuciones son bienvenidas. Lee la guía de contribución antes de empezar.
Flujo rápido (trunk-based, desde 2026-05-30):
- Abre o busca un issue.
- Crea una rama desde
main(feat/xxx,fix/xxxodocs/xxx). - Desarrolla y añade tests.
- Abre PR hacia
main. - CI corre los checks requeridos:
test,lint,typecheck,frontend-build. - Review y merge (sin squash — preservamos el histórico para release-please). La rama se borra automáticamente al mergear.
main está protegido (strict; restrictions: null; required_conversation_resolution: true). La antigua rama dev fue retirada — toda PR de feature/fix apunta directamente a main. Si un check falla en main, se arregla con un PR — nunca con enforce_admins.
- CLAUDE.md — fuente de verdad sobre stack, convenciones, contrato FastAPI ↔ React y lecciones aprendidas.
- ROADMAP.md — plan por fases.
- CONTRIBUTING.md — flujo de ramas y revisiones.
- scripts/setup-github.sh — reaplica branch protection y labels en un repo nuevo.
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