README.it-IT.md

🔥 Simplicio — L'Agente AI CHE RISPARMIA FINO AL 96% DEI TUOI TOKEN

Installa · Funzionalità · 96% Risparmio · Sito web

🌍 Lingue:
🇬🇧 English | 🇧🇷 Português | 🇪🇸 Español | 🇫🇷 Français | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇨🇳 简体中文 | 🇮🇹 Italiano | 🇷🇺 Русский | 🇵🇱 Polski | 🇮🇳 हिन्दी | 🇸🇦 العربية | 🇮🇱 עברית | 🇲🇾 Bahasa Melayu | 🇮🇩 Bahasa Indonesia

---

⚡ TL;DR

Simplicio è un agente AI da terminale — un singolo binario che sostituisce l'intero flusso di lavoro di sviluppo assistito dall'AI: chat, generazione di codice, contesto del repository, pianificazione, orchestrazione multi-agente locale (64 → 600 agenti), e consegna di PR supportata da prove concrete.

Funziona sulla tua macchina. Il tuo codice non lascia mai il tuo controllo. I modelli remoti sono opzionali, non obbligatori.

🔥 Risparmia fino al 96% di token rispetto agli agenti tradizionali — più di Caveman (65%) o RTK (80%). Ogni interazione mostra esattamente quanti token hai risparmiato. Singolo binario Rust, zero dipendenze.

🚀 Installazione

Installa tramite il plugin Codex

Se usi Codex, puoi installare Simplicio come plugin. Aggiungi il Marketplace pubblico, installa il plugin e avvia una nuova sessione Codex; il plugin installa e avvia il Runtime Simplicio e rende disponibili le sue skills e gli strumenti MCP.

codex plugin marketplace add wesleysimplicio/simplicio --ref master
codex plugin add simplicio@simplicio-codex

npm / npx (qualsiasi OS)

npx simplicio install

pip / PyPI (qualsiasi OS)

pip install simplicio-installer
simplicio install

Homebrew (macOS)

brew install simplicio

Bun

bunx simplicio install

macOS / Linux

python3 -m pip install --upgrade simplicio-installer
simplicio install

Windows

py -m pip install --upgrade simplicio-installer
simplicio install

Installazione diretta (senza PyPI)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/wesleysimplicio/simplicio/master/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/wesleysimplicio/simplicio/master/install.ps1 | iex

Fatto. Un comando. Nessun package manager, nessuna configurazione del modello.

---

💰 Risparmio Token — Il 96% è Reale

Senza Simplicio: ogni sessione AI riscopre il tuo repository, carica troppo contesto, ripete i prompt, brucia token a pagamento.

Con Simplicio:

Ottimizzazione	Risparmio
🗺️ Mappa del Repository — contesto compresso invece di leggere file grezzi	~70%
🧠 Memoria Recupero — i fatti noti non vengono ri-derivati	~80%
✏️ Modifica Deterministica — modifiche senza spendere token LLM	100% (output)
🏠 LLM Locale — classificazione, riepilogo, modifiche a basso rischio	~90%
📡 LLM Remoto — solo per pianificazione e decisioni complesse	~85%
🔀 Fan-out Locale — 64→600 agenti prima di scalare sul cloud	~95%
💎 Combinato: fino al 96% di risparmio totale	~96%

Ogni risposta di Simplicio mostra il risparmio reale: Simplicio: ~X token spesi · risparmiati ~Y (Z%)

---

🎯 Cosa Fa

Comando	Descrizione	Token
simplicio map --repo .	Mappa il repository per gli LLM	~70% risparmio
simplicio memory "query"	Recupero neurale (FTS + vettori)	~80% risparmio
simplicio edit '{...}'	Modifica file deterministica	Zero token
simplicio coding-loop "task"	Itera finché i test non passano	Auto-riparazione
simplicio deliver certify	5 gate di qualità prima del rilascio	Deterministico
simplicio run "task" --agents N	Orchestrazione multi-agente	Locale prima

---

🆚 Simplicio vs Caveman vs RTK

	🪨 Caveman	🔧 RTK	🔥 Simplicio
Approccio	Compressione dello stile di output	Proxy di comandi shell	Runtime agente completo
Risparmio max	~65% token output	~80% su comandi shell	Fino al 96% totale
Compressione input	❌	✅ (filtrato)	✅ Mappa repo + memoria neurale
Compressione output	✅ (linguaggio cavernicolo)	❌	✅ Modifiche deterministiche a zero token
LLM Locale	❌	❌	✅ llama.cpp integrato
Multi-agente	❌	❌	✅ 64 → 600 agenti locali
Memoria tra sessioni	❌	❌	✅ Recupero FTS + vettoriale
Catena di prove	❌	❌	✅ Ricevute sigillate sha256
Linguaggio	JS/Python (skill)	Rust (binario)	Rust (singolo binario)
Licenza	MIT	Apache 2.0	Proprietaria
Stelle	72.5k	62.2k	⭐ Sei tra i primi

In sintesi: Caveman fa parlare meno l'AI. RTK fa produrre meno output ai comandi. Simplicio fa pensare meno l'AI — ricordando, mappando, modificando deterministicamente, ed eseguendo localmente prima di toccare un LLM a pagamento.

| Simplicio risparmia il 96% dove Caveman risparmia il 65% e RTK l'80%. |

---

🏗️ Architettura

LLM (Claude/Codex/Gemini)          Simplicio Runtime (Rust)
  |                                   |
  | 1. Orient                         | simplicio map
  | 2. Recall                         | simplicio memory
  | 3. Decide                         |
  | 4. Edit  ───────────────────────> | simplicio edit (0 token)
  | 5. Verify <─────────────────────  | simplicio deliver certify
  | 6. Iterate                        | simplicio coding-loop

L'LLM ragiona. Simplicio esegue deterministicamente.

---

✨ Funzionalità

• 🏠 Locale prima — llama.cpp integrato, scala su remoto solo quando necessario
• 🪜 Agenti a livelli — 64 → 100 → 200 → 600 agenti locali prima del cloud a pagamento
• 🔇 Gate di novità Shannon — filtra output ridondanti (zero token sul dedup)
• 🔒 Ricevute sigillate — sha256 per artefatto, catena di prove a prova di manomissione
• 🛡️ 5 gate di consegna — accettazione, validazione, esecuzione-verifica, regressione, auto-revisione
• ⚡ Gate d'azione — classificazione del rischio + blocklist per mutazioni avviate da chat
• 🔌 MCP/ACP — Model Context Protocol + Agent Client Protocol
• 🌐 Gateway — Telegram, Discord, Slack, WhatsApp
• 🧩 Sistema di skill — carica e incatena capacità riutilizzabili
• 💾 Database di memoria — recupero FTS + vettoriale persistente tra sessioni
• 🔀 Router LLM — nessun LLM → LLM locale → LLM remoto automaticamente
• 🖥️ Multi-piattaforma — macOS, Linux, Windows, singolo binario

---

🎁 Beta Pubblica Gratuita

I comandi deterministici sono GRATUITI per sempre: map, validate, edit, deliver, checkpoint

Le funzionalità AI sono gratuite durante la beta pubblica senza data di scadenza. La fatturazione sarà definita in aggiornamenti futuri.

simplicio license status

---

📋 Requisiti

Requisito	Minimo	Consigliato
RAM	8 GB	16 GB+
Archiviazione	5 MB	1.5 GB (con LLM locale)
OS	macOS 13+, Linux, Windows 10+	macOS ARM64
Terminale	qualsiasi terminale moderno	WezTerm / Alacritty / Ghostty

---

🌐 Ecosistema

• Sito web — documentazione completa, benchmark, installazione
• Discord — community e supporto

---

📄 Licenza

Proprietaria. Binario gratuito da scaricare e utilizzare. Funzionalità AI gratuite durante la beta pubblica. Vedi LICENSE.

---

⭐ Cronologia Stelle

---

💬 Community

• Discord — chat, supporto, accesso anticipato
• Issue GitHub — bug e richieste di funzionalità

---

🔥 Simplicio — Il tuo codice, la tua macchina, il 96% più economico. 🔥