L'applicazione desktop che amplifica i modelli di IA che già usi.
Progetti, chat, strumenti, un browser isolato e team di agenti — con i tuoi permessi, i tuoi dati, sul tuo computer.
🇬🇧 Read in English · Guida utente · Documentazione · Installazione
Kira non è un'altra finestra di chat. È uno spazio di lavoro durevole che dà al modello un progetto, una memoria, strumenti ispezionabili e confini chiari, perché il modello che scegli — locale o in cloud — possa fare di più, in modo più sicuro, e tu possa sempre vedere che cosa è successo davvero.
- Il modello ragiona, Kira esegue. Letture, scritture, comandi, pagine web e azioni nel browser passano da un servizio locale indipendente, con il permesso che hai scelto per il progetto. Ogni operazione lascia una ricevuta nella chat: ciò che il modello racconta non vale mai come prova.
- Niente esce dal tuo computer senza di te. Progetti, chat, eventi delle
esecuzioni, screenshot e allegati stanno in un database SQLite e in cartelle
private del tuo profilo. Kira non legge cookie né credenziali di altre
applicazioni; i token e le chiavi degli accessi che gestisce (ChatGPT, Google
Cloud, OpenRouter, DeepSeek) restano in file privati del profilo (
0600), fuori da database, esportazioni e diagnostica. - Porta il tuo modello. Ollama sul tuo computer, OpenAI Codex, il tuo piano
ChatGPT, Google Cloud · Vertex AI (con i tuoi crediti o saldo GCP e multi-account
isolato), OpenRouter (oltre 300 modelli con adattamento automatico al contesto e
fallback per i modelli
:free), DeepSeek o il tuo Claude Code: scegli il provider per ogni chat, abilita o disattiva i servizi che usi in Modelli e puoi cambiarlo senza perdere la conversazione.
- Progetti e chat con nome, con istruzioni, memoria condivisa, provider e
livello di ragionamento per chat, bozze che sopravvivono ai riavvii, immagini
allegate con anteprima,
@Mentionsuniversali (@file,@folder,@git,@terminal,@web,@soul,@team) e/Slash Commandscontestuali nel campo di scrittura. - Strumenti con ricevuta. Lettura, ricerca, scrittura, comandi, ricerca web, navigazione: ogni chiamata mostra il riferimento letterale e l'esito registrato, espandibile fino ai dati originali.
- Un browser isolato e il Computer di Kira. L'agente naviga in un profilo separato accanto alla chat, legge le pagine, scatta screenshot che vede davvero e ti restituisce il controllo per accessi e consensi.
- Team di agenti organizzati da te o da un coordinatore, con messaggi durevoli, pausa e ripresa, e risultati consegnati nella chat di origine.
- Registro di Ricerca. Schede attribuite, collegamenti alle prove, valutazioni e proposte dell'agente che accetti o rifiuti: conoscenza che sopravvive alla singola chat.
- Anima di Kira. Identità di tua proprietà, con una filosofia di lavoro,
preferenze esplicite, creazione e configurazione rapida via chat (
/anima crea,/anima preferenza) e lezioni apprese che puoi rivedere, conservare per chat, per progetto o in tutti i progetti con la stessa Anima, oppure dimenticare. - Omnibox universale (
Ctrl+K). Ricerca istantanea tra tutti i progetti, chat, messaggi, identità e lezioni dell'Anima, schede di Ricerca, artefatti Canvas e azioni native del desktop, senza alcun consumo di token. - Obiettivi autonomi, domande persistenti e indicazioni durante il lavoro, più i riepiloghi pubblici del ragionamento dove il provider li offre.
- Un'interfaccia silenziosa. Una sola barra in alto, barra laterale a icone o nascosta, chip nel campo di scrittura, pannelli con schede, tema chiaro e scuro, italiano e inglese.
| Provider | Come si collega | Chi esegue gli strumenti |
|---|---|---|
| Ollama | API HTTP locale (http://127.0.0.1:11434 come predefinito) |
Kira; strumenti verificati al primo uso, nessun download automatico di modelli |
| Codex | OpenAI Codex App Server, con l'accesso ufficiale | Codex, con le sue sandbox; Kira osserva e registra ogni operazione |
| OpenAI · ChatGPT | Il tuo piano ChatGPT, con l'accesso ufficiale | Kira; immagini in ingresso, ricerca web ospitata, contesto gestito automaticamente |
| Google Cloud · Vertex AI | Multi-account OAuth2 PKCE isolato in Kira, gcloud ADC di sistema (in sola lettura) o API Key |
Kira; modelli nativi Google (gemini-4-argon, gemini-3.8-flash, gemini-3.1-pro-preview) e modelli Partner Claude su Vertex AI, visione e riepiloghi del ragionamento |
| OpenRouter | Chiave API OpenRouter (sk-or-v1-... nel profilo locale 0600 o variabile OPENROUTER_API_KEY) |
Kira; catalogo dinamico (/api/v1/models), adattamento automatico a contesto, max_tokens, reasoning/thinking, prompt caching (Claude/Gemini), visione multimodale e fallback anti-stallo per modelli :free |
| DeepSeek API | Accesso account DeepSeek o proxy DeeperSeeker | Kira |
| DeepSeek Web | Token di sessione del sito | Kira, con un protocollo testuale per gli strumenti |
| Claude Code | Il tuo Claude Code già autenticato (extra opzionale, non incluso nei pacchetti) | Claude Code, osservato da Kira; browser, Computer, domande e Ricerca tramite un server MCP interno |
Il provider si sceglie per ogni chat in Modelli (Hub Provider e Modelli), dove puoi anche abilitare o disattivare ciascun servizio per snellire i selettori rapidi. Provider descrive ogni collegamento, le sue capacità e i limiti noti.
Kira è disponibile in modo nativo su Linux (Ubuntu 24.04 LTS con Python 3.12 e Ubuntu 26.04 LTS con Python 3.14) e nativo su Windows 10 e 11 (64 bit), oltre che in WSL2 con WSLg.
Su Windows 10 / 11 (nativo):
Scarica ed esegui l'installer kira-desktop_windows_amd64_setup.exe dalla pagina Releases, oppure da PowerShell:
Invoke-WebRequest -Uri "https://github.com/antosec00/kira-desktop/releases/latest/download/kira-desktop_windows_amd64_setup.exe" -OutFile "$env:TEMP\kira-desktop_setup.exe"
Start-Process -FilePath "$env:TEMP\kira-desktop_setup.exe" -WaitL'installer configura Kira in %LOCALAPPDATA%\Programs\Kira Desktop senza richiedere privilegi di amministratore e crea i collegamenti Kira Desktop sul Desktop e nel Menu Start (Installazione → Installazione nativa su Windows 10 e 11).
Dal pacchetto su Linux (Ubuntu 24.04):
cd "$(mktemp -d)"
wget https://github.com/antosec00/kira-desktop/releases/latest/download/kira-desktop_ubuntu24.04_amd64.deb
sudo apt install --no-remove ./kira-desktop_ubuntu24.04_amd64.deb
kiraPer Ubuntu 26.04 usa kira-desktop_ubuntu26.04_amd64.deb. Tutte le versioni,
con le impronte SHA256SUMS e la loro firma SHA256SUMS.sig per controllare i
file, sono nella pagina
Releases. Una volta
installata, Kira cerca da sola le nuove versioni e le installa quando glielo
chiedi, dopo averne verificato la firma
(Installazione → Aggiornare da Kira). Se preferisci
usare WSL2 su Windows, i passi sono in
Installazione → Su Windows con WSL.
Dal sorgente (Linux o Windows):
# 1. Installa uv (https://docs.astral.sh/uv/) e clona il repository
git clone https://github.com/antosec00/kira-desktop.git
cd kira-desktop
# 2. Installa le dipendenze bloccate (aggiungi l'extra Claude Code se lo vuoi)
uv sync --frozen # oppure: uv sync --frozen --extra claude-code
# 3. Avvia
uv run kiraSu Linux dal sorgente servono anche le librerie di sistema elencate in
Installazione → Avvio dal sorgente con uv;
il pacchetto .deb le installa da solo.
Al primo avvio la schermata iniziale offre Come funziona Kira, che apre la Guida iniziale. Crea un progetto scegliendo una cartella, seleziona provider e modello in Modelli e scrivi la prima richiesta. La guida utente spiega ogni pannello.
Costruire i pacchetti. python3 scripts/build_deb.py costruisce il
pacchetto .deb per Ubuntu 24.04 (--target resolute per la 26.04);
python3 scripts/build_windows.py --package costruisce l'installer nativo per
Windows (dist/kira-desktop_<versione>_windows_amd64_setup.exe).
Installazione copre requisiti, controllo delle
impronte, percorsi dei dati, profili separati, backup e aggiornamenti.
- I permessi sono per progetto: sola lettura, scrittura nel progetto, host fidato (comandi come il tuo utente) o accesso completo. Nulla sale di livello in silenzio. Permessi e sicurezza definisce il confine.
- L'esecuzione è registrata. Gli eventi durevoli stabiliscono che cosa è successo; strumenti falliti o non confermati restano visibili.
- Browser isolato. Le pagine pubbliche sono dati non fidati, mai istruzioni. Accessi e consensi richiedono te; ogni chat ha il proprio profilo, temporaneo salvo che tu scelga di conservarlo. Browser e Computer.
- Privato per impostazione. Percorsi XDG su Linux,
%LOCALAPPDATA%\Kirasu Windows o unKIRA_HOMEesplicito, file riservati al tuo utente, canale IPC locale privato fra interfaccia e servizio.
SECURITY.md spiega come segnalare un problema di sicurezza.
| Se vuoi… | Leggi |
|---|---|
| Usare Kira ogni giorno | Guida utente |
| Installare, salvare, aggiornare, scegliere un profilo | Installazione |
| Collegare un provider | Provider |
| Capire permessi e confini | Permessi e sicurezza |
| Usare browser, Team, Ricerca, Anima | Browser e Computer, Team, Ricerca, Anima e Conoscenza |
| Lavorare sul codice | Sviluppo, Architettura, Contratti |
| Sfogliare tutto | Indice della documentazione · Documentation in English |
La documentazione è scritta in italiano e tradotta in inglese in docs/en/.
uv sync --frozen --extra claude-code
QT_QPA_PLATFORM=offscreen uv run pytest tests # suite sintetica completa
uv run ruff check src tests scripts packaging
uv run mypy src
python3 scripts/check_translations.py
python3 scripts/check_public_tree.pyCONTRIBUTING.md descrive rami, commit, lingue della documentazione e la lista di controllo per una pull request.
Kira Desktop è rilasciato con licenza MIT. I componenti di terze parti inclusi o collegati mantengono le proprie licenze; vedi Licenze di terze parti.