{"id":15679902,"url":"https://github.com/robmarkcole/simple-fastapi-webapp","last_synced_at":"2025-08-18T10:04:43.827Z","repository":{"id":54981531,"uuid":"330557831","full_name":"robmarkcole/simple-fastAPI-webapp","owner":"robmarkcole","description":"Use fastAPI to generate html web app that will serve a local directory or S3 bucket of images","archived":false,"fork":false,"pushed_at":"2021-01-18T08:44:19.000Z","size":14,"stargazers_count":11,"open_issues_count":4,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-17T11:46:32.953Z","etag":null,"topics":["fastapi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robmarkcole.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}},"created_at":"2021-01-18T04:52:30.000Z","updated_at":"2024-07-22T05:41:19.000Z","dependencies_parsed_at":"2022-08-14T08:01:13.040Z","dependency_job_id":null,"html_url":"https://github.com/robmarkcole/simple-fastAPI-webapp","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/robmarkcole/simple-fastAPI-webapp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmarkcole%2Fsimple-fastAPI-webapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmarkcole%2Fsimple-fastAPI-webapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmarkcole%2Fsimple-fastAPI-webapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmarkcole%2Fsimple-fastAPI-webapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robmarkcole","download_url":"https://codeload.github.com/robmarkcole/simple-fastAPI-webapp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmarkcole%2Fsimple-fastAPI-webapp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270975281,"owners_count":24678273,"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","status":"online","status_checked_at":"2025-08-18T02:00:08.743Z","response_time":89,"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":["fastapi"],"created_at":"2024-10-03T16:38:59.585Z","updated_at":"2025-08-18T10:04:43.805Z","avatar_url":"https://github.com/robmarkcole.png","language":"Python","readme":"# simple-fastAPI-webapp\nUse fastAPI to generate html web app that will serve a local directory or S3 bucket of image thumbnails and metadata, and provide links to the full sized images which can be downloaded. The endpoints can also be accessed programmatically via a rest API. Docker, python and fastAPI are the core technologies. Minimalism is preferred over a shiny interface, and it must be easy to put into production.\n\nWhy [fastAPI](https://fastapi.tiangolo.com/) over flask? Read [this article](https://amitness.com/2020/06/fastapi-vs-flask/) for a detailed intro to the topic, but for me the big advantages are built in type validation, auto generated docs, and less boilerplate.\n\n## Docker build and run\n```\ndocker build -t webapp .\ndocker run -p 8000:8000 webapp:latest\n```\nThen visit [http://127.0.0.1:8000/](http://127.0.0.1:8000/). The docs are at [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs).\n\n## Development in venv\n- `python3.7 -m venv venv`\n- `source venv/bin/activate`\n- `pip3 install -r requirements.txt`\n- `uvicorn main:app --reload`\n- [http://127.0.0.1:8000/](http://127.0.0.1:8000/)\n\n## References\n- https://fastapi.tiangolo.com/advanced/custom-response/ -\u003e fastAPI HTML docs\n- https://eugeneyan.com/writing/how-to-set-up-html-app-with-fastapi-jinja-forms-templates/ article and [code](https://github.com/eugeneyan/fastapi-html)\n- https://haltakov.net/simple-photo-gallery/ -\u003e flask app for serving image thumbnails as html app\n- [File Management with AWS S3, Python, and Flask](https://stackabuse.com/file-management-with-aws-s3-python-and-flask/) -\u003e flask app for uploading and downloading files to S3, with [code](https://github.com/ro6ley/flask-drive)\n- https://github.com/robmarkcole/text-insights-app/tree/master/tesseract-engine -\u003e fastAPI in docker","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobmarkcole%2Fsimple-fastapi-webapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobmarkcole%2Fsimple-fastapi-webapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobmarkcole%2Fsimple-fastapi-webapp/lists"}