There definitely isnโt one standard (you can find some very long discussions about this state of affairs :sweat_smile: ). There are a lot of options, catering to different styles or sets of requirements.
One resource I think is useful for something-like-a-standard is packaging.python.org. It focuseโฆ Answer from jamestwebber on discuss.python.org
The Hitchhiker's Guide to Python
docs.python-guide.org โบ writing โบ structure
Structuring Your Project โ The Hitchhiker's Guide to Python
Thanks to the way imports and modules are handled in Python, it is relatively easy to structure a Python project. Easy, here, means that you do not have many constraints and that the module importing model is easy to grasp.
Python.org
discuss.python.org โบ python help
Python project structure - Python Help - Discussions on Python.org
October 13, 2023 - Hello, I am a programmer with experience in multiple of programming languages, but not yet in python. I want to start a bigger project, but while googling I find a lot of conflicting advice on how to structure it. Can someone provide me a few links to whatโs the standard today, if there even is 1 standard?
What is the best project structure for a Python application? - Stack Overflow
Any open source python projects you would recommend emulating their directory structure? 2009-10-05T17:02:31.19Z+00:00 ... Look at Django for a good example. More on stackoverflow.com
What is the optimal structure for a Python project?
3 tips from me: When you use typing everywhere then you are forcing yourself to omit the circular dependencies (we cannot have circular dependencies imports in python) between modules which is the easiest way to keep a very basic structure. Think of the modules hierarchy while structuring the python code. Which module is high level (e.g. dashboard, GUI) and which is low level (e.g. some utils module build upon a standard library). Always import a module that has a lower level of abstraction (or in other words, lower complexity) in the module with higher complexity. E.g. GUI module imports storage access module and not the other way around. More on reddit.com
52
253
December 25, 2023Out of curiosity: what is the python project structure you usually go gor?
The usual result I get is the big ball of mud . More on reddit.com
86
95
April 18, 2023Whatโs your approach to organizing Python projects for readability and scalability?
Read software engineering books. The more clean code, design patterns knowledge you have the better. One thing I do is to look at scikit learn source code. Itโs very well coded you learn a lot from it. I simply mimic their file and architectural structure. More on reddit.com
29
41
July 1, 202503:53
Python Project Structure Explained: The Ultimate Guide for 2026 ...
06:47
Python Project Structure for Beginners: Organize Your Code Like a Pro!
09:55
Basic Project Structure for a Python App - YouTube
04:25
What does the structure of a modern Python project look like? - ...
Python HOW TO structure a Beginner OR Advanced Projects ?
20 Beginner Python Projects
Real Python
realpython.com โบ ref โบ best-practices โบ project-layout
project layout | Python Best Practices โ Real Python
A reference guide to common Python application layouts and project structures for command-line applications, web applications, and more. ... Have a question about this? Mentor AI can show you examples, compare related terms, and point you to tutorials. ... Pick a question and Mentor AI takes it from here. ... By Leodanis Pozo Ramos โข Updated Sept. 21, 2026 โข Reviewed by Martin Breuss ... Get a Python Cheat Sheet (PDF...
Top answer 1 of 8
524
Doesn't too much matter. Whatever makes you happy will work. There aren't a lot of silly rules because Python projects can be simple.
/scriptsor/binfor that kind of command-line interface stuff/testsfor your tests/libfor your C-language libraries/docfor most documentation/apidocfor the Epydoc-generated API docs.
And the top-level directory can contain README's, Config's and whatnot.
The hard choice is whether or not to use a /src tree. Python doesn't have a distinction between /src, /lib, and /bin like Java or C has.
Since a top-level /src directory is seen by some as meaningless, your top-level directory can be the top-level architecture of your application.
/foo/bar/baz
I recommend putting all of this under the "name-of-my-product" directory. So, if you're writing an application named quux, the directory that contains all this stuff is named /quux.
Another project's PYTHONPATH, then, can include /path/to/quux/foo to reuse the QUUX.foo module.
In my case, since I use Komodo Edit, my IDE cuft is a single .KPF file. I actually put that in the top-level /quux directory, and omit adding it to SVN.
2 of 8
331
According to Jean-Paul Calderone's Filesystem structure of a Python project:
Project/
|-- bin/
| |-- project
|
|-- project/
| |-- test/
| | |-- __init__.py
| | |-- test_main.py
| |
| |-- __init__.py
| |-- main.py
|
|-- setup.py
|-- README
Medium
medium.com โบ @adityaghadge99 โบ python-project-structure-why-the-src-layout-beats-flat-folders-and-how-to-use-my-free-template-808844d16f35
Python Project Structure: Why the โsrcโ Layout Beats Flat Folders (and How to Use My Free Template) | by Aditya Ghadge | Medium
May 17, 2025 - This layout isnโt magic, but itโs been โjust structured enoughโ for everything from tiny utilities to multi-service RAG pipelines. Copy it, tweak it, and youโll spend more time coding features โ less time chasing folders. A tidy tree is great, but without the right automation glue itโs easy to slip back into chaos. Here are the four guard-rails baked into the template repo (check them out live in the workflow files and configs at Adityag009/python-project-template):
Cosmicpython
cosmicpython.com โบ book โบ appendix_project_structure
Appendix B: A Template Project Structure
All the source code for our app, including the domain model, the Flask app, and infrastructure code, lives in a Python package inside src,[3] which we install using pip install -e and the setup.py file. This makes imports easy. Currently, the structure within this module is totally flat, but for a more complex project, youโd expect to grow a folder hierarchy that includes domain_model/, infrastructure/, services/, and api/.
Real Python
realpython.com โบ python-application-layouts
Python Project Structure: How to Choose the Right Layout โ Real Python
2 hours ago - The patterns youโve seen so far come together in complete Python project structures. The examples below walk from a library to a CLI, through the major web frameworks, and on to a GUI app.
Read the Docs
app.readthedocs.org โบ projects โบ python-project โบ downloads โบ pdf โบ latest pdf
Python Project Documentation Release 1.0 Tim Diels Jan 10, 2018
Python Project is a collection of Python project templates, checklists and documentation of their associated work๏ฌow. Currently, the collection contains just one project structure.
Niftycode
niftycode.eu โบ download โบ Python-Project-Structure.pdf pdf
The structure of a Python project - niftycode
The main.py file contains the Python code. It serves as the entry point for this ... And there's another variation you might encounter in practice. In the following project ยท structure, the project name is used instead of src as the directory name:
GitHub
github.com โบ yngvem โบ python-project-structure
GitHub - yngvem/python-project-structure: An outdated tutorial on how to manage a Python project ยท GitHub
In this part of the tutorial, I ... any Python project to ensure that you won't have to do major effort restructuring the code once you want to publish it. Let us start with the folder layout. Your project directory should be structured in the following way and we will explain why later. project_name โโโ docs โ โโโ make.bat โ โโโ Makefile โ โโโ source โ โโโ conf.py โ โโโ index.rst โโโ examples โ โโโ ...
Scribd
scribd.com โบ document โบ 782439267 โบ Python-Project-File-Structure
Python Project File Structure | PDF | Databases | Information Technology
Python Project File Structure - Free download as PDF File (.pdf), Text File (.txt) or read online for free.
GitHub
github.com โบ nedbat โบ pkgsample
GitHub - nedbat/pkgsample: A simple example of how to structure a Python project ยท GitHub
You should examine the files here, decide which are right for you, and adapt them to your needs. This directory is where you put your code. It should have one subdirectory named for your project, and all of your work goes into that subdirectory.
Reddit
reddit.com โบ r/python โบ what is the optimal structure for a python project?
r/Python on Reddit: What is the optimal structure for a Python project?
December 25, 2023 -
How to structure backend Python project?
Top answer 1 of 19
118
3 tips from me: When you use typing everywhere then you are forcing yourself to omit the circular dependencies (we cannot have circular dependencies imports in python) between modules which is the easiest way to keep a very basic structure. Think of the modules hierarchy while structuring the python code. Which module is high level (e.g. dashboard, GUI) and which is low level (e.g. some utils module build upon a standard library). Always import a module that has a lower level of abstraction (or in other words, lower complexity) in the module with higher complexity. E.g. GUI module imports storage access module and not the other way around.
2 of 19
19
My suggestion is not to follow cookie cutter structures. Every project is different.
GitHub
github.com โบ csymvoul โบ python-structure-template
GitHub - csymvoul/python-structure-template: A Python project to use as a template when developing a Python application ยท GitHub
A python project to use as a template ... project โโโ README.md โโโ example โ โโโ __init__.py โ โโโ package_1 โ โ โโโ __init__.py โ โ โโโ awesome_module.py โ โ โโโ ...
DEV Community
dev.to โบ codemouse92 โบ dead-simple-python-project-structure-and-imports-38c6
Python Package Structure: Dead Simple Python: Project Structure and Imports - DEV Community
April 27, 2022 - Executable projects should have a __main__.py in the top-level package. Then, you can directly execute that package with python -m myproject. Of course, there are a lot more advanced concepts and tricks we can employ in structuring a Python project, but we won't be discussing that here.
Wpcomstaging
waterprogramming.wpcomstaging.com โบ 2023 โบ 01 โบ 18 โบ structuring-a-python-project-recommendations-and-a-template-example
Structuring a Python Project: Recommendations and a Template Example โ Water Programming: A Collaborative Research Blog
January 18, 2023 - Here, I present a recommended structure for new Python projects, and discuss the main components. This is largely targeted at Python users who have not had a formal Python training, or who are working with their first significantly sized project. I provide an example_python_project, hosted on GitHub, as a demonstration and to serve as a template for beginners.
GitHub
gist.github.com โบ ericmjl โบ 27e50331f24db3e8f957d1fe7bbbe510
How to organize your Python data science project ยท GitHub
I have a lesson learned from multiple months of working with other people that led me to this somewhat complicated, but hopefully ultimately useful directory structure. Under this folder called projectname/, we put in a lightweight Python package called projectname that has all things that are refactored out of notebooks to keep them clean. It has an __init__.py underneath it so that we can import functions and variables into our notebooks and scripts: ... In projectname/projectname/config.py, we place in special paths and variables that are used across the project. An example might be:
Coderwall
coderwall.com โบ p โบ lt2kew โบ python-creating-your-project-structure
Python: Creating Your Project Structure (Example)
August 26, 2025 - The Example Application for this text can be found in github.com/mrako/python-example-project. ... In my experience the best folder structure for a Python project is to put your executables in a bin folder and your project into a your project ...
Scribd
scribd.com โบ document โบ 955884562 โบ Python-Project
Python Project Documentation Guide | PDF
JavaScript is disabled in your browser ยท Please enable JavaScript to proceed ยท A required part of this site couldnโt load. This may be due to a browser extension, network issues, or browser settings. Please check your connection, disable any ad blockers, or try using a different browser
Py-pkgs
py-pkgs.org โบ 04-package-structure.html
4. Package structure and distribution โ Python Packages
A special file named __init__.py is used to tell Python that a directory is a package (rather than just a plain-old directory on your computer). Weโll talk more about the __init__.py file and package structure in Section 4.2, but for now, hereโs an example of a simple package structure with two modules and one subpackage: