{"id":24062122,"url":"https://github.com/habedi/template-python-project","last_synced_at":"2026-06-18T09:32:00.317Z","repository":{"id":222939293,"uuid":"758772036","full_name":"habedi/template-python-project","owner":"habedi","description":"A template for data science and machine learning projects in Python 🐍","archived":false,"fork":false,"pushed_at":"2025-08-02T17:48:37.000Z","size":32,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-08-02T19:42:56.263Z","etag":null,"topics":["data-science","machine-learning","project-template","python","quality-of-life","software-development","template","template-repository"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/habedi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-02-17T03:24:02.000Z","updated_at":"2025-05-30T05:37:17.000Z","dependencies_parsed_at":"2024-02-17T06:24:33.155Z","dependency_job_id":"68c4a3cb-0e1c-4d35-8011-d6ad21c72486","html_url":"https://github.com/habedi/template-python-project","commit_stats":null,"previous_names":["habedi/template-python-project-repo","habedi/template-python-project"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/habedi/template-python-project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/habedi%2Ftemplate-python-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/habedi%2Ftemplate-python-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/habedi%2Ftemplate-python-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/habedi%2Ftemplate-python-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/habedi","download_url":"https://codeload.github.com/habedi/template-python-project/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/habedi%2Ftemplate-python-project/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34485163,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-science","machine-learning","project-template","python","quality-of-life","software-development","template","template-repository"],"created_at":"2025-01-09T08:13:14.466Z","updated_at":"2026-06-18T09:32:00.283Z","avatar_url":"https://github.com/habedi.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Python ML/DS Project Template\n\n\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003cimg alt=\"Python Project Template\" src=\"docs/assets/images/logo.svg\" height=\"25%\" width=\"25%\"\u003e\n  \u003c/picture\u003e\n\u003c/div\u003e\n\n[![Tests](https://img.shields.io/github/actions/workflow/status/habedi/template-python-project/tests.yml?label=tests\u0026style=flat\u0026labelColor=333333\u0026logo=github\u0026logoColor=white)](https://github.com/habedi/template-python-project/actions/workflows/tests.yml)\n[![Code Coverage](https://img.shields.io/codecov/c/github/habedi/template-python-project?style=flat\u0026label=coverage\u0026labelColor=333333\u0026logo=codecov\u0026logoColor=white)](https://codecov.io/gh/habedi/template-python-project)\n[![Code Quality](https://img.shields.io/codefactor/grade/github/habedi/template-python-project?style=flat\u0026label=code%20quality\u0026labelColor=333333\u0026logo=codefactor\u0026logoColor=white)](https://www.codefactor.io/repository/github/habedi/template-python-project)\n[![Python Version](https://img.shields.io/badge/python-%3E=3.10-3776ab?style=flat\u0026labelColor=333333\u0026logo=python\u0026logoColor=white)](https://github.com/habedi/template-python-project)\n[![Documentation](https://img.shields.io/badge/docs-latest-8ca0d7?style=flat\u0026labelColor=333333\u0026logo=read-the-docs\u0026logoColor=white)](https://github.com/habedi/template-python-project/blob/main/docs)\n[![License](https://img.shields.io/badge/license-MIT-00acc1?style=flat\u0026labelColor=333333\u0026logo=open-source-initiative\u0026logoColor=white)](https://github.com/habedi/template-python-project/blob/main/LICENSE)\n[![Managed with Poetry](https://img.shields.io/badge/managed%20with-Poetry-60A5FA?style=flat\u0026logo=poetry\u0026labelColor=333333\u0026logoColor=white)](https://python-poetry.org/)\n[![Managed with uv](https://img.shields.io/badge/managed%20with-uv-000000?style=flat\u0026logo=uv\u0026labelColor=333333\u0026logoColor=white)](https://astral.sh/uv)\n[![Makefile](https://img.shields.io/badge/managed%20with-Makefile-000000?style=flat\u0026logo=gnu\u0026labelColor=333333\u0026logoColor=white)](https://www.gnu.org/software/make/)\n\n---\n\nThis is a template for Python projects, specifically designed for machine learning (ML) and data science (DS) projects.\nI made it to help me have a consistent structure across all my personal and professional projects.\nI am sharing it here in case it can be useful to others.\n\n### Features\n\n- A predefined file and folder layout that should be suitable for most ML and DS projects.\n- Easy dependency and environment management with [Poetry](https://python-poetry.org/), [uv](https://astral.sh/uv), or\n  any other modern Python dependency manager.\n- Extra configuration files for various tasks like linting, formatting, testing, etc.\n- Comes with a lot of quality-of-life features to help you get started quickly, like a `Makefile` and GitHub Actions\n  workflows for common tasks.\n\n### Prerequisites\n\n- `Python` \u003e= 3.10\n- `Poetry 2.0+` (or any other modern Python dependency manager like `uv`)\n- `GNU Make`\n\n### Usage\n\nUse the `Use this template` button on GitHub to create a new repository based on this template.\nModify the `README.md` file and other files as needed.\nRun `make help` to see all available commands for managing different tasks.\n\n### Structure\n\n```plaintext\ntemplate-python-project/\n├── scripts/     # Helper scripts for various tasks\n├── data/        # Raw and processed data files\n├── notebooks/   # Jupyter notebooks\n├── src/         # Source code for the project\n├── models/      # ML models and model artifacts\n├── tests/       # Project tests\n├── pyproject.toml  # Python project configuration\n├── LICENSE      # Project license file\n├── docs/    # Project documentation\n└── Makefile     # Makefile for managing development tasks\n```\n\n---\n\n### Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to make a contribution.\n\n### License\n\nThis template is licensed under the MIT License ([LICENSE](LICENSE) or https://opensource.org/licenses/MIT)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhabedi%2Ftemplate-python-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhabedi%2Ftemplate-python-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhabedi%2Ftemplate-python-project/lists"}