Manuale
Setup passo passo
- Scarica RUDIS — DMG da Gumroad, trascina in Applicazioni, apri e accetta i permessi.
- Installa un modello — dalla GUI o CLI; serve almeno un modello di default per rispondere alle app.
- Avvia in LAN — nel repo RUDIS:
./scripts/serve-lan.sh(HTTP0.0.0.0:8099). In alternativa il demone menu bar se già configurato. - Tailscale (opzionale) — installa Tailscale su Mac e iPhone; avvia
./scripts/serve-lan.sh --httpsper HTTPS su :8443. - Verifica salute — da browser o terminale:
curl http://<IP-Mac>:8099/healthdeve rispondere OK. Rete Tailscale:curl -k https://100.x.x.x:8443/health. - Accoppia iPhone — apri un'app RUDIS → Connessione / Mode → Mac / LAN → Detect / Reconnect. L'app salva l'host funzionante.
- Prima bozza — es. Job Tailor: incolla CV + annuncio → Genera. Il testo va al Mac; la bozza torna in app. Rileggi prima di inviare.
- 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 |
|---|---|
| Job Tailor | Sul telefono: Incolli il testo del CV e dell’annuncio. Niente fotocamera né invio di foto. Al Mac: quel testo al tuo backend RUDIS sul Mac, per la bozza di lettera. |
| My Contract Lens | Sul telefono: Scegli una foto dalla libreria (niente fotocamera live in v1). Vision fa l’OCR sul dispositivo. Al Mac: solo il testo OCR (circa 12.000 caratteri al massimo). Il JPEG non esce dal telefono. |
| AI Act Ready | Sul telefono: Inserisci note su un sistema AI e un registro locale degli strumenti IA (inventario Shadow AI). Niente foto. L'inventario resta sul dispositivo finché non lo esporti o lo invii a GPAI. Al Mac: quelle note al tuo backend RUDIS sul Mac per bozze rischio/GPAI/incidenti. |
| DORA Ready | Sul telefono: Inserisci note su ambito ICT, terzi e incidenti. Niente foto. Al Mac: quelle note al tuo backend RUDIS sul Mac. |
| Invoice Check | Sul telefono: Scegli una foto dalla libreria. OCR e checksum P.IVA girano sul dispositivo. Al Mac: il testo estratto, verso il LLM. La foto non esce dal telefono. |
| My Image Rights | Sul telefono: EXIF e OCR girano sul dispositivo. Al Mac: un riassunto testuale e, solo se l’hai incollato, un URL immagine — non i byte dell’immagine. |
| Shopper Truth | Sul telefono: L’OCR riempie il campo di testo. Lo screenshot non esce dal telefono. Al Mac: quel testo e, se l’hai incollato, un URL, verso /api/verify. |
| RUDIS Minutes | Sul telefono: Il microfono serve allo Speech on-device quando possibile. Niente upload audio né import di file. Al Mac: solo il testo della trascrizione (circa 16.000 caratteri al massimo). Nessun file audio viene inviato. |
| My Factum / FACTUM | Sul telefono: Condividi testo o link da Safari o un’altra app. Lo storico locale resta in SwiftData. Al Mac: testo del prompt (e l’URL se l’hai condiviso) verso /api/verify sul tuo backend RUDIS sul Mac. |
| Data Broker | Al Mac: nome, email, username e note sull’impronta digitale che inserisci, per mappa di esposizione, checklist broker e bozze opt-out. |
| ISO 27001 Ready | Al Mac: note che incolli su controlli e gap, per una checklist in bozza. |
| NIS2 Ready | Al Mac: note che incolli sullo scope NIS2, per una checklist in bozza. |
| GDPR Ready | Al Mac: note che incolli sui trattamenti, per una checklist in bozza. |
| RUDIS Redactor | Al Mac: testo che incolli, per una bozza redatta. |
Step-by-step setup
- Download RUDIS — DMG from Gumroad, drag to Applications, open and grant permissions.
- Install a model — from the GUI or CLI; you need at least a default model for apps to get answers.
- Start on LAN — in the RUDIS repo:
./scripts/serve-lan.sh(HTTP0.0.0.0:8099). Or use the menu-bar daemon if already configured. - Tailscale (optional) — install Tailscale on Mac and iPhone; run
./scripts/serve-lan.sh --httpsfor HTTPS on :8443. - Verify health — from browser or terminal:
curl http://<Mac-IP>:8099/healthshould return OK. On Tailscale:curl -k https://100.x.x.x:8443/health. - Pair iPhone — open a RUDIS app → Connection / Mode → Mac / LAN → Detect / Reconnect. The app saves the working host.
- First draft — e.g. Job Tailor: paste CV + posting → Generate. Text goes to the Mac; the draft returns in-app. Review before sending.
- 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 |
|---|---|
| Job Tailor | On phone: You paste CV and job-posting text. No camera and no photo upload. To Mac: that text to your RUDIS Mac backend, to draft a targeted letter. |
| My Contract Lens | On phone: You pick a photo from the library (no live camera in v1). Apple Vision runs OCR on the device. To Mac: OCR text only (about 12,000 characters max). The JPEG does not leave the phone. |
| AI Act Ready | On phone: You type notes about an AI system and keep a local AI tools registry (Shadow AI inventory). No photos. The inventory stays on the device until you export it or send it to GPAI analysis. To Mac: those notes to your RUDIS Mac backend for risk/GPAI/incident drafts. |
| DORA Ready | On phone: You type notes on ICT scope, third parties, and incidents. No photos. To Mac: those notes to your RUDIS Mac backend. |
| Invoice Check | On phone: You pick a photo from the library. OCR and the VAT checksum run on the device. To Mac: extracted text to the LLM. The photo does not leave the phone. |
| My Image Rights | On phone: EXIF and OCR run on the device. To Mac: a text summary, plus an image URL only if you pasted one — not the image bytes. |
| Shopper Truth | On phone: OCR fills the text field. The screenshot does not leave the phone. To Mac: that text, and a URL if you pasted one, to /api/verify. |
| RUDIS Minutes | On phone: The microphone is used for Speech on-device when possible. No audio upload and no file import. To Mac: transcript text only (about 16,000 characters max). No audio file is sent. |
| My Factum / FACTUM | On phone: You share text or a link from Safari or another app. Local history stays in SwiftData. To Mac: prompt text (and any URL you shared) to /api/verify on your RUDIS Mac backend. |
| Data Broker | To Mac: the name, email, usernames, and footprint notes you enter, to draft an exposure map, broker checklist, and opt-out text. |
| ISO 27001 Ready | To Mac: notes you paste about controls and gaps, for a draft checklist. |
| NIS2 Ready | To Mac: notes you paste about NIS2 scope, for a draft checklist. |
| GDPR Ready | To Mac: notes you paste about processing, for a draft checklist. |
| RUDIS Redactor | To Mac: text you paste, to draft a redacted version. |