Guida Rapida

🇮🇹 Italiano · 🇬🇧 English

_{Generated from README-it.md — edit that file in the repository, not this page.}

---

Primi passi

Servono Git, Node.js e npm, oltre all'accesso a un backend LLM. Il pacchetto richiede Node.js 18 o successivo; il progetto consiglia la versione 20 o successiva. TSUKA funziona su Windows, Linux e macOS.

1. Installa dal sorgente

git clone https://github.com/nispa/tsuka.git
cd tsuka
npm install
npm run build
npm link

npm link rende disponibile il comando tsuka anche fuori dal repository.

2. Collega un modello

Per un ambiente locale, avvia il backend e carica un modello con supporto alle chiamate di tool. La configurazione Ollama inclusa usa http://localhost:11434/v1 e qwen2.5-coder:7b.

Se usi Ollama e il servizio non è già attivo, avvia ollama serve. In un altro terminale, scarica il modello configurato:

ollama pull qwen2.5-coder:7b

Per OpenRouter, aggiungi la chiave a un file .env nella cartella da cui avvierai TSUKA:

OPENROUTER_API_KEY=your_key_here

Avvia TSUKA, poi usa /provider per scegliere il backend e /models per selezionare il modello.

3. Apri un workspace

Avvia TSUKA dalla cartella su cui vuoi far lavorare gli agenti:

cd path/to/your/project
tsuka --tui

Usa tsuka --cli per la REPL a righe di comando. Il comando tsuka senza opzioni usa il valore configurato in defaultUi.

Comincia con una richiesta circoscritta, per esempio «Leggi questo progetto e spiegami i suoi punti di ingresso». Usa /tools per vedere gli strumenti disponibili e /help per i comandi supportati dall'interfaccia corrente.

Configurazione e personalizzazione

La cartella di installazione è la directory applicativa predefinita, modificabile tramite TSUKA_HOME. La directory di lavoro è il workspace predefinito dei tool sui file, salvo un'impostazione esplicita di workspaceRoot.

File o directory	Funzione
.tsuka/config.json nel workspace, oppure tsuka.config.json nella directory applicativa come fallback	Provider attivo, modelli, interfaccia, limiti di esecuzione e funzionalità opzionali.
providers.json	Endpoint dei provider, modelli predefiniti e nomi delle variabili d'ambiente per le chiavi API.
.env	Credenziali, caricate dalla directory applicativa, poi da .tsuka/.env e infine da .env nel workspace; i file successivi hanno precedenza.
characters/, roles/, traits/, teams/	Definizioni degli agenti e composizione dei team.

La configurazione di esempio illustra le impostazioni disponibili. Usa /provider e /models per cambiare backend in modo interattivo e /benchmark per valutare le capacità di tool calling di un modello.

Per creare definizioni degli agenti locali al progetto, esegui uno di questi comandi nel workspace:

tsuka init --preset core
tsuka init --preset full
tsuka init --preset core --pack osint,devops

Sono inizializzazioni alternative. Il solo comando tsuka init apre la procedura guidata. Le risorse e la configurazione locali in .tsuka/ hanno precedenza quando presenti; altrimenti il runtime usa tsuka.config.json nella directory applicativa come fallback.