Files
hersel.it/README.md
2025-04-27 18:32:25 +02:00

97 lines
2.0 KiB
Markdown

# Python Server - Hersel.it
Questo progetto è un'applicazione web sviluppata con **Quart** e configurata per essere eseguita tramite **Hypercorn**
## Requisiti
- Python 3.10 o superiore
- Pip (gestore dei pacchetti Python)
# Installazione
1. Clona il repository:
```bash
git clone https://github.com/BluLupo/hersel.it.git
cd hersel.it
```
2. Crea Ambiente Virtuale
```bash
python3 -m venv env
```
3. Attiva Ambiente Virtuale
```bash
source env/bin/activate
```
4. Installa Le Dipendenze
```bash
pip install -r requirements.txt
```
# Configurazione
Modifica il file <b>hypercorn_config.toml</b> se necessario per adattarlo al tuo ambiente
Esempio di configurazione predefinita (hypercorn_config.toml):
```toml
bind = "0.0.0.0:5000"
workers = 1
reload = true
```
# Avvio Applicazione
```bash
hypercorn -c hypercorn_config.toml app:app
```
# 🚀 Avvio dell'applicazione con Docker
Questa applicazione utilizza Quart come web framework asincrono e Hypercorn come ASGI server
⚙️ Requisiti
- Docker
- Docker Compose
# 📄 Come avviare l'applicazione
1 - Crea un nuovo file docker-compose.yml nella tua macchina, con il seguente contenuto (oppure copialo direttamente da <a href="https://github.com/BluLupo/hersel.it/blob/master/docker-compose.yml">Qui</a> ):
```yml
version: "3.9"
services:
quartapp:
image: python:3.10-slim
container_name: quartapp
working_dir: /app
ports:
- "127.0.0.1:5000:5000"
restart: always
command: >
sh -c "
apt-get update &&
apt-get install -y git &&
[ -d /app/.git ] || git clone https://github.com/BluLupo/hersel.it.git /app &&
pip install --no-cache-dir -r requirements.txt &&
hypercorn -c hypercorn_config.toml app:app
"
environment:
- PYTHONUNBUFFERED=1
```
2 - Esegui il servizio con Docker Compose:
```bash
docker-compose up
```
# 🔗 Accesso all'applicazione
Una volta avviata, l'applicazione sarà accessibile da:
```bash
http://127.0.0.1:5000
```