generated from nathanwoodburn/python-webserver-template
This commit is contained in:
69
README.md
69
README.md
@@ -1,3 +1,68 @@
|
||||
# python-webserver-template
|
||||
# Kite Watch
|
||||
|
||||
Python3 website template including git actions
|
||||
Kite Watch is a web application that helps kite enthusiasts find and share great places to fly kites. Users can submit locations with ratings and notes about wind conditions, accessibility, and other relevant information.
|
||||
|
||||
## Features
|
||||
|
||||
- Submit kite flying locations with a name, notes, and a 1-5 star rating
|
||||
- Browse locations added by other users
|
||||
- Input validation and profanity filtering to maintain quality content
|
||||
- Mobile-friendly responsive design
|
||||
|
||||
## Technologies Used
|
||||
|
||||
- **Backend**: Python, Flask
|
||||
- **Frontend**: HTML, CSS, JavaScript
|
||||
- **Database**: Simple JSON file storage
|
||||
- **Deployment**: Docker support
|
||||
|
||||
## Setup
|
||||
|
||||
### Local Development
|
||||
|
||||
1. Clone the repository:
|
||||
```
|
||||
git clone https://github.com/username/kite-watch.git
|
||||
cd kite-watch
|
||||
```
|
||||
|
||||
2. Create a virtual environment and install dependencies:
|
||||
```
|
||||
python -m venv .venv
|
||||
source .venv/bin/activate # On Windows use: .venv\Scripts\activate
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
3. Run the application:
|
||||
```
|
||||
python main.py
|
||||
```
|
||||
The application will be available at http://localhost:5000
|
||||
|
||||
### Using Docker
|
||||
|
||||
1. Build and run using Docker:
|
||||
```
|
||||
docker build -t kite-watch .
|
||||
docker run -p 5000:5000 -v $(pwd)/data:/data kite-watch
|
||||
```
|
||||
|
||||
2. Use pre-built Docker image:
|
||||
```
|
||||
docker pull git.woodburn.au/nathanwoodburn/kite-watch:latest
|
||||
```
|
||||
|
||||
Then run it with:
|
||||
```
|
||||
docker run -p 5000:5000 git.woodburn.au/nathanwoodburn/kite-watch:latest
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
The application can be configured with environment variables:
|
||||
- `WORKERS`: Number of Gunicorn workers (default: 1)
|
||||
- `THREADS`: Number of threads per worker (default: 2)
|
||||
|
||||
## License
|
||||
|
||||
This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.
|
||||
Reference in New Issue
Block a user