Skip to main content

repogen

A pure-stdlib Python CLI that scaffolds a large, original enterprise-style monorepo from three answers: project name, organization name, and website.

It generates 4000+ files by default: frontend (web / admin / crm / mobile), multiple backend services, a database layer with per-entity migrations, shared SDK / UI / config packages, feature modules, infra (docker / k8s / terraform / CI), docs, and .env files (real + .example + dev + prod) at every level.

  • No network access. Nothing is downloaded or copied from the internet.
  • No third-party dependencies. Standard library only.
  • Original templates. Every emitted file is produced from templates authored inside this package — generic scaffolding, not code lifted from anywhere.
  • Any tech stack. Choose from several stacks; the generators dispatch to the right language and framework.

Install

cd repogen
pip install -e .        # exposes the `repogen` command
# or run without installing:
python -m repogen

Usage

Interactive (prompts for name, org, website, stack):

repogen

Non-interactive:

repogen \
  --name "Acme Cloud" \
  --org "Acme Inc" \
  --website "https://acme.example" \
  --stack fastapi-next-postgres \
  --output ./acme-cloud \
  --yes

Preview the file count without writing anything:

repogen --name Acme --org "Acme Inc" --website acme.example --dry-run --yes

List stacks:

repogen --list-stacks

Stacks

key backend frontend db
fastapi-next-postgres FastAPI Next.js Postgres
express-react-postgres Express React Postgres
django-vue-mysql Django Vue MySQL
nestjs-next-postgres NestJS Next.js Postgres

What gets generated

apps/         web · admin · crm · mobile clients (per-entity pages/screens)
services/     domain backend services (per-entity model/service/router/tests)
packages/     shared sdk · ui · config · pyshared · feature modules
db/           schema · per-entity migrations · seeds · alembic config
infra/        docker-compose · k8s manifests · terraform · nginx gateway
docs/         architecture · runbook · ADRs · OpenAPI stubs
.env*         real + example + development + production, at every level

Flags

flag purpose
--name project / product name
--org organization name
--website public URL
--stack one of the stacks above
--output -o output directory (default ./<slug>)
--target-files minimum file count (default 4000)
--dry-run count only, write nothing
--yes -y skip confirmation
--list-stacks print stacks and exit

Notes on secrets

Generated .env files contain locally-generated random secrets for development convenience. .env.example / .env.production ship placeholder values, and the generated .gitignore excludes real .env files from version control. Rotate before any real deployment.

Metadata

Release files for fuck-repo 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fuck-repo 0.1.0
File Size Uploaded Provenance Actions
fuck_repo-0.1.0.tar.gz 37.0 kB Without provenance Details for fuck_repo-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for fuck-repo 0.1.0
File Interpreter ABI Platform Actions
fuck_repo-0.1.0-py3-none-any.whl Python 3 none any Details for fuck_repo-0.1.0-py3-none-any.whl

Total release size: 83.8 kB

Release files / fuck_repo-0.1.0.tar.gz

Download URL fuck_repo-0.1.0.tar.gz
Size 37.0 kB
Tags Source
SHA-256 checksum
How to use checksums
5583bcd21d26b99cf0319fcc9db865eccab913bdd572d7b8d1e6378a1cfcfb79
BLAKE2b-256 checksum
How to use checksums
4387ea839442c57fed33c610b69515741cbfcb5afe9789effe339a57181e43d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Release files / fuck_repo-0.1.0-py3-none-any.whl

Download URL fuck_repo-0.1.0-py3-none-any.whl
Size 46.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0ce0be60c73eeb9c701813e9010feb46ad185cf280768496c035b9f596206c3d
BLAKE2b-256 checksum
How to use checksums
ff1e864e69f8e28314b8c105a26a8a1bec6bb20f580e47f5e9abe23750bfde81
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Security for fuck-repo 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page