Skip to main content

Bootstrap Python projects with auto-generated structure and README

Project description

🚀 initforge

initforge is a lightweight CLI tool that helps you bootstrap Python projects instantly — without repeating the same setup steps every time.

It generates a clean project structure and a ready-to-use README.md, so you can focus on building instead of configuring.

✨ Features

  • 📁 Auto-detects project name from current directory

  • 🧱 Generates a clean Python project structure

  • 📝 Auto-creates a helpful README.md

  • 🐍 Conda-friendly environment instructions

  • ⚡ Simple, transparent, no hidden magic

  • 🖥️ Works on Windows & Linux

📦 Installation

Install directly from PyPI:

pip install initforge

🚀 Quick Start

Navigate to your project folder and run:

projinit init

You’ll be guided through a few simple prompts:

  • Project name

  • Conda environment name

  • Python version

  • Run command

  • README overwrite confirmation

That’s it — your project is ready.


📁 Generated Structure (example)

my_project/
├── src/my_project/
│   └── __init__.py
├── tests/
│   ├── unit/
│   └── integration/
├── requirements.txt
├── README.md
└── .gitignore

🛠️ Example Workflow

conda create -n my_project python=3.10 -y
conda activate my_project
pip install -r requirements.txt

Then start building 🚀

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

initforge-0.2.0.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

initforge-0.2.0-py3-none-any.whl (9.5 kB view details)

Uploaded Python 3

File details

Details for the file initforge-0.2.0.tar.gz.

File metadata

  • Download URL: initforge-0.2.0.tar.gz
  • Upload date:
  • Size: 6.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for initforge-0.2.0.tar.gz
Algorithm Hash digest
SHA256 87dbb8cf9068d5a258902554ecfdac8369517f42eb5def4b4d524b84f7e56004
MD5 15658d9a7584a3c82885e0cf3025915b
BLAKE2b-256 ca5663b69be710bfff36b82bc53a365cf70dbb76615759ccea9e2b78205a00ce

See more details on using hashes here.

File details

Details for the file initforge-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: initforge-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 9.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for initforge-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 49511fd3db8d31b064895c6377d632ad88b3908e41b3c4b09c3e749c50932aa2
MD5 46b8fd287419ee72be4044efacfba9db
BLAKE2b-256 c4fb98e7de5975de3a9dad112fdb044d8bca6bdff757c5b34dd0b73c1763a229

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page