How aurluce/text2ulm works
Text2UML is a Streamlit application that turns a natural-language system description into one of seven UML diagram types and offers rendered and source-file results. The primary workflow is description and type selection, AI-based model generation, consistency validation, PlantUML construction, and image rendering. The diagram catalogue and shared models support distinct diagram domains; configuration controls the Groq and rendering integrations. The excerpts show the main calls, but not all rendering and output-handling details, so uncertain internal links are omitted.
Main entry points: app.py Streamlit interface · ai_service.py AI generation · uml_generator.py PNG/SVG rendering · uml_model.py Diagram models
Components 14
User interface
- Streamlit interface
app.py - Diagram results
app.py
Diagram modeling
- Diagram catalogue
services/diagram_types.py - Diagram models
models/uml_model.py - Name utilities
utils.py
Generation pipeline
- AI generation
services/ai_service.py - Model validation
services/validator.py
Rendering and configuration
- PlantUML generation
services/uml_generator.py - PNG/SVG rendering
services/uml_generator.py - Runtime configuration
config.py
Other components
- Diagram author
- Groq API
- Local PlantUML
- PlantUML server
Connections 17
- Diagram author → Streamlit interface: describes system
README.md - Streamlit interface → Diagram catalogue: selects type
app.py - Streamlit interface → AI generation: requests model
app.py - AI generation → Groq API: requests completion
services/ai_service.py - AI generation → Diagram catalogue: uses type rules
services/ai_service.py - AI generation → Diagram models: parses response
services/ai_service.py - AI generation → Model validation: validates model
services/ai_service.py - Model validation → Diagram models: cleans model
services/validator.py - Streamlit interface → PlantUML generation: builds diagram code
app.py - PlantUML generation → Diagram models: reads diagram model
services/uml_generator.py - PlantUML generation → Name utilities: uses identifiers
services/uml_generator.py - Streamlit interface → PNG/SVG rendering: requests rendering
app.py - PNG/SVG rendering → Local PlantUML: renders locally
services/uml_generator.py - PNG/SVG rendering → PlantUML server: sends diagram text
services/uml_generator.py - AI generation → Runtime configuration: reads API settings
services/ai_service.py - PNG/SVG rendering → Runtime configuration: reads render settings
services/uml_generator.py - Streamlit interface → Diagram results: shows and downloads
app.py