Manuale

Aggiornato 17 September 2026 / 17 settembre 2026

Italiano · English

Setup passo passo

1. Scarica RUDIS — DMG da Gumroad, trascina in Applicazioni, apri e accetta i permessi.
2. Installa un modello — dalla GUI o CLI; serve almeno un modello di default per rispondere alle app.
3. Avvia in LAN — nel repo RUDIS: ./scripts/serve-lan.sh (HTTP 0.0.0.0:8099). In alternativa il demone menu bar se già configurato.
4. Tailscale (opzionale) — installa Tailscale su Mac e iPhone; avvia ./scripts/serve-lan.sh --https per HTTPS su :8443.
5. Verifica salute — da browser o terminale: curl http://<IP-Mac>:8099/health deve rispondere OK. Rete Tailscale: curl -k https://100.x.x.x:8443/health.
6. Accoppia iPhone — apri un'app RUDIS → Connessione / Mode → Mac / LAN → Detect / Reconnect. L'app salva l'host funzionante.
7. Prima bozza — es. Job Tailor: incolla CV + annuncio → Genera. Il testo va al Mac; la bozza torna in app. Rileggi prima di inviare.
8. Pro (opzionale) — licenza Pro sblocca Test / Tune / Liberate nella GUI Mac. Le app iOS restano gratuite.

Cosa invia ogni app al backend

App	Telefono vs Mac
My Factum / FACTUM	Sul telefono: Mode C: il modello di verifica gira sul tuo iPhone con MLX (download da Hugging Face). Condividi testo o link; lo storico resta in SwiftData. La ricerca web opzionale esce dal telefono. Al Mac: In Mode B (VPS gratuito): testo/URL verso /api/verify. Mode C tiene l’inferenza sul telefono, salvo ricerca web o secondo modello opzionale.

Step-by-step setup

1. Download RUDIS — DMG from Gumroad, drag to Applications, open and grant permissions.
2. Install a model — from the GUI or CLI; you need at least a default model for apps to get answers.
3. Start on LAN — in the RUDIS repo: ./scripts/serve-lan.sh (HTTP 0.0.0.0:8099). Or use the menu-bar daemon if already configured.
4. Tailscale (optional) — install Tailscale on Mac and iPhone; run ./scripts/serve-lan.sh --https for HTTPS on :8443.
5. Verify health — from browser or terminal: curl http://<Mac-IP>:8099/health should return OK. On Tailscale: curl -k https://100.x.x.x:8443/health.
6. Pair iPhone — open a RUDIS app → Connection / Mode → Mac / LAN → Detect / Reconnect. The app saves the working host.
7. First draft — e.g. Job Tailor: paste CV + posting → Generate. Text goes to the Mac; the draft returns in-app. Review before sending.
8. Pro (optional) — Pro license unlocks Test / Tune / Liberate in the Mac GUI. iOS apps stay free.

What each app sends to the backend

App	Phone vs Mac
My Factum / FACTUM	On phone: Mode C: the verify model runs on your iPhone with MLX (download from Hugging Face). Share text or a link; local history stays in SwiftData. Optional web search leaves the device. To Mac: In Mode B (free VPS): prompt text/URL to /api/verify. Mode C keeps inference on the phone unless you enable web search or a second-opinion model.