How dbis-legal-llms/gripl-v2 works
GRIPL supports BPMN process analysis, GDPR-grounded reasoning, dataset labeling, and evaluation. Users submit or model a process in the frontend; the backend extracts BPMN elements and coordinates an analyzer, optionally augmenting its reasoning through the sibling RAG service. Researchers can create and label evaluation datasets, then run evaluations and inspect reports. The RAG service retrieves context from a Neo4j-backed knowledge graph and also exposes PDF and RAG-evaluation APIs. The README establishes the product capabilities; several routes and integrations are unsampled, so those links are omitted unless documented or evidenced in the index.
Main entry points: page.tsx GRIPL interface · AnalyzerFactory.kt Analyzer factory · routes.py RAG API · RagApiClient.kt RAG API client
Components 21
User workflows
- GRIPL interface
gripl/gripl-frontend/src/app/page.tsx - Process analysis UI
gripl/gripl-frontend/src/components/process-analysis/process-model-detail-view.tsx - Dataset labeling UI
gripl/gripl-frontend/src/components/labeling/labeling-editor.tsx - Evaluation UI
gripl/gripl-frontend/src/components/evaluation/evaluation-page.tsx
GRIPL backend
- Analysis service
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/application/analyzer/AnalysisService.kt - Analyzer factory
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/application/analyzer/AnalyzerFactory.kt - BPMN extraction
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/application/BpmnExtractor.kt - LLM analysis
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/ai/PromptBpmnAnalysisAiService.kt - RAG API client
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/adapter/rag/RagApiClient.kt - Label service
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/application/LabelService.kt - Dataset transfer
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/application/dataset/DatasetTransferService.kt - Process models
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/repository/ProcessModelRepository.kt
RAG service
- RAG API
gripl/gripl-rag/app/api/routes.py - Retrieval engine
gripl/gripl-rag/app/rag/engine.py - Knowledge graph
- PDF lookup
gripl/gripl-rag/app/api/pdf_routes.py
Evaluation
- RAG evaluator
gripl/gripl-rag/app/evaluation/ragas_evaluator.py - Evaluation runner
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/evaluation/EvaluationRunner.kt
Other components
- User
- PostgreSQL
- Auth service
Connections 15
- User → GRIPL interface: uses
README.md - GRIPL interface → Process analysis UI: opens
README.md - GRIPL interface → Dataset labeling UI: opens
README.md - GRIPL interface → Evaluation UI: opens
README.md - User → Auth service: authenticates via
README.md - Analysis service → Analyzer factory: selects
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/application/analyzer/AnalysisService.kt - Analyzer factory → RAG API client: configures
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/application/analyzer/AnalyzerFactory.kt - Analyzer factory → LLM analysis: selects
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/application/analyzer/AnalyzerFactory.kt - RAG API client → RAG API: queries
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/adapter/rag/RagApiClient.kt - RAG API → Retrieval engine: retrieves with
gripl/gripl-rag/app/api/routes.py - Retrieval engine → Knowledge graph: queries
- Dataset transfer → PostgreSQL: imports and exports
gripl/gripl-backend/src/main/kotlin/de/mertendieckmann/griplbackend/application/dataset/DatasetTransferService.kt - Label service → PostgreSQL: persists labels
- Evaluation runner → RAG evaluator: scores RAG
- RAG API → PDF lookup: also serves
gripl/gripl-rag/app/main.py