Scarica

Installa
Joshua

curl -fsSL https://ask.joshua.earth/install.sh | bash

Incollalo nel Terminale. Serve un Mac con Apple Silicon (M1 o successivo) o un PC Linux, 8 GB di memoria e 10–40 GB liberi su disco. Su Linux una scheda grafica NVIDIA lo rende molto più veloce. Gratuito e aperto.

Installa

Una riga, qualche domanda

Prima l'installatore guarda il tuo computer: chip, scheda grafica, memoria, disco libero, e stima quanto andrebbe veloce ciascun modello. Ti chiede se vuoi il ragionamento profondo, le immagini e il fine-tuning, oppure solo i modelli cloud, mostra il piano e lo spazio che serve, e aspetta il tuo sì.

Poi installa Ollama, il motore che fa girare i modelli, una copia privata di Python, Joshua e i modelli che hai scelto, e propone di avviare Joshua al login, così si apre subito e i compiti programmati possono partire. Su Mac Joshua è un'app a sé nella cartella Applicazioni, con la sua finestra e la sua icona nel Dock; su Linux si apre nella sua finestra dal menu delle applicazioni. Tutto il resto sta in una cartella, ~/AskJoshua, con un uninstall.sh che lo rimuove.

Prima di cominciare. L'installazione richiede circa 20 minuti, quasi tutti di download, a seconda della connessione e delle opzioni che scegli. Su alcuni Mac, macOS propone anche di installare gli “Strumenti da riga di comando per sviluppatori” di Apple: lascialo finire. La prima stima del tempo (a volte molte ore) è sbagliata; di solito ci vogliono 10–20 minuti. I modelli cloud richiedono un account Ollama: quando l'installatore apre la pagina di accesso, basta Continue with Google con il tuo indirizzo Gmail. I nuovi account Ollama pagano a consumo: aggiungi qualche dollaro di credito su ollama.com prima di usare i modelli cloud. I modelli locali sono sempre gratuiti. I modelli locali non richiedono alcun account.

Preferisci leggere prima di eseguire? Apri install.sh: è uno script shell semplice e commentato. Tutto il codice di Joshua è su GitHub, con licenza AGPL.

Quale modello ottieni (memoria del Mac)
MemoriaModelloOpzioni
8 GBqwen3-vl 4B · circa 3 GBRagionamento profondo. Le immagini non sono proposte: servono 16 GB. Su un chip lento si suggerisce il 4B anche con 16 GB.
16–24 GBqwen3-vl 8B · circa 6 GBRagionamento profondo, immagini (FLUX.2 klein), fine-tuning.
32 GB+qwen3-vl 30B · circa 20 GBTutto, con un modello più grande e più intelligente se lo vuoi.
Qualsiasi computerSolo modelli cloud · circa 1 GBPer i computer troppo piccoli o troppo vecchi per i modelli locali (Mac Intel, meno di 8 GB di memoria, poco disco libero), oppure se preferisci. Le risposte arrivano dai server di Ollama; chat, file e memoria restano sul tuo computer. Servono una connessione a internet e un account Ollama con qualche dollaro di credito a consumo.
Mac con macOS 26🍎 Apple Intelligence · già nel MacSi aggiunge da solo, con qualsiasi scelta qui sopra, quando Apple Intelligence è attiva (qualsiasi Mac con M1 o successivo). Gratuito, privato e veloce, ma piccolo: niente strumenti, chat brevi, più errori.
Linuxscelto in base alla scheda grafica: 4B sotto i 7 GB, 8B da 7 GB, 30B da 22 GBImmagini da 12 GB, fine-tuning da 8 GB, su schede NVIDIA. Senza scheda, il 4B gira sul processore, lentamente.
Com'è l'installazione
L'installatore controlla il computer (Apple M4, 16 GB) e chiede del ragionamento profondo, delle immagini, del fine-tuning e dei modelli cloud, poi mostra il piano
1. Qualche domanda. L'installatore controlla il tuo computer, suggerisce il modello adatto, chiede cosa vuoi e mostra il piano prima di installare qualsiasi cosa.
Scelta dei soli modelli cloud: circa 1 GB; vengono installati Ollama, Python e Joshua, e un modello cloud viene aggiunto dopo l'accesso a Ollama
2. Oppure solo modelli cloud. Circa 1 GB. Si apre una pagina del browser per accedere a Ollama: basta Continue with Google.
La fine dell'installazione: Joshua parte al login ed è nella cartella Applicazioni, mostrato con la sua icona
3. Joshua è nelle tue Applicazioni. Aprilo da lì o da Launchpad, e trascinalo nel Dock per averlo a portata di mano.