AVO AI CLI

Anteprima Terminale

Descrizione

AVO AI CLI è la versione da terminale dell'assistente AI AVO, creato nelle Isole Canarie. Questa interfaccia da riga di comando ti permette di interagire con AVO AI direttamente dal tuo terminale, con un'interfaccia colorata e interattiva.

Caratteristiche

• 🤖 Chat interattiva con l'assistente AI
• 🌍 Supporto multilingua (Italiano, Inglese, Spagnolo, Francese, Tedesco, Polacco, Palmero)
• 🗺️ Funzionalità basate sulla posizione (meteo, escursioni, ristoranti, punti di interesse)
• 🎨 Interfaccia colorata e intuitiva
• 📊 Gestione dei limiti giornalieri di utilizzo
• 🤖 Possibilità di scegliere tra diversi modelli AI (DeepSeek e modelli Groq come Llama 3, Mixtral, Gemma)
• 🤖 Supporto per diversi modelli AI con vari livelli di moderazione

Requisiti

• Node.js (v14 o superiore)
• npm o yarn
• macOS (testato su macOS Monterey e versioni successive)

Configurazione delle chiavi API

AVO AI CLI richiede alcune chiavi API per funzionare correttamente:

1. DeepSeek API Key: Per le funzionalità di chat e AI
2. OpenWeather API Key: Per le informazioni meteo
3. PlantNet API Key: Per l'identificazione delle piante
4. Groq API Key: (Opzionale) Per accedere a modelli AI aggiuntivi tramite l'API Groq (es. Llama 3, Mixtral, Gemma)

Per configurare queste chiavi:

1. Crea un file .env nella directory principale dell'applicazione
2. Copia il contenuto del file .env.example nel tuo file .env
3. Sostituisci i valori di esempio con le tue chiavi API

# Esempio di file .env
DEEPSEEK_API_KEY=your_deepseek_api_key_here
OPENWEATHER_API_KEY=your_openweather_api_key_here
PLANTNET_API_KEY=your_plantnet_api_key_here
GROQ_API_KEY=your_groq_api_key_here
# GROQ_API_URL=https://api.groq.com/openai/v1 # Generalmente non necessario, ma incluso per completezza

Nota: Il file .env non viene incluso nel pacchetto pubblicato su npm per motivi di sicurezza. Ogni utente deve creare il proprio file .env con le proprie chiavi API.

Installazione

Metodo 1: Installazione tramite script (Consigliato)

# Scarica e esegui lo script di installazione
curl -fsSL https://hablaconavo.es/cli/install.sh | bash

Questo script automatizzerà l'intero processo di installazione, inclusa la configurazione del comando globale avo.

Metodo 2: Installazione manuale

# Clona il repository
git clone https://github.com/avoagency/avo-ai.git
cd "avo-ai/cli"

# Installa le dipendenze
npm install

# Compila il codice TypeScript
npm run build

# Crea un link simbolico globale
npm link

Metodo 3: Installazione da NPM

# Installa globalmente da NPM
npm install -g avo-ai-cli

Utilizzo

Dopo l'installazione, puoi avviare AVO AI CLI con il comando:

avo-ai

Opzioni di avvio

# Avvia con una lingua specifica
avo-ai --language en  # Disponibili: it, en, es, fr, de, pl, palmero

# Mostra la versione
avo-ai --version

# Mostra l'aiuto
avo-ai --help

Comandi disponibili durante la chat

Durante la sessione di chat, puoi utilizzare i seguenti comandi:

• /help - Mostra la guida dei comandi
• /weather - Ottieni informazioni meteo per la tua posizione
• /hiking - Ricevi suggerimenti per escursioni
• /restaurants - Trova ristoranti nelle vicinanze
• /around - Scopri punti di interesse intorno a te
• /clear - Pulisci la cronologia della chat
• /language - Cambia lingua
• /model - Cambia il modello AI utilizzato
• /exit o /quit - Esci dall'applicazione

Limiti di utilizzo

AVO AI CLI mantiene gli stessi limiti della versione web:

• 10 domande al giorno per la chat generale
• 3 identificazioni di piante al giorno

Modelli AI supportati

AVO AI CLI ti permette di scegliere tra diversi modelli AI per personalizzare la tua esperienza. Il modello predefinito è DeepSeek, ma puoi cambiarlo utilizzando il comando /model o tramite il menu principale.

Modelli disponibili:

• DeepSeek (Predefinito): Fornito tramite l'API DeepSeek. Ottimo per conversazioni generali e richieste specifiche, con un'alta moderazione per risposte sicure.
• Gemma 2 9B IT (Groq): Accessibile tramite l'API Groq (richiede GROQ_API_KEY). Versione specifica per l'italiano del modello Gemma 2 di Google, ottimizzata per prestazioni e qualità in questa lingua.
• Llama 3.1 70B Versatile (Groq): Accessibile tramite l'API Groq. Versione da 70 miliardi di parametri di Llama 3.1 di Meta, offre elevate capacità e versatilità per un'ampia gamma di task complessi.
• Llama 3.1 8B Instant (Groq): Accessibile tramite l'API Groq. Versione da 8 miliardi di parametri di Llama 3.1 di Meta, ottimizzata per risposte istantanee e interazioni rapide.
• Llama3 70B (Groq): Accessibile tramite l'API Groq. Il modello Llama3 da 70 miliardi di parametri, potente e adatto a compiti che richiedono una profonda comprensione del contesto.
• Llama3 8B (Groq): Accessibile tramite l'API Groq. Il modello Llama3 da 8 miliardi di parametri, una scelta bilanciata per velocità ed efficacia.

Se la GROQ_API_KEY non è configurata nel tuo file .env, saranno disponibili solo i modelli forniti tramite l'API DeepSeek.

Sviluppo

Per eseguire l'applicazione in modalità sviluppo:

cd "Avo Agency/AVO AI/cli"
npm run dev

Licenza

MIT

Crediti

Creato con ❤️ a La Palma - Isole Canarie da Avo Agency