How hirotomasato/yowes works
Yowes is a teacher-document generator whose primary workflow is an MCP client discovering country and school options, then requesting country-specific documents from teacher and school details; the server returns paths to rendered PNGs. Country modules combine local school data and document rendering, while shared utilities provide fonts and consistent profile photos. The README also documents a legacy GUI sharing the generation logic. The MCP and GUI implementation excerpts were not provided, so their internal call wiring is shown only where the documented workflow supports it.
Main entry points: utils.py Rendering utilities · base.py Generator base · mcp_server.py MCP server · __init__.py UK generator
Components 21
User interfaces
- MCP server
mcp_server.py - Legacy GUI
main_gui.py
Generation core
- Generator base
countries/base.py - Rendering utilities
countries/utils.py
Country generators
- UK generator
countries/uk/__init__.py - US generator
countries/us/__init__.py - France generator
countries/france/__init__.py - Netherlands generator
countries/netherlands/__init__.py - Indonesia generator
countries/indonesia/__init__.py - Australia generator
countries/australia/__init__.py - Canada generator
countries/canada/__init__.py - Spain generator
countries/spain/__init__.py - Argentina generator
countries/argentina/__init__.py - Slovakia generator
countries/slovakia/__init__.py - Mexico generator
countries/mexico/__init__.py - Philippines generator
countries/philippines/__init__.py - Thailand generator
countries/thailand/__init__.py
Bundled assets
- Profile photos
countries/foto - Bundled fonts
countries/fonts
Other components
- MCP client
- PNG files
Connections 32
- MCP client → MCP server: sends MCP requests
- MCP server → Generator base: uses generators
- MCP server → PNG files: writes PNGs
- Legacy GUI → Generator base: shares generation logic
- UK generator → Generator base: extends
- US generator → Generator base: extends
- France generator → Generator base: extends
- Netherlands generator → Generator base: extends
- Indonesia generator → Generator base: extends
- Australia generator → Generator base: extends
- Canada generator → Generator base: extends
- Spain generator → Generator base: extends
- Argentina generator → Generator base: extends
- Slovakia generator → Generator base: extends
- Mexico generator → Generator base: extends
- Philippines generator → Generator base: extends
- Thailand generator → Generator base: extends
- UK generator → Rendering utilities: uses rendering helpers
- US generator → Rendering utilities: uses rendering helpers
- France generator → Rendering utilities: uses rendering helpers
- Netherlands generator → Rendering utilities: uses rendering helpers
- Indonesia generator → Rendering utilities: uses rendering helpers
- Australia generator → Rendering utilities: uses rendering helpers
- Canada generator → Rendering utilities: uses rendering helpers
- Spain generator → Rendering utilities: uses rendering helpers
- Argentina generator → Rendering utilities: uses rendering helpers
- Slovakia generator → Rendering utilities: uses rendering helpers
- Mexico generator → Rendering utilities: uses rendering helpers
- Philippines generator → Rendering utilities: uses rendering helpers
- Thailand generator → Rendering utilities: uses rendering helpers
- Rendering utilities → Profile photos: selects consistently
- Rendering utilities → Bundled fonts: loads