Forge

Cross-platform CLI for interactively designing and generating application project architectures.

Status: public development release 0.1.1 (forge-scaffolder on PyPI). Generates runnable Python FastAPI, Django, and Flask REST API projects with Simple, Modular Monolith, or Clean Architecture layouts. Supports interactive / --preset / YAML --config generation and forge plan inspection.

Requires: Python 3.11+ (tested on 3.11, 3.12, 3.13)

Supported today

Install

uv tool install forge-scaffolder
# or: pip install forge-scaffolder
forge --version
forge new my-api --preset fastapi-postgres

Naming:

Build and install from this repository:

uv sync
uv build
uv pip install dist/forge_scaffolder-*.whl   # or: pip install dist/forge_scaffolder-*.whl
forge --version
forge new my-api --preset fastapi-postgres

Quick start (development checkout)

uv sync
uv run forge new my-api
uv run forge new my-api --preset fastapi-postgres
# non-interactive config (CI-safe — never prompts):
# uv run forge new --config forge.yaml
cd my-api
uv sync

Follow the generated project README for framework-specific run commands.

Configuration and presets

• Interactive: forge new [NAME] — adaptive prompts only for choices that affect the project
• YAML: forge new [NAME] --config forge.yaml — fully non-interactive
• Preset: forge new NAME --preset fastapi-postgres — curated stack; no prompts
• Plan: forge plan --preset fastapi-postgres — show resolved GenerationPlan without writing files

--preset and --config cannot be combined. Details: docs/cli.md.

Documentation

Development / contributing

See CONTRIBUTING.md for setup, tests, and architecture orientation.

uv sync
uv run pytest

Versioning

0.1.1 is the current public development release (PyPI distribution forge-scaffolder). See the versioning policy in docs/development.md.

License

GPL-3.0-only. See LICENSE.

Repository

• Source: https://github.com/Lacky227/forge-cli
• Issues: https://github.com/Lacky227/forge-cli/issues

Layout

src/forge/cli/
src/forge/core/          # ProjectDefinition, YAML config, presets
src/forge/generator/     # resolve → GenerationPlan → render
templates/               # Jinja templates (packaged as forge/templates in the wheel)
tests/
scripts/packaging_smoke.sh
docs/