Hugging Face's logo

Spaces:
mtornani
/
rooting-future
Sleeping

App Files Community
rooting-future / DEPLOY_KOYEB.md
mtornani's picture
mtornani
Initial HF Spaces deployment (clean branch without large binaries)
38f9c15
preview code
|
Raw History Blame Contribute Delete
2.79 kB

Deploy Rooting Future su Koyeb (Gratis Permanente)

Perché Koyeb?

  • Gratis permanente (non trial!)
  • Always-on (no cold start)
  • PostgreSQL incluso
  • 512MB RAM
  • Deploy automatico da GitHub

Prerequisiti

  1. Account GitHub con il repository Rooting Future
  2. Account Koyeb (gratuito): https://app.koyeb.com/auth/signup

Step 1: Preparazione Repository

Assicurati che questi file siano nel repository:

Procfile                  # Configurazione Gunicorn
runtime.txt              # Versione Python
requirements-koyeb.txt   # Dipendenze

Step 2: Crea Account Koyeb

  1. Vai su https://app.koyeb.com/auth/signup
  2. Registrati con GitHub (consigliato) o email
  3. NON serve carta di credito

Step 3: Crea Nuovo Servizio

  1. Click su "Create Service"
  2. Seleziona "GitHub" come source
  3. Autorizza Koyeb ad accedere al tuo repository
  4. Seleziona il repository rooting-future
  5. Branch: main (o master)

Step 4: Configura Build

  • Builder: Buildpack
  • Run command: lascia vuoto (usa Procfile)
  • Instance type: Free (nano)

Step 5: Configura Environment Variables

Clicca su "Environment variables" e aggiungi:

Variable Valore
GEMINI_API_KEY La tua API key di Google AI Studio
SERPER_API_KEY La tua API key di Serper.dev
TAVILY_API_KEY (opzionale) API key Tavily
SECRET_KEY Una stringa casuale lunga (es: my-super-secret-key-12345)
FLASK_ENV production
PORT 8000

Come ottenere le API Keys:

Gemini API Key (Gratis):

  1. Vai su https://aistudio.google.com/app/apikey
  2. Click "Create API Key"
  3. Copia la chiave

Serper API Key (Gratis 2500 query/mese):

  1. Vai su https://serper.dev
  2. Registrati
  3. Copia la API key dalla dashboard

Step 6: Deploy

  1. Click "Deploy"
  2. Attendi 2-5 minuti per il build
  3. Una volta verde, clicca sul link pubblico

Il tuo URL sarà tipo: https://rooting-future-tuonome.koyeb.app

Step 7: Verifica

  1. Apri l'URL nel browser
  2. Dovresti vedere la pagina di attivazione licenza
  3. Genera una licenza admin e attiva

Troubleshooting

Build fallisce

  • Controlla i log di build
  • Verifica che requirements-koyeb.txt sia corretto

App non si avvia

  • Controlla i log runtime
  • Verifica le environment variables

Errore API Gemini

  • Verifica che GEMINI_API_KEY sia corretta
  • Controlla i limiti gratuiti di Gemini

Aggiornamenti

Ogni push su GitHub triggera un nuovo deploy automatico!

git add .
git commit -m "Update"
git push

Limiti Free Tier Koyeb

  • 1 web service
  • 512MB RAM
  • 0.1 vCPU
  • Sufficiente per uso normale (< 1000 utenti/giorno)

Supporto

Per problemi: