How codecatalysthadeed/forgepy works
ForgePy is a local, deterministic Python project generator. A developer runs forgepy create, selects a project type and options, and receives a staged project foundation; optional setup creates an environment, installs dependencies, and verifies the generated starter. The graph preserves the documented template families and generated-project capabilities, although their detailed internals are largely represented by the shared builder module. Relationships are included only where the excerpts or README support them; unsampled template internals are not expanded.
Main entry points: builders.py Template builders · templates.py Template registry · generator.py Generation orchestrator · cli.py Create command
Components 19
CLI and selection
- Create command
src/forgepy/cli.py - Project options
src/forgepy/config.py
Template generation
- Template registry
src/forgepy/registry/templates.py - Generation orchestrator
src/forgepy/generator.py - Project specification
src/forgepy/models.py - Template builders
src/forgepy/templates/builders.py - Shared project files
src/forgepy/templates/shared.py - Safe staged writer
src/forgepy/utils/filesystem.py
Generated foundations
- FastAPI starter
src/forgepy/templates/builders.py - RAG starter
src/forgepy/templates/builders.py - AI agent starter
src/forgepy/templates/builders.py - LangGraph starter
src/forgepy/templates/builders.py - ML starter
src/forgepy/templates/builders.py - Data science starter
src/forgepy/templates/builders.py - Python CLI starter
src/forgepy/templates/builders.py - Guidance and config
src/forgepy/templates/shared.py - Generated project files
src/forgepy/utils/filesystem.py
Optional setup
- Environment setup
src/forgepy/setup.py
Other components
- Developer
Connections 16
- Developer → Create command: runs create
README.md - Create command → Template registry: lists templates
src/forgepy/cli.py - Template registry → Template builders: registers builders
src/forgepy/registry/templates.py - Generation orchestrator → Template registry: selects template
src/forgepy/generator.py - Template builders → Shared project files: uses helpers
src/forgepy/templates/builders.py - Generation orchestrator → Safe staged writer: writes project
src/forgepy/generator.py - Developer → FastAPI starter: selects template
README.md - Developer → RAG starter: selects template
README.md - Developer → AI agent starter: selects template
README.md - Developer → LangGraph starter: selects template
README.md - Developer → ML starter: selects template
README.md - Developer → Data science starter: selects template
README.md - Developer → Python CLI starter: selects template
README.md - Template builders → Guidance and config: generates support files
README.md - Safe staged writer → Generated project files: commits staged files
src/forgepy/utils/filesystem.py - Developer → Environment setup: requests setup
README.md