From 4de50a1712eab679e59a818a505e8240afa4118b Mon Sep 17 00:00:00 2001 From: opencode Date: Mon, 23 Mar 2026 09:50:19 +0100 Subject: [PATCH] =?UTF-8?q?docs:=20riscrive=20QUICKSTART.md=20completo=20c?= =?UTF-8?q?on=20tutte=20le=20funzionalit=C3=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Chat interattiva, Server web, Dashboard, API - CLI configurazione, TUI, Analytics - Comandi memory, planning, skills - Struttura progetto e troubleshooting --- QUICKSTART.md | 204 +++++++++++++++++++++++++++++++++++++------------- 1 file changed, 150 insertions(+), 54 deletions(-) diff --git a/QUICKSTART.md b/QUICKSTART.md index 781d60a..67d6813 100644 --- a/QUICKSTART.md +++ b/QUICKSTART.md @@ -1,102 +1,198 @@ -# Guida Rapida - LangCode Agent +# LangCode Agent - Guida Rapida -Installazione veloce su una macchina nuova. - -## 1. Clona il Repository +## Installazione ```bash +# 1. Clona il repository git clone http://192.168.0.183:8085/truetype/langcode_agent.git cd langcode_agent -``` -## 2. Crea Virtual Environment (consigliato) - -```bash +# 2. Crea e attiva virtual environment python3 -m venv venv source venv/bin/activate -``` -## 3. Installa Dipendenze - -```bash +# 3. Installa dipendenze pip install -r requirements.txt ``` -## 4. Configura Ollama (o altro provider) +--- + +## Configurazione Rapida -### Opzione A: Variabili d'ambiente (veloce) ```bash +# Imposta variabili d'ambiente export MODEL_PROVIDER=ollama export MODEL_NAME=gemma2:9b export OLLAMA_BASE_URL=http://192.168.0.50:11434 ``` -### Opzione B: Configurazione persistente -```bash -# Avvia la CLI -python langcode.py - -# Nella CLI interattiva: -/config add -n mio-ollama -p ollama -m gemma2:9b -u http://192.168.0.50:11434 -/config use mio-ollama -/exit -``` - -## 5. Avvia l'Agent +Oppure usa la CLI interattiva per salvare configurazioni persistenti: ```bash -# ModalitΓ  chat interattiva -python langcode.py - -# Oppure direttamente -python main.py +langcode config add -n ollama -p ollama -m gemma2:9b -u http://192.168.0.50:11434 --set-active +langcode config test ``` -## 6. Comandi Utili +--- -``` -/help - Mostra aiuto -/status - Stato sistema -/memory remember - Salva un fatto -/memory recall - Cerca nella memoria -/plan create "" - Crea piano -/exit - Esci -``` +## ModalitΓ  di Utilizzo -## Troubleshooting +### 1. Chat Interattiva (Agent AI) -### "Module not found" ```bash -source venv/bin/activate -pip install -r requirements.txt +langcode +# oppure +langcode chat ``` -### Ollama non risponde +Chatta con l'agent AI in tempo reale. + +### 2. Server Web (API + Dashboard) + ```bash -# Verifica che Ollama sia attivo -curl http://192.168.0.50:11434/api/tags +langcode server +langcode server --port 8080 +langcode server --host 0.0.0.0 --port 3000 ``` -### cambia provider +Accesso dopo l'avvio: +- 🌐 **Web UI**: http://localhost:8000 +- πŸ“Š **Dashboard**: http://localhost:8000/monitoring +- πŸ›’ **Marketplace**: http://localhost:8000/marketplace +- πŸ“– **API Docs**: http://localhost:8000/docs + +### 3. CLI Configurazione + ```bash -export MODEL_PROVIDER=openai -export MODEL_NAME=gpt-4o -export OPENAI_API_KEY=sk-tuakey +langcode config list # Lista configurazioni +langcode config add -n nome -p ollama -m gemma2:9b -u http://... # Aggiungi +langcode config use nome # Attiva configurazione +langcode config active # Mostra attiva +langcode config test # Testa connessione +langcode config search ollama # Cerca +langcode config export -f json # Esporta +langcode config import backup.json # Importa ``` -## Struttura Base +### 4. TUI Interattiva + +```bash +langcode tui +``` + +Interfaccia testuale per gestire configurazioni. + +### 5. Analytics + +```bash +langcode analytics # Riepilogo rapido +langcode analytics --report # Report completo +langcode dashboard # Dashboard performance +``` + +--- + +## Comandi Interni (nella Chat) + +Durante la chat interattiva (`langcode chat`): + +``` +/help # Aiuto +/status # Stato sistema +/config list # Lista configurazioni +/config use # Cambia configurazione +/models # Elenca modelli +/clear # Pulisci schermo +/exit # Esci +``` + +### Memory (Memoria Persistente) + +``` +/memory remember # Salva un fatto +/memory recall # Cerca fatti +/memory preference set # Imposta preferenza +/memory preference get # Leggi preferenza +/memory stats # Statistiche +``` + +### Planning (Pianificazione) + +``` +/plan create "" "" # Crea piano +/plan list # Elenca piani +/plan progress # Mostra progresso +/plan start # Inizia task +/plan complete # Completa task +``` + +### Skills (Gestione Skills) + +``` +/skills list # Skills installate +/skills search # Cerca skills +/skills install # Installa skill +/skills details # Dettagli skill +/skills uninstall # Disinstalla +``` + +--- + +## Struttura ``` langcode_agent/ -β”œβ”€β”€ langcode.py # CLI entry point +β”œβ”€β”€ langcode.py # CLI unificato (langcode) β”œβ”€β”€ main.py # Agent principale +β”œβ”€β”€ api_server.py # Server web + API β”œβ”€β”€ config_manager.py # Gestione configurazioni +β”œβ”€β”€ config_cli.py # CLI configurazione +β”œβ”€β”€ config_tui.py # TUI configurazione β”œβ”€β”€ skill_manager.py # Gestione skills β”œβ”€β”€ mcp_client.py # Client MCP +β”œβ”€β”€ analytics.py # Analytics +β”œβ”€β”€ dashboard.py # Dashboard performance +β”œβ”€β”€ monitoring.py # Monitoraggio β”œβ”€β”€ enhancements/ # Memory e Planning +β”‚ β”œβ”€β”€ simple_memory.py +β”‚ └── planning_enhancement.py +β”œβ”€β”€ web/ # Frontend web +β”œβ”€β”€ plugins/ # Plugin sistema └── venv/ # Virtual environment ``` --- -**Tempo stimato**: ~5 minuti dall'inizio all'agent funzionante. +## Provider Supportati + +| Provider | Variabili necessarie | +|-------------|---------------------| +| Ollama | `OLLAMA_BASE_URL` | +| OpenAI | `OPENAI_API_KEY` | +| OpenRouter | `OPENROUTER_API_KEY` | +| Anthropic | `ANTHROPIC_API_KEY` | +| Google | `GOOGLE_API_KEY` | + +--- + +## Troubleshooting + +**Agent non si avvia:** +```bash +source venv/bin/activate +pip install -r requirements.txt +``` + +**Ollama non risponde:** +```bash +curl http://192.168.0.50:11434/api/tags +``` + +**Porta giΓ  in uso:** +```bash +langcode server --port 8080 +``` + +--- + +**Tempo installazione**: ~5 minuti