How demartinomarco/compogen works
CompoGen is a web workbench for turning software specifications into PlantUML component diagrams and evaluating their quality. The documented user flow is browser configuration and dataset selection, generation through the Python API, and streamed diagram output for viewing; agentic generation adds iterative tool checks. Separate evaluation capabilities cover syntax, CodeBLEU, embeddings, LLM judging, and graph similarity. Edges are limited to relationships shown in excerpts or documented in the README; some unsampled subsystem links are therefore omitted.
Main entry points: generation_service.py Generation service · plantuml_extractor.py PlantUML extraction · components Generation interface · app.py Python REST API
Components 28
Web workbench
- Workbench page
frontend/src/routes/+page.svelte - Generation interface
frontend/src/lib/features/diagram-generation/components - Svelte API routes
frontend/src/routes/api/diagrams - Diagram rendering route
frontend/src/routes/api/diagrams/render/+server.ts
API and orchestration
- Python REST API
backend/src/uml_generator/api/app.py - Models and datasets
backend/src/uml_generator/api/catalog.py - Generation service
backend/src/uml_generator/api/generation_service.py - Stream aggregation
backend/src/uml_generator/inference/streaming.py
Diagram generation
- Prompt construction
backend/src/uml_generator/prompts/builders.py - Generation executor
backend/src/uml_generator/inference/generation_executor.py - Provider registry
backend/src/uml_generator/inference/provider_registry.py - Provider clients
backend/src/uml_generator/inference/clients/base.py - Agentic verification tools
backend/src/uml_generator/inference/diagram_tools
Evaluation
- PlantUML extraction
backend/src/uml_generator/evalutation/plantuml_extractor.py - Syntax evaluation
backend/src/uml_generator/evalutation/plantuml_parser/parser.py - CodeBLEU metric
backend/src/uml_generator/evalutation/codebleu_diagram_evaluator.py - Embedding similarity
backend/src/uml_generator/evalutation/code_embedding.py - Graph similarity
backend/src/uml_generator/evalutation/graph_similarity.py - LLM judge
backend/src/uml_generator/inference/llm_evaluator.py - Evaluation presets
backend/src/uml_generator/presets/evaluation
Data and models
- Inference data models
backend/src/uml_generator/domains/inference.py - Model configuration
backend/src/uml_generator/domains/models.py - Dataset store
backend/src/uml_generator/storage/dataset_store.py - Evaluation models
backend/src/uml_generator/domains/evaluation_models.py - Evaluation payloads
backend/src/uml_generator/domains/evaluation_payloads.py
Other components
- Workbench user
- Model providers
- PlantUML renderer
Connections 30
- Workbench user → Workbench page: configures
README.md - Workbench page → Generation interface: uses
- Generation interface → Svelte API routes: requests
- Svelte API routes → Python REST API: HTTP requests
README.md - Python REST API → Generation service: streams generation
backend/src/uml_generator/api/app.py - Python REST API → Models and datasets: loads catalog
backend/src/uml_generator/api/app.py - Python REST API → Dataset store: reads summaries
backend/src/uml_generator/api/app.py - Generation service → Prompt construction: builds prompts
backend/src/uml_generator/api/generation_service.py - Generation service → Generation executor: runs generation
backend/src/uml_generator/api/generation_service.py - Generation service → Provider registry: selects provider
backend/src/uml_generator/api/generation_service.py - Provider registry → Provider clients: registers clients
backend/src/uml_generator/inference/provider_registry.py - Provider clients → Model providers: calls models
README.md - Generation executor → Agentic verification tools: checks candidates
README.md - Generation executor → Inference data models: produces events
- Generation service → Stream aggregation: aggregates events
backend/src/uml_generator/api/generation_service.py - Stream aggregation → Svelte API routes: SSE stream
README.md - Generation interface → Diagram rendering route: requests rendering
- Diagram rendering route → PlantUML renderer: renders diagram
- Generation interface → Dataset store: selects dataset
- Evaluation presets → Dataset store: loads evaluation data
backend/src/uml_generator/presets/evaluation/llm_calibration.py - Evaluation presets → LLM judge: runs judge
backend/src/uml_generator/presets/evaluation/llm_evaluator.py - LLM judge → PlantUML extraction: extracts diagram
backend/src/uml_generator/inference/llm_evaluator.py - LLM judge → Prompt construction: builds judge prompt
backend/src/uml_generator/inference/llm_evaluator.py - LLM judge → Provider registry: obtains client
backend/src/uml_generator/inference/llm_evaluator.py - Evaluation models → Evaluation payloads: uses payload types
backend/src/uml_generator/domains/evaluation_models.py - PlantUML extraction → Syntax evaluation: feeds syntax checks
README.md - PlantUML extraction → CodeBLEU metric: feeds metric
README.md - PlantUML extraction → Embedding similarity: feeds similarity
README.md - PlantUML extraction → Graph similarity: feeds graph matching
README.md - Model configuration → Generation service: configures requests
backend/src/uml_generator/api/generation_service.py