Installazione

Requisiti di Sistema

Prima di installare Flux, assicurati che il tuo sistema soddisfi i seguenti requisiti:

• Python 3.8+ (Flux è scritto in Python)
• pip (gestore pacchetti Python)
• Git (per installare dal repository)
• MariaDB/MySQL o PostgreSQL (opzionale, per database)

Metodi di Installazione

# Installa Flux
pip install flux-lang

# Verifica l'installazione
flux --version

# Crea un ambiente virtuale
python -m venv flux-env

# Attiva l'ambiente (Linux/Mac)
source flux-env/bin/activate

# Attiva l'ambiente (Windows)
flux-env\Scripts\activate

# Installa Flux
pip install flux-lang

git clone https://github.com/profpaul/flux.git
cd flux

pip install -r requirements.txt

pip install -e .

# Pull dell'immagine Docker
docker pull profpaul/flux:latest

# Esegui un container interattivo
docker run -it --rm profpaul/flux:latest flux

# O monta una directory locale
docker run -it --rm -v $(pwd):/app profpaul/flux:latest flux run app.flux

version: '3.8'
services:
  flux:
    image: profpaul/flux:latest
    volumes:
      - .:/app
    ports:
      - "8000:8000"
    environment:
      - FLUX_ENV=development
    command: flux serve --host 0.0.0.0

  db:
    image: mariadb:latest
    environment:
      - MYSQL_ROOT_PASSWORD=flux
      - MYSQL_DATABASE=flux_app
    ports:
      - "3306:3306"

Configurazione Post-Installazione

1. Verifica l'Installazione

# Controlla la versione
flux --version

# Mostra i comandi disponibili
flux --help

# Esegui il REPL interattivo
flux repl

2. Configura l'Editor

Installa il supporto per Flux nel tuo editor preferito:

• VS Code: Installa l'estensione "Flux Language Support"
• Sublime Text: Installa il package "Flux Syntax"
• Vim/Neovim: Aggiungi flux-vim al tuo gestore plugin

3. Crea il Primo Progetto

# Crea una nuova directory
mkdir mio-progetto-flux
cd mio-progetto-flux

# Inizializza il progetto
flux init

# Struttura creata:
# mio-progetto-flux/
# ├── app.flux          # File principale
# ├── config.flux       # Configurazione
# ├── routes/           # Directory routes
# ├── models/           # Directory models
# └── templates/        # Directory templates

Risoluzione Problemi

Errori Comuni

• "flux: command not found"
  Assicurati che la directory Scripts/bin di Python sia nel PATH
• "Python 3.8+ required"
  Aggiorna Python alla versione richiesta
• Errori di permessi
  Usa sudo (Linux/Mac) o esegui come amministratore (Windows)