⚡️ 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:
Newer release available (0.26.1)

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.0.tar.gz (503.3 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.0-py3-none-any.whl (240.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: instant_python-0.26.0.tar.gz
  • Upload date:
  • Size: 503.3 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.0.tar.gz
Algorithm Hash digest
SHA256 52842b82b544a719488d63b6f248b2416efb2e7c8728a3fdaa8fe5b46bbda9ed
MD5 a925da9f27feec12ea44eb3f0bf59cbe
BLAKE2b-256 4fe053636948465ee851d8bfafb7748794bb20960d73aae83d95842f844adace

See more details on using hashes here.

Provenance

The following attestation bundles were made for instant_python-0.26.0.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.0-py3-none-any.whl.

File metadata

  • Download URL: instant_python-0.26.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 93317b5799c2a6eb4613a2af1ea12d44af6977a274750871abefcb651ad35774
MD5 da820f26830bf2169d508908fe733f2f
BLAKE2b-256 deba2bfa867a39490d8a394477f23667169ccfd3e62253819a1570234756d7a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for instant_python-0.26.0-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

0.26.1

2 files

This release

0.26.0 This release

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