Guide
App per Mac
Esegui Skynet sul tuo Mac con il tuo agente di programmazione e Docker.
L'app Skynet per Mac esegue Skynet sul tuo computer. Invia le chiamate ai modelli tramite una CLI di programmazione con cui hai effettuato l'accesso sul tuo Mac, quindi è il piano della tua CLI a pagare quelle chiamate. Puoi anche collegare l'app al tuo account Skynet ospitato.
Requisiti
- Un Mac con Apple silicon. Esistono build per Intel, ma nessuno le ha provate su hardware Intel.
- Docker Desktop, in esecuzione, con Use Rosetta for x86_64/amd64 emulation attivato.
- Una CLI di programmazione, con accesso effettuato:
- Claude Code (
claude) 2.1.226 o successiva, oppure - Codex (
codex) 0.160.0 o successiva.
- Claude Code (
Configurare Codex
Codex deve conservare le sue credenziali in un file. Completa questi passaggi prima del primo avvio:
- Apri
~/.codex/config.tomle aggiungi questa riga:
cli_auth_credentials_store = "file"- Accedi con il tuo account ChatGPT:
codex loginInstallare l'app
Le build hanno una firma ad hoc e non sono notarizzate. macOS le blocca finché non rimuovi il flag di quarantena.
- Apri il file
.dmg. - Trascina Skynet in Applicazioni.
- Esegui questo comando nel Terminale:
xattr -dr com.apple.quarantine /Applications/Skynet.app- Apri Skynet da Applicazioni.
Che cosa succede all'avvio
L'app esegue questi passaggi in ordine:
- Legge il
PATHdalla tua shell di login, così può trovare Docker e la tua CLI. - Controlla Docker e la tua CLI di programmazione.
- Avvia un database Postgres locale in Docker.
- Crea l'immagine sandbox
skynet-local-sandboxperlinux/amd64. Docker la esegue con Rosetta. - Aggiorna lo schema del database.
- Avvia l'API locale e l'app web, e mostra l'app web nella finestra.
Controlli iniziali
L'app mostra un elenco di controlli: Docker, Coding CLI, Signed in, Usage limit, Local services e Account. Se un controllo non riesce, l'app mostra una schermata che ti dice cosa fare:
| Schermata | Che cosa fare |
|---|---|
| Install Docker Desktop | Installa Docker Desktop. |
| Start Docker | Avvia Docker Desktop. |
| Install a coding CLI | Installa Claude Code o Codex. |
| Update your coding CLI | Aggiorna la CLI alla versione minima indicata sopra. |
| Sign in to your CLI | Accedi alla CLI nel Terminale. |
| Usage limit reached | Attendi l'orario di ripristino. I nuovi job possono ripartire dopo il ripristino. |
Fai clic su Check again dopo aver risolto il problema. Fai clic su Open logs per vedere i file di log. Nella schermata Usage limit reached, puoi fare clic su Open Skynet anyway.
Esecuzioni locali
Nell'app, le chiamate ai modelli passano dalla CLI sul tuo Mac. Il menu dei modelli mostra questa modalità come Locale. Il suggerimento dice: «Le chiamate le paga il tuo piano, quindi questo modello aggiunge 0 $ all'esecuzione.»
Nell'app i nomi delle CLI sono Claude Code e Codex.
Eseguire il proponente sulla tua CLI
L'impostazione Esegui il proponente sulla mia CLI controlla dove viene eseguito l'agente proponente. Le scelte sono Motore dell'agente (predefinito) e Disattivato (proponente isolato).
Accesso del proponente stabilisce che cosa può toccare la CLI:
- Solo area di lavoro è il valore predefinito. Si affida alla sandbox propria di ogni CLI.
- Accesso completo esegue la CLI con i tuoi privilegi utente.
Etichettatura nell'app
L'etichettatura con l'IA nell'app per Mac richiede la chiave del tuo provider. Scegli un modello in La tua chiave. Vedi Etichettare i dati con il tagger.
Collegare l'app al tuo account Skynet
Puoi usare l'app senza un account. Per farlo, fai clic su Use without signing in. Per sincronizzare con il tuo account ospitato, collega l'app.
Collegare questo Mac
- Al passaggio Sign in to Skynet, l'app apre la pagina Link a Mac nel tuo browser predefinito.
- Accedi a Skynet nel browser, se te lo chiede.
- Controlla l'elenco sotto Una volta collegato, questo Mac potrà:.
- Fai clic su Collega questo Mac. La pagina mostra «Ritorno all’app Mac…».
Se l'accesso non riesce o lo annulli, l'app mostra Try again e Use without signing in.
Una volta collegato, il Mac può:
- Vedere il tuo nome e la tua email.
- Vedere il tuo saldo.
- Sincronizzare le tue esecuzioni con il tuo account.
- Usare i modelli ospitati, pagati dal tuo saldo.
- Usare le tue origini dati collegate.
- Cercare e navigare sul web tramite Skynet.
Il collegamento usa un flusso di accesso sicuro (OAuth con PKCE). L'app conserva i suoi token cifrati sul tuo Mac. Quando scolleghi il Mac, Skynet revoca i token.
Limiti del collegamento
| Limite | Valore |
|---|---|
| Mac collegati per ogni account | 10 |
| Durata del token di accesso | 1 ora, poi l'app lo rinnova |
| Timeout di inattività del collegamento | 30 giorni senza utilizzo |
| Durata massima del collegamento | 365 giorni |
Dopo il timeout di inattività o la durata massima, collega di nuovo il Mac.
Stato del collegamento
L'app mostra uno di questi stati: Modalità locale, Collegato a questo Mac, Accedi per sincronizzare o Collegato (offline).
Servizi e dati locali
Tutti i servizi locali sono in ascolto solo su 127.0.0.1:
| Servizio | Intervallo di porte |
|---|---|
| API | Da 48100 a 48119 |
| App web | Da 48120 a 48139 |
| Postgres | Da 48140 a 48159 |
L'app conserva i suoi dati in ~/Library/Application Support/Skynet. La cartella logs/ contiene desktop.log, api.log, frontend.log, migrate.log e sandbox-build.log.
Quando chiudi l'app, questa arresta l'app web, l'API, Postgres e tutti i container dei job.
Reimpostare l'app
Chiudi prima l'app. Poi esegui:
docker volume rm skynet-local-pgdata
rm -rf ~/Library/Application\ Support/SkynetPassaggi successivi
- Avvia un'esecuzione.
- Leggi la pagina sulla fatturazione per i modelli ospitati.
- Leggi Sicurezza.