{"id":18877494,"url":"https://github.com/davidjnevin/template-python-fastapi-docker-postgres","last_synced_at":"2026-04-09T20:44:17.576Z","repository":{"id":219281011,"uuid":"748645715","full_name":"davidjnevin/template-python-fastapi-docker-postgres","owner":"davidjnevin","description":"A hexagonal architecture template repository for Python, FastAPI, PostgreSQL with settings that suit my new project needs.","archived":false,"fork":false,"pushed_at":"2024-01-31T13:05:37.000Z","size":40,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-31T02:23:56.103Z","etag":null,"topics":["docker","fastapi","flit","hexagonal-architecture","postgresql","python"],"latest_commit_sha":null,"homepage":"","language":"Makefile","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/davidjnevin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-01-26T13:02:09.000Z","updated_at":"2024-01-26T23:09:08.000Z","dependencies_parsed_at":"2024-01-31T14:27:17.850Z","dependency_job_id":null,"html_url":"https://github.com/davidjnevin/template-python-fastapi-docker-postgres","commit_stats":null,"previous_names":["davidjnevin/template-python-fastapi-docker-postgres"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidjnevin%2Ftemplate-python-fastapi-docker-postgres","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidjnevin%2Ftemplate-python-fastapi-docker-postgres/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidjnevin%2Ftemplate-python-fastapi-docker-postgres/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidjnevin%2Ftemplate-python-fastapi-docker-postgres/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidjnevin","download_url":"https://codeload.github.com/davidjnevin/template-python-fastapi-docker-postgres/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239837414,"owners_count":19705348,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["docker","fastapi","flit","hexagonal-architecture","postgresql","python"],"created_at":"2024-11-08T06:19:35.483Z","updated_at":"2026-02-19T00:30:18.452Z","avatar_url":"https://github.com/davidjnevin.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# A Hexagonal Quickstart Template\n\nThis is python, fastapi, postgres and docker quickstart template for Hexagonal Architecture projects.\n\nThis is an ongoing work in progress and is based on [Shako Rzayev's](https://github.com/ShahriyarR) hexagonal architecture repositories combined with [Python Alicante's](https://github.com/pythonalicante) meetup selector repository for docker setup.\n\n## Setup\n\nPull down the files to your empty initialized repo.\n\nUnzip the files and delete the repo.zip file.\n\nCopy the files to the root of your repo.\n\nDelete the downloaded repo.zip file and the unzipped subfolder.\n\n```\ncurl -sL https://github.com/davidjnevin/template-python-fastapi-docker-postgres/archive/master.zip -o repo.zip\nunzip repo.zip\ncp -r template-python-fastapi-docker-postgres-main/ .\nrm -rf template-python-fastapi-docker-postgres-main\n```\n\n### Update the App Name to a project name of your choice\n\nUpdate the repo url in `pyproject.toml`.\n\nChange 'appname' and description in `src/appname/__init__.py`\n\nChange 'appname' folder to the project name.\n\nChange 'appname' to the project name in:\n1.\t`MakeFile` (migrations, migrate and run commands)\n1.\t`pyproject.toml`\n\n## Usage:\n\nInstall pre-commit\n\n```bash\npre-commit install\n```\n\nCreate and then edit the .env file\n\n```bash\ncp example.env .env\n```\n\n### Review the make comands avaialble\n\n```bash\nmake help\n```\n\nFor local development\n\n```bash\nmake setup \u0026\u0026 make install-dev\n```\n\nStart Docker container - neccessary for testing\n\n```\nmake build\n```\n\nNote: I am using a requirements.txt and requirements-dev.txt until I understand how to use `Flit` in a docker build. This may change soon, but for the moment neccessitates copying from pyproject to the requirement files.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidjnevin%2Ftemplate-python-fastapi-docker-postgres","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidjnevin%2Ftemplate-python-fastapi-docker-postgres","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidjnevin%2Ftemplate-python-fastapi-docker-postgres/lists"}