https://github.com/austonianai/python-flask-starter
Flask development template with Docker and hot-reload. A simple, Dockerized Python Flask app template designed to boost your productivity during development with hot-reload functionality.
https://github.com/austonianai/python-flask-starter
backend development-environment docker flask hot-reload microservices python template web-application
Last synced: 2 months ago
JSON representation
Flask development template with Docker and hot-reload. A simple, Dockerized Python Flask app template designed to boost your productivity during development with hot-reload functionality.
- Host: GitHub
- URL: https://github.com/austonianai/python-flask-starter
- Owner: AustonianAI
- Created: 2023-06-05T18:24:40.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-05T20:07:13.000Z (about 3 years ago)
- Last Synced: 2025-08-03T23:37:06.802Z (11 months ago)
- Topics: backend, development-environment, docker, flask, hot-reload, microservices, python, template, web-application
- Language: Dockerfile
- Homepage: https://www.austinjohnson.me
- Size: 2.93 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Flask Docker Development Template
This is a template for a simple Flask application running inside a Docker container with hot-reloading enabled for development.
## Prerequisites
- Docker
- Docker Compose
## Getting Started
These instructions will get you a copy of the project up and running on your local machine for development purposes.
1. Clone the repository:
```bash
git clone https://github.com/AustonianAI/flask-docker-template.git
```
2. Navigate into the cloned repository:
```bash
cd flask-docker-template
```
3. Build the Docker images:
```bash
docker-compose build
```
4. Start the Docker containers:
```bash
docker-compose up
```
The Flask application will be accessible at `http://localhost:5000`.
## Development
The Flask application runs inside a Docker container, with hot-reloading enabled. This means that when you make changes to your Python files, the application will automatically restart and your changes will immediately take effect.
The hot-reloading functionality is provided by `watchdog` and `watchmedo`. These tools are set up to watch the Python files in your application and restart the Flask server whenever a file changes.
## Built With
- [Python 3.11](https://www.python.org/)
- [Flask](https://flask.palletsprojects.com/)
- [Docker](https://www.docker.com/)
- [watchdog](https://pythonhosted.org/watchdog/)
## Contributing
Please read [CONTRIBUTING.md](https://gist.github.com/AustonianAI/8b692731859d4b76670004b50c02ee8c) for details on our code of conduct, and the process for submitting pull requests to us.
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
## Acknowledgments
- Thanks to the Python, Flask, and Docker communities for their awesome tools!