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.
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) and learn the basics of Python, like working with data types, dictionaries, lists, and Python functions:
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 project structure
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 ... More on discuss.python.org
6
1
October 13, 2023What 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? - ...
24:13
My 2025 uv-based Python Project Layout for Production Apps - YouTube
31:49
π Python Project Directory Structures & Unit Test π§ͺ - YouTube
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
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?
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.
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 when developing a Python application. project βββ README.md βββ example β βββ __init__.py β βββ package_1 β β βββ __init__.py β β βββ awesome_module.py β β βββ ...
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.
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
This script on project structure in Python is now in version 3.
GitHub
github.com βΊ nedbat βΊ pkgsample
GitHub - nedbat/pkgsample: A simple example of how to structure a Python project Β· GitHub
Perhaps you need to support more versions (choose a lower requirement) or you want to use some newer Python features (choose a higher requirement). Comments throughout the files, especially in pyproject.toml show where to make these choices, and link to resources that can help. This repo is a demonstration of making a distributable package. 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.
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.
Dagster
dagster.io βΊ blog βΊ python-project-best-practices
How to Structure Python Projects
March 21, 2023 - Properly organizing your code is crucial when working on a Python project. You can start by creating separate folders for different parts of the project, such as one for the code itself, one for data, one for testing, and one for project documentation. This way to structure will help you find what you need more quickly and make it easier for others to navigate your code.
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.
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 ...
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:
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.
Towards Data Science
towardsdatascience.com βΊ home βΊ programming βΊ the good way to structure a python project
The Good way to structure a Python Project | Towards Data Science
February 9, 2022 - Once you have installed all the packages that your project needs, you can run: ... pip freeze is "freezing" all the packages/versions currently being used. Then you are piping (i.e., saving) the output of pip freeze via a txt file. ... You've heard that creating tests for your code is a good idea. So you're writing Python code and trying to test it with Pytest. Example: Let's say you create a file called greetings.py and another one to write some tests called test_greetings.py.
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 β βββ ...