⚡️ Instant Boilerplate for Python Projects ⚡️

Fast, easy and reliable project generator for your Python projects.

Getting Started  •  Usage  •  How to: Custom Projects  •  AI Agent Harness

Instant Python replaces extensive manual setup with a simple command to get started quickly. Its motivation is to emulate commands like `ng new` or `create-react-app`, but for Python projects.

Why use Instant Python? Generating your Python project with Instant Python lets you:

  • ⏱️ Slash folder & config setup time to seconds
  • 🐍 Instantly install & switch between any Python version
  • 🔧 Effortlessly configure your favorite project manager
  • 📁 Kickstart with ready-made or fully custom project structures
  • 🔄 Initialize a Git repo in just a few clicks
  • 📦 Auto-install all your go-to dependencies
  • 🚀 Ship with production-ready boilerplates out of the box
  • 🤖 Include a complete AI agent setup for assisted development

🚀 Quick Start

Once installed, generating a project takes two commands:

ipy config   # answer a few questions through an interactive wizard to create your ipy.yml configuration file
ipy init     # generate the project from that configuration file
  • ipy config asks you about your project (name, Python version, project manager, template, dependencies, and more) and writes an ipy.yml configuration file in the current directory.
  • ipy init reads that ipy.yml file and generates your new project.

See the First Steps guide for a full walkthrough.

✨ NEW ✨ Create Fully Customized Projects

Take full control of your project generation! With custom templates, you can:

  • 🎨 Design your own project structure that matches your architectural patterns (like Hexagonal Architecture)
  • 📝 Create reusable file templates with your standardized code and best practices
  • 🔄 Enforce consistency across all your Python projects
  • ⚡ Eliminate repetitive boilerplate and setup tasks

Whether you have a standardized project structure you always use or specific architectural patterns you want to enforce, custom templates let you generate projects exactly the way you want them. Learn how to create your first custom template and level up your project generation workflow!

🤖 AI Agents Setup

Generate projects with a pre-configured AI agent environment to assist your development workflow. When you include the ai_agents built-in feature, your project comes with:

  • AGENTS.md — Project rules and guidelines that configure AI agents to follow your coding standards
  • Skills — Reusable instruction sets for common tasks: code review, refactoring, story splitting, test analysis, and more
  • Commands — On-demand workflows for recurring operations: committing changes, running security reviews, analyzing technical debt
  • Architecture Decision Records (ADR) — Templates to document and track technical decisions
  • Design Docs — Templates to capture feature requirements and implementation plans

All generated under docs/ and .agents/ directories, ready to use with any AI coding assistant that supports agent configuration. See all available skills and commands.

Navigation Guide

This section provides a high-level overview of the instant-python documentation so can quickly find what you need.

For Users

For Developers

  • Contributing: learn how to contribute to instant-python development.
  • Releases: understand our release process and versioning.
  • Security: understand our security policies and reporting procedures.

Need help?

🔒 Privacy & Usage Metrics

To improve instant-python and provide a better experience, we collect anonymous usage metrics. No personal or sensitive information is collected.

What we collect:

  • Command executed and IPY version
  • Operating system type
  • Python version, dependency manager, and template choices
  • Error types (when commands fail)

What we DON'T collect:

  • No file paths, project names, or code content
  • No personal information or IP addresses

How to opt out: Set the environment variable IPY_METRICS_ENABLE=false

For complete details, see our Privacy & Metrics documentation.

Project links

Data verified by PyPI on Sep 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dimanu-py from gravatar.com dimanu-py

Credits

Author: dimanu-py

GitHub Statistics

Data verified by PyPI on Sep 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache License

Requires

Python >=3.10

Provides Extra

build

Classifiers

Report project as malware

Download files

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

Source Distribution

instant_python-0.26.1.tar.gz (503.4 kB view details)

Uploaded Source

Built Distribution

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

instant_python-0.26.1-py3-none-any.whl (240.3 kB view details)

Uploaded Python 3

File details

Details for the file instant_python-0.26.1.tar.gz.

File metadata

  • Download URL: instant_python-0.26.1.tar.gz
  • Upload date:
  • Size: 503.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for instant_python-0.26.1.tar.gz
Algorithm Hash digest
SHA256 969d4264e657c30f5c77750e430a939bc01fa3bcc97f23d68cf64a1b2bdf80f9
MD5 c3c0bee0023a9b1993cbc14ef7a5b83f
BLAKE2b-256 b0df4b40c139edbf10bcf3c8ad56faca80d3228b5a26b8bb9f9600d092243fdb

See more details on using hashes here.

Provenance

The following attestation bundles were made for instant_python-0.26.1.tar.gz:

Publisher: release.yml on dimanu-py/instant-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file instant_python-0.26.1-py3-none-any.whl.

File metadata

  • Download URL: instant_python-0.26.1-py3-none-any.whl
  • Upload date:
  • Size: 240.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for instant_python-0.26.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0e111f8f0ba951fbd29cd5b60f800874d98b85093c2f73ba8c3384cb0ac2f717
MD5 58f807aaf39fc1d40274457abea9b5bf
BLAKE2b-256 f0ebb81a47b1f49c5b83adac95e500648e246e3ee3a6eb91155cc97831df11dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for instant_python-0.26.1-py3-none-any.whl:

Publisher: release.yml on dimanu-py/instant-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.26.1 This release

2 files

0.26.0

2 files

0.25.0

2 files

0.24.2

2 files

0.24.1

2 files

0.24.0

2 files

0.23.2

2 files

0.23.1

2 files

0.23.0

2 files

0.22.0

2 files

0.21.0

2 files

0.20.0

2 files

0.19.1

2 files

0.19.0

2 files

0.18.1

2 files

0.18.0

2 files

0.17.0

2 files

0.16.0

2 files

0.15.2

2 files

0.15.1

2 files

0.15.0

2 files

0.14.0

2 files

0.13.0

2 files

0.12.1

2 files

0.12.0

2 files

0.11.0

2 files

0.10.0

2 files

0.9.2

2 files

0.9.1

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.0

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.0

2 files

0.1.1

2 files

0.0.1

2 files

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