Home → User manual

Iridai User Manual

App version: 0.3.0 Last update: 11 May 2026 Language: English

Iridai is your AI field assistant for CE compliance verifications, occupational safety audits and industrial inspections — designed for consulting engineers wearing Ray-Ban Meta smart glasses or using their iPhone alone.

Table of Contents

1. What is Iridai
2. Requirements
3. First installation
4. Guided onboarding
5. The main screen
6. The four quick action buttons
7. The inspection session
8. Voice commands and wake word
9. The Ray-Ban Meta temple tap
10. Settings — section-by-section guide
11. Cloud and local AI models
12. Custom contexts and prompts
13. Personas
14. Activation modes
15. Advanced agentic features
16. External integrations
17. PDF generation and report sharing
18. Privacy and local model (zero-cloud)
19. Troubleshooting
20. Frequently Asked Questions
21. Safety and professional responsibility
22. Glossary
23. Contacts and support

1. What is Iridai

Iridai is a professional iOS app that uses artificial intelligence to help you during:

• CE marking verifications of industrial machinery (Machinery Directive 2006/42/EC, EN ISO 13857, EN ISO 13854, EN 60204-1, etc.).
• Occupational safety audits (Italian Legislative Decree 81/2008, State-Regions agreements, PPE, ATEX, etc.).
• Industry 4.0 maintenance (interconnection, OT cybersecurity, MES/ERP integration).
• Specialised inspections (chemical risk, electrical installations, tactical security scenarios, weapons identification, tobacconist expertise, etc. — fully customisable).

Iridai works in two modes:

• Hands-free with Ray-Ban Meta: you tap the temple to capture a photo, the AI analyses it, and the response is read back through the glasses' speakers.
• iPhone only: large on-screen buttons, with the iPhone's rear camera as automatic fallback.

Every analysis can produce non-conformities (NCs) categorised by severity. These are collected into an inspection session and automatically formatted into a professional technical PDF report with regulatory references, attached photos, and calculated safety distances.

2. Requirements

2.1 What you definitely need

• iPhone running iOS 17 or later.
• Apple ID (to download the app via TestFlight or the App Store).
• At least one API key for a cloud AI provider (Anthropic Claude recommended for quality) or a device compatible with the local AI model (minimum 4.5 GB RAM, i.e. iPhone 13 or later).

2.2 Recommended but optional

• Ray-Ban Meta smart glasses generation 2 or later (the app automatically falls back to the iPhone camera if not connected).
• Wi-Fi for initial downloads (the local model is between 1.5 and 7 GB).
• 4G/5G data connection on-site for cloud analysis.

2.3 Iridai Pro Monthly subscription

Access to the AI features of Iridai requires the "Iridai Pro Monthly" auto-renewable subscription available as an in-app purchase:

• Price: € 9.90 per month (VAT included where applicable)
• Free trial: 3 days for new eligible users (shortest duration supported by Apple StoreKit introductory offers)
• Renewal: automatic each month, cancellable at any time from iOS Settings → Apple ID → Subscriptions at least 24 hours before the renewal date
• Family Sharing: shareable with members of your Apple Family Group
• Restore: after reinstall or new device, the "Restore Purchases" button in-app restores your access

The subscription is managed entirely by Apple (Apple Distribution International Ltd.): RAVENG does not receive nor process your payment data.

2.4 AI Provider API keys (optional, separate costs)

The Iridai Pro subscription does not include calls to cloud AI providers. If you want to use cloud models, you need a personal API key for the chosen provider (the API costs are in addition to the monthly subscription). Zero-cost alternative: use the local MLX model downloadable from within the app.

💡 Tip: start with Anthropic Claude (best quality for Italian technical analysis), Google Gemini Flash (most economical), or the MLX local model (zero recurring costs after download).

3. First installation

3.1 From TestFlight (beta)

1. Open the TestFlight link you have received on your iPhone (e.g. https://testflight.apple.com/join/xxxxxxxx).
2. Tap Install (if you do not have TestFlight installed, the iPhone redirects you to the App Store to download it — it is Apple's own app and is free).
3. Wait for Iridai to appear on the home screen (a violet/blue icon featuring a stylised aperture symbol + "AI").
4. Tap the icon to open the app.

3.2 From the App Store (once published)

1. Open the App Store on your iPhone.
2. Search for "Iridai".
3. Tap Get → authenticate with Face ID / Touch ID / Apple ID password.
4. Open Iridai from the home screen.

3.3 What happens on first launch

The first time you launch the app, the guided 8-step onboarding starts automatically. Do not close the app during onboarding: each step has a large Continue button or a specific action that completes it.

4. Guided onboarding (eight steps)

The onboarding is designed to be idiot-proof: each step has a different gradient background and progress dots at the top. You cannot skip steps without an explicit choice.

Step 1 · Welcome

You will see the animated Iridai logo (enters with a scaling + glow animation in blue and violet). The screen explains in two lines what the app does.

✋ What to do: read and tap Start.

Step 2 · What you can do

A list of the key features: CE verifications, safety audits, inspections, PDF generation.

✋ What to do: tap Continue.

Step 3 · iOS permissions

Iridai asks you for the permissions it needs one at a time, with an explanation of why. Approve all for the full experience, but you may also decline some:

✋ What to do: tap Grant for each request; unlock with Face ID if prompted.

Step 4 · Anthropic API key

Iridai asks you to enter an API key. Anthropic is the recommended default, but you can also add OpenAI or Gemini keys later from Settings.

✋ What to do:

1. Open Safari on the iPhone (do not close Iridai, leave it in the background).
2. Go to https://console.anthropic.com.
3. Create an account / sign in.
4. Navigate to API Keys → Create Key.
5. Copy the key (it starts with sk-ant-).
6. Return to Iridai, paste it into the field, tap Save.
7. Iridai will attempt to download the list of available models: you will see a dropdown with all Claude models accessible to your key → pick Claude Opus 4.7 (maximum quality) or Sonnet 4.6 (cheaper).

💡 You can also skip this step: you will be reminded again from Settings. Without any key or local model, the app cannot perform AI analyses.

Step 5 · Pairing the Ray-Ban Meta glasses

✋ What to do:

1. Put the glasses on and power them on.
2. Open the Meta AI app on the iPhone and sign into your Meta account.
3. Verify the glasses are connected in Meta AI.
4. Return to Iridai and tap Start pairing.
5. The iPhone briefly switches to the Meta AI app to authorise camera access, then returns to Iridai.
6. You will see Connected in the top banner.

⚠️ If you do not have the glasses: tap Skip. Iridai will use the iPhone's camera as automatic fallback. All AI functions remain available.

Step 6 · Local AI model (optional)

If your iPhone has at least 4.5 GB of RAM (iPhone 13 or later), Iridai offers you the option to download an on-device AI model that works offline, without cloud, without API costs.

✋ What to do:

• Later: skip — you can download it any time from Settings → AI Models → Local Models.
• Take me to Settings to download it: skips the step and leaves a reminder.

💡 If you want to do it right away (recommended for maximum privacy): skip the step, go to Settings, and follow §11.2.

Step 7 · Quick action tour

Animated tour of the 4 home buttons + the large "Press to speak" button. You can revisit this from Settings if you wish.

✋ What to do: tap Continue.

Step 8 · You're ready!

Celebration screen with animated confetti. Iridai is now configured.

✋ What to do: tap Start using Iridai → the main screen opens.

5. The main screen

Open the app and look from top to bottom. Everything is designed to be legible at a glance even with strong sunlight on the screen:

┌─────────────────────────────────────────┐
│ [iridai mini-icon]      [gear ⚙]         │  ← toolbar
│                                          │
│ 👓 Connected         Iride · Ready       │  ← connection banner + persona
│                                          │
│ [⚠ Active session: …  3 NC  Close]      │  ← inspection banner (only if open)
│                                          │
│ ● READY                                   │  ← status chip (below)
│                                          │
│   The AI response appears here in        │
│   large readable, scrollable font        │  ← response area (fills screen)
│                                          │
│ ──────────────────────────────────       │  ← WOW progress bar (visible while processing)
│                                          │
│ [Describe] [CE check] [Safety] [4th]    │  ← quick action row
│                                          │
│ [🎤  Press to speak]   [📂 Inspections] │  ← large button + open history
└─────────────────────────────────────────┘

5.1 Toolbar (top icons)

• Top-left · Mini Iridai icon: does nothing on tap, it is branding only. Long-press 0.6s: opens the hidden Debug panel (useful for troubleshooting — see §19).
• Top-right · Gear: opens Settings.

5.2 Connection banner

Shows the Bluetooth status of the glasses. Possible states:

If "Not connected" → a Pair button appears that opens Meta AI for pairing.

On the right: the active Persona icon (Iride by default).

5.3 Active inspection banner

Visible only when you have an open inspection session. It shows:

• The domain icon (CE seal, safety shield, I40 gears).
• The session title + human-readable ID (e.g. "VCE-2026-05-11-1430").
• Contextual counters (NCs + machines where applicable).
• An ❌ red button (Cancel — destructive, with confirmation) and a Close orange button (saves the PDF).

5.4 Status chip

A thin row below the banner that tells you what the app is doing right now:

5.5 Response area

Fills all the vertical space in the middle of the screen. The AI response appears here with large font (.title3) and generous line spacing. Scroll with your finger if the response is long.

When there is no response, you see a subtle hint: ✨ "Responses will appear here".

5.6 WOW progress bar

Animated coloured strip that pulses during processing, showing the current phase:

1. Photo capture (yellow)
2. Awaiting glasses / iPhone shutter (orange)
3. Sending to the AI model (cyan)
4. TTS generation (green)

It is not interactive — just to keep you informed of progress.

5.7 Quick action row

Four large buttons always available (detailed in §6).

5.8 "Press to speak" + history button

• Large blue/red button at the bottom: voice command + stop-everything (see §8.3).
• Square orange button on the right: opens the inspections list (active + closed history).

6. The four quick action buttons

These are one-tap shortcuts to the most common analyses. Each one follows the same pipeline: capture photo → AI → NC added to the inspection → spoken summary.

6.1 👁 Describe

What do you see? Short 2–3 sentence answer.

The fastest, most generic analysis. Does not open an inspection — it simply gives a concise description of what you frame.

When to use: you want to know "what is this thing?" without creating a formal report.

6.2 ✅ CE check

Compliance verification under CE marking / Machinery Directive.

Analyses the photo as if it were a machine or component to verify under 2006/42/EC. It checks for:

• CE marking present / legible
• Declaration of Conformity (DoC)
• User manual in Italian
• Movable guards / interlocks (EN ISO 14119)
• Safety distances (EN ISO 13857 / EN ISO 13854)
• Controls and emergency stops (EN ISO 13850, EN 60204-1)
• Safety signage (EN ISO 7010)
• Acoustic protection (EN ISO 11688)

🎯 Killer feature: if you place a reference object (credit card 85.6×54 mm, business card, coins, rulers) next to an opening in the guard, the AI estimates the dimensions in mm, classifies the shape of the opening and applies the EN ISO 13857 / EN ISO 13854 tables to calculate the minimum required safety distance.

Output: NC categorised by severity (critical / major / minor / observation) with precise regulatory references and tables.

6.3 🛡 Safety audit

Workplace safety audit under Italian Legislative Decree 81/2008.

Analyses the environment / situation / documentation looking for risks:

• Mandatory PPE and their condition (UNI ISO 45001, EU Reg. 2016/425)
• EN ISO 7010 signage
• Escape routes, fire safety (Italian Ministerial Decree 03/08/2015)
• Risk of falls from height, crushing, slipping
• Chemical risk (REACH / CLP)
• Electrical risk (DPR 462/01)
• Training and instruction (State-Regions agreements)
• Risk Assessment Document, POS, PSC presence

6.4 Customisable 4th button

By default shows "Industry 4.0", but you can change it via long-press (opens a menu listing all available contexts). Built-in contexts:

Single tap on the button → runs the currently selected context. Long-press → menu to choose between all 6+ contexts.

💡 You can create custom contexts in Settings → Customisable contexts (see §12).

7. The inspection session (the heart of the app)

An inspection session is a work session that collects all the NCs captured during the analysis of a site or machine.

7.1 How it opens

It opens automatically the first time you press a CE / Safety / context button. You do not need to do anything explicit.

The inspection is identified by a human-readable ID of the form:

• VCE-2026-05-11-1430 for CE verifications
• SAFE-2026-05-11-1430 for safety audits
• M40-2026-05-11-1430 for Industry 4.0 inspections

7.2 What it contains

7.3 Adding NCs to the session

Every time you press an AI button (CE / Safety / context) while the session is already open, the new NC is appended to the current session. The session keeps growing until you close or cancel it.

7.4 Typical workflow (recommended)

1. You arrive at the customer's site / factory.
2. Press CE check on the first machine → the inspection VCE-… opens.
3. Walk around, press CE check on every machine you see → NCs are added.
4. Optionally press Safety for general site risks (those NCs go into a separate SAFE-… session because the domain is different).
5. At the end of the day, tap Close on the session banner → generates PDF + Markdown.
6. Tap the 📂 square button at the bottom right → opens the inspections list → select the closed session → Share PDF → send via Mail / AirDrop / WhatsApp to the customer.

7.5 Inspection: "Close" vs. "Cancel"

The active session banner provides two buttons:

• ❌ Cancel (red, X icon): destructive. Deletes the photos, NCs and the session folder. Shows a confirmation:

  "Cancel the inspection? All photos, NCs and data collected so far will be permanently deleted. The app returns to its initial state without saving the inspection or processing anything."

  Tap Cancel inspection (red) to confirm, or Keep to go back.

• Close (orange): conservative. Saves the session as closed, generates verbale.md and verbale.pdf in the session folder. Remains visible in the history (Settings → Inspections).

💡 Important note: a closed session can be reopened from the Inspections menu → tap the session → Reopen.

7.6 Inspection history

Accessible in two ways:

• 📂 Square button at the bottom right of the home screen.
• Settings → Inspections → History and active.

The list is split into Active (max one at a time) and History (closed).

Tap on a session → see details including:

• Summary (ID, customer, dates, GPS)
• NC list with colour-coded severity
• List of machines inspected (where applicable)
• Report section: Preview PDF, Share PDF, Share Markdown buttons.

8. Voice commands and wake word

Three ways to talk to Iridai:

8.1 Wake word "hey iridai"

Configurable (default: "hey iridai" — also recognises "ciao iridai" and "ehi iridai" for Italian speakers).

While the app is open (or in the background, if you have enabled always-listening mode), say the wake phrase + your question:

"Hey iridai, what time is it?" "Ciao iridai, what do you see?" → captures a photo + describes "Ehi iridai, remind me to call the customer at 2 pm"

The app recognises the phrase and processes the rest.

💡 The wake word works even when the glasses are off (it uses the iPhone's microphone as fallback).

8.2 Tap-to-talk

The large blue "Press to speak" button at the bottom records while you hold it (push-to-talk). When you release, the app transcribes and processes.

8.3 Stop-everything

During processing or while the TTS is speaking, the large button turns red with one of these labels:

• Stop listening (if recording)
• Interrupt (if reasoning)
• Stop voice (if TTS is speaking)

Tap → immediately stops everything.

9. The Ray-Ban Meta temple tap

Iridai can intercept taps on the temple of the glasses — optional, opt-in from Settings.

9.1 What the temple does by default (Meta system)

On a stock pair of Ray-Ban Meta glasses:

• Single tap: play/pause music (AVRCP)
• Double tap: next track
• Triple tap: previous track
• Long press: activate Meta AI

9.2 What it does with Iridai (when intercept is active)

9.3 How to activate the intercept

✋ What to do:

1. Settings → Activation mode.
2. Under "Media key shortcut" → toggle Temple tap = shortcut.
3. Choose the preset that the single tap should use to open the session (recommended: CE check or Safety audit based on today's work).

9.4 Trade-offs to be aware of

When the intercept is active:

1. The voice wake word is suspended (the audio session becomes exclusive to Iridai to receive AVRCP commands).
2. The temple tap no longer controls Apple Music / Spotify — use iOS Control Centre instead.
3. Iridai becomes the "Now Playing" app — you will see it labelled "Temple shortcut — Iridai" in the music widget.

When you disable the toggle, the wake word + music control return to normal within a couple of seconds.

10. Settings — section-by-section guide

Open Settings by tapping the gear icon at the top right. The structure follows this hierarchy:

Settings
├─ AI
│   ├─ AI models and API keys
│   └─ Prompt
├─ Voice
│   ├─ Personas
│   └─ Activation mode
├─ Analysis contexts
│   └─ Customisable contexts
├─ Inspections
│   └─ History and active
├─ Agentic
│   ├─ Agentic features
│   ├─ External integrations
│   └─ RAVENG Software integration
├─ Privacy & other
│   ├─ Privacy
│   └─ Operator profile
└─ Information
    ├─ Iridai (version, build, bundle)
    ├─ Owner (RAVENG by CE4U S.r.l.)
    ├─ Legal documents (Privacy, Cookies, Terms)
    └─ Licence

11. Cloud and local AI models

In Settings → AI Models and API keys.

11.1 Active model

The picker at the top of the screen. It shows all configured models:

• Anthropic Claude Opus 4.7
• Anthropic Claude Sonnet 4.6
• Anthropic Claude Haiku 4.5
• OpenAI GPT-5
• Google Gemini 2 Flash
• (If compatible) SmolVLM2 2.2B local, Qwen2-VL 2B / 7B local, etc.

Iridai uses the chosen model for all analyses (Describe, CE, Safety, etc.) and for generic voice replies.

💡 Automatic fallback: if you pick a provider for which no key is saved, Iridai routes to another provider where you do have a key (e.g. you have only Claude saved, you pick OpenAI → the analysis goes to Claude anyway). No more "missing API key" errors.

11.2 API keys

Five rows, one per provider:

• Anthropic: key for Claude
• OpenAI: key for GPT-5
• Google Gemini: key for Gemini Flash
• ElevenLabs (premium TTS): more natural synthetic voice (optional)
• Perplexity (web search): real-time web search (optional)

✋ How to save a key:

1. Tap the field, enter the key (e.g. sk-ant-...).
2. Tap Save to the right of the field.
3. You will see Saved ✓ in green for ~2 seconds — the key has been encrypted and stored in the iOS Keychain.
4. A Available models picker appears below: Iridai has contacted the provider to discover which models your key unlocks → pick from there.

🔒 Keys are encrypted in the Keychain with Secure Enclave where available. They are not accessible to other apps or visible in clear text.

11.3 Local model (MLX)

The Local AI Models button at the bottom of the AI Models screen → opens a page with the on-device model catalogue.

A "Your device" card at the top: shows the iPhone model + RAM + which model is recommended for your spec.

Catalogue (sorted from lightest to heaviest):

Badges shown on each model's card:

• 🟢 Recommended (green) — optimal sweet spot for your iPhone.
• 🔵 Compatible (cyan) — works but does not fully exploit the device.
• 🟠 Borderline (orange) — may run slowly or crash due to memory pressure.
• 🔴 Not compatible (red) — insufficient RAM, download blocked.

✋ How to download a model:

1. Tap Download · X.X GB on the recommended model.
2. Stay on Wi-Fi if possible (1.5–7 GB download).
3. A live progress bar shows Downloading from HuggingFace… 42%.
4. After the download completes, tap Use this to make it the active model.
5. From that moment on, analyses can run fully offline.

Buttons available for downloaded models:

• In use ✓ (green badge) if it is the active model.
• Use this to activate it.
• 🗑 Trash icon to "forget it" (frees memory + cache).

12. Custom contexts and prompts

Settings → Customisable contexts.

12.1 What is a context

A context is a bundle that configures:

• Name + icon shown in the UI
• Specialist prompt injected as a system override into the LLM
• Preferred AI model (optional, e.g. Opus 4.7 for heavy analyses)
• Inspection domain (CE / Safety / I40)

Iridai ships with 6 pre-configured built-in contexts. You can:

• Edit the prompt of a built-in (tap the row → editor) and restore the original at any time.
• Add custom contexts (e.g. "HACCP Verification", "Military Barracks Audit", "ATEX Piping Maintenance") with prompts you write yourself.

12.2 Custom context creation workflow

✋ What to do:

1. Settings → Customisable contexts.
2. + Add custom context button at the bottom.
3. The editor opens:
   • Name (e.g. "HACCP Verification")
   • Icon (an SF Symbol identifier, e.g. fork.knife)
   • Dedicated AI model (optional)
   • Inspection domain (CE / Safety / I40 / none)
   • Prompt — the heart of the matter. Write a prompt in Italian (since the audience speaks Italian) along these lines:

     Behave as the best HACCP consultant in the world, with 50+ years of
     experience in laboratories, restaurants, school canteens and food
     industry. Verify critical aspects in: storage temperature, cross-
     contamination, lot identification, MOCA, operator training, self-
     monitoring, etc. Always cite the regulatory reference (Reg. EC
     852/2004, Reg. EC 853/2004, Italian Legislative Decree 193/07, etc.).
     
     [JSON v2 output schema is injected automatically]

4. Tap Save at the top.
5. The context appears in the list — you can set it as the default for the 4th home button (long-press on that button).

12.3 JSON v2 schema (structured output)

All contexts ask the model to return its response in structured JSON with these fields:

• riassunto_vocale: 1–2 sentence summary read via TTS
• titolo: max 10 words
• descrizione: detailed technical description
• criticita: array of issues
• rischi_visibili: array of visible risks
• mitigazione: array of corrective actions
• riferimenti_normativi: array of regulations with article/comma
• severita: critical / major / minor / observation

Plus optional WOW fields: confidence, main category, keywords, extracted properties, recommended actions (with priority + estimated time), visual details (what-where), indexed regulatory markers.

All these fields appear in the PDF, professionally formatted.

13. Personas

Settings → Personas.

A persona is a combination of:

• TTS voice
• Dedicated wake phrase
• AI model
• Prompt preset (voice system prompt, not analysis)

13.1 Built-in personas

💡 You can create custom personas if you want different AI identities for different customers (e.g. one more formal, one friendlier).

13.2 Switching the active persona

Tap on a persona in the list. A green ✓ checkmark appears next to the active one.

From that moment on, the wake phrases of that persona will activate the app, and the TTS voice switches accordingly.

14. Activation modes

Settings → Activation mode. Decides how Iridai listens to you when you are not using the large button.

14.1 Three presets

14.2 Granular toggles

Below the presets, the granular toggles:

• Use the glasses' microphone (yes/no)
• Wake phrase (editable)
• Silent (no wake word, no TTS) — useful in meetings
• Voice only if glasses connected — TTS only speaks when the glasses are active

14.3 Media key shortcut (temple)

See §9.

15. Advanced agentic features

Settings → Agentic features.

15.1 Proactive vision

Toggle that activates continuous passive observation: every X minutes the app captures an automatic photo and the AI comments on what it sees ("I notice you are in a workshop with low light", "I see you are looking at an electrical cabinet"). Useful for automatic situational briefing.

⚠ Privacy warning: this triggers automatic captures. Disable when entering restricted / private areas.

15.2 Agent documents

Three documents that shape the AI's behaviour:

• Soul — who the AI is, its voice, mission, user context.
• Skills — tools available and how to use them.
• Memory — facts memorised via "[REMEMBER]" annotations.

Tap one → editor → modify → save.

15.3 Playbooks

Guided sequences of steps for recurring activities (e.g. "Site opening", "Quarterly inspection", "PPE check procedure"). You can create or import them.

15.4 Scheduled tasks

Recurring briefings such as "every morning at 8:00 read me today's calendar deadlines". The app runs them in the background.

16. External integrations

16.1 Twilio (SMS)

Allows the AI model to send SMS messages automatically (e.g. alert the customer that a critical hazard has been detected).

✋ Go to https://console.twilio.com, create an Account SID + Auth Token + a verified phone number, then enter all of this in Iridai → Settings → External integrations → Twilio.

16.2 n8n (workflows)

Triggers automation workflows on a self-hosted or cloud n8n instance (e.g. when an inspection is closed, n8n creates a task in ClickUp + sends an email to the customer).

16.3 RAVENG Software integration

Placeholder for the RAVENG by CE4U S.r.l. portal (in development). Allows you to automatically sync inspections with your RAVENG tenant.

✋ To request activation: go to Settings → RAVENG Software integration → enable the toggle → tap the link info@raveng.it. You will receive your tenant URL + Secret Key.

17. PDF generation and report sharing

Every inspection automatically generates a professionally laid-out PDF when the session is closed.

17.1 What is in the PDF

1. Hero cover with a colour band by domain + large session ID
2. Summary card (customer, site, operator, date, GPS)
3. Numerical statistics in 4 columns (machines, NCs, near misses, photos)
4. Machines inspected section (CE / I40)
5. Non-Conformities section — each NC is a card with:
   • Header coloured by severity (red / orange / yellow / blue)
   • NC number + time
   • Detailed technical description
   • Regulatory reference
   • GPS / address
   • AI confidence (coloured pill: green/yellow/red)
   • Primary category
   • Keywords (pill chips)
   • Extracted properties (serial number, brand, model, year, etc.)
   • Recommended actions with priority + estimated time (high=red, medium=yellow, low=blue)
   • Visual details ("I see X in position Y")
   • Indexed regulatory markers (code + article + description)
6. Near misses + Observations sections
7. Photo gallery with a technical caption for each photo
8. Indexed citations of regulations (alphabetised)
9. Footer with pagination + Iridai branding

17.2 How to share

1. Inspections list → tap the closed session.
2. Report section:
   • Preview PDF — native iOS QuickLook view.
   • Share PDF — opens the iOS Share Sheet (Mail, WhatsApp, AirDrop, Save to Files…).
   • Share Markdown — raw text version of the report.

💡 Triple-tap the Ray-Ban Meta temple = shortcut for the Share Sheet of the current session (see §9.2).

18. Privacy and local model (zero-cloud)

🔒 Iridai is designed to be privacy-first.

18.1 What we never do

• ❌ Sell, share or monetise your data.
• ❌ Integrate third-party analytics (Google Analytics, Firebase, AppsFlyer, etc.).
• ❌ Use Apple's IDFA advertising identifier.
• ❌ Send data to RAVENG servers without your explicit opt-in.
• ❌ Track user activity across apps or websites.

18.2 What we do

• ✅ Store all data locally on your iPhone (app sandbox).
• ✅ Encrypt credentials in the iOS Keychain Secure Enclave.
• ✅ Transmit photos / text to the AI provider only when explicitly requested (you press an AI button).
• ✅ Provide the MLX local model for zero-cloud scenarios.

18.3 How to zero out every extra-EU transfer

1. Download a local model (§11.3).
2. Select it as the active model.
3. Disable Twilio / n8n / RAVENG integrations (if active).
4. From that moment on, no data leaves your iPhone. The app runs 100% offline.

18.4 Full documents

Settings → Information → Legal documents:

• Privacy Policy (GDPR Art. 13)
• Cookie Policy
• Terms of Use

19. Troubleshooting

19.1 Debug panel

Long-press 0.6s on the mini Iridai icon in the top-left → the Debug panel opens.

It shows:

• Glasses connection status
• Processing in progress (yes/no)
• Wake word listening (yes/no)
• TTS playing (yes/no)
• Streaming active (yes/no)
• Current GPS + address
• Events ring buffer (latest 200) — moment-by-moment trace of what the app is doing

19.2 Common problems and solutions

19.3 Full reset

If nothing works:

1. Cancel all active inspections.
2. Uninstall the app (long-press the home icon → Remove → Delete app).
3. Reinstall from TestFlight / App Store.
4. All local data (photos, inspections, preferences, API keys) will be deleted. You will need to re-enter the API keys.

20. Frequently Asked Questions (FAQ)

Q: Can I use Iridai without Ray-Ban Meta glasses? A: Yes, fully. The iPhone camera takes over automatically.

Q: How much does Iridai cost? A: The app requires the "Iridai Pro Monthly" auto-renewable subscription at € 9.90 per month (VAT included where applicable). Eligible new users receive a 3-day free trial (the shortest duration supported by Apple StoreKit introductory offers). Payment is managed entirely by Apple via your Apple ID — RAVENG does not receive nor process payment data. You can cancel at any time from iOS Settings → Apple ID → Subscriptions.

Q: Does the subscription include cloud AI costs? A: No. The Iridai Pro subscription unlocks the AI features of the app, but calls to Claude / GPT / Gemini incur separate costs according to each provider's price list (typically ~1-15 € cents per analysis). For zero recurring extra costs, use the local MLX model downloadable from inside the app — it runs fully offline.

Q: How much does a cloud CE analysis cost? A: It depends on the AI model chosen. Anthropic Claude Opus 4.7 ~10-15 € cents, Haiku 4.5 ~1 € cent, Gemini Flash ~1 € cent. Local model: 0 cents (you only pay for the electricity).

Q: Can I get a refund? A: Refunds are managed exclusively by Apple via the standard procedure at reportaproblem.apple.com. RAVENG cannot refund directly. Pursuant to EU and Italian consumer law, the right of withdrawal may be excluded for digital content whose performance has begun with your express consent (Article 59(m), Italian Legislative Decree 206/2005, transposing Directive 2011/83/EU).

Q: Does the PDF generated by the app have legal value? A: No. It is a working draft that you, as a qualified professional, must review and sign. See §21 and article 7 of the Terms of Use.

Q: Can I use the app to inspect military zones / airports / sensitive facilities? A: No, if forbidden by the customer's rules or by law. The user is responsible for the legitimacy of the captures.

Q: Do my data end up in the training set of Anthropic / OpenAI / Google? A: Usually no — paying API providers use API data only to serve the request (Anthropic Default API: 30-day retention, no training; OpenAI: opt-out by default; Google: configurable). Verify the specific provider policy.

Q: Can I use Iridai offline? A: Yes, with a downloaded MLX local model + optional Ray-Ban Meta glasses. No cloud, no connection.

Q: What happens if I drop my iPhone and it breaks? A: Local data is lost. Iridai 0.3.0 does not yet sync with the RAVENG cloud (coming soon). Recommendation: share the PDFs of important inspections via Mail/AirDrop immediately after closing them.

Q: Can I configure a custom wake word (e.g. "hey site")? A: Yes. Settings → Activation mode → "Wake phrase" field. Validation: minimum 3 characters.

Q: Does the app collect usage metrics / telemetry? A: No. All diagnostic logs are local (OSLog) — visible only to you via the Debug panel.

Q: Can I export inspection data for archiving? A: Yes. Tap on the inspection → "Share PDF" or "Share Markdown" → save to iCloud Drive / Dropbox / OneDrive / Files.

Q: Does it work on iPad? A: The app is designed for iPhone only (TARGETED_DEVICE_FAMILY = 1). A potential iPad version would require a dedicated build.

Q: Does it work on Apple Watch? A: Not yet. Future roadmap.

21. Safety and professional responsibility

⚠ READ THIS SECTION CAREFULLY.

21.1 AI makes mistakes

AI models can and must be considered fallible. They may:

• Cite inaccurate or superseded regulatory references.
• Misclassify severity.
• Hallucinate technical data (serial numbers, brands, years).
• Estimate dimensions / distances approximately.
• Confuse professional contexts.
• Return incorrect diagnoses or omit important issues.

21.2 You are responsible

As a consulting engineer / technical expert / qualified professional:

• You must verify every output of the app before relying on it.
• You must sign technical reports only after personal review.
• You cannot delegate professional responsibility to the AI.
• The app is a support tool, not a substitute for your judgement.

21.3 Contractual indemnity

RAVENG by CE4U S.r.l., Carlo Tenca and all their collaborators are completely and absolutely released from any responsibility for:

• Damage to persons, equipment, smartphones arising from installing / uninstalling / using the app.
• Loss of local data (photos, inspections, configurations).
• Errors, omissions or hallucinations of the AI models.
• Improper or out-of-context use of the outputs.
• Delivery of reports to customers / authorities without adequate professional verification.
• Administrative or criminal penalties, reputational damages resulting therefrom.

See articles 7 and 8 of the Terms of Use for the full detail of the indemnity.

22. Glossary

• NC — Non-Conformity: a critical issue detected during an inspection, categorised by severity.
• Severity: critical / major / minor / observation (in descending order).
• TTS — Text-To-Speech: the speech synthesiser that reads responses.
• STT — Speech-To-Text: voice transcription (Apple's SFSpeechRecognizer).
• Wake word — keyword that activates the assistant during always-on listening.
• MLX — Apple framework for AI models running on-device.
• VLM — Vision-Language Model (an LLM with image analysis capability).
• AVRCP — Audio/Video Remote Control Profile, the BT standard the temple uses to send play/pause.
• DAT SDK — Meta Wearables Device Access Toolkit, Meta's framework for accessing the Ray-Ban camera.
• Keychain — iOS encrypted storage for sensitive credentials.
• Sandbox — isolated filesystem area dedicated to a specific app.
• JSON v2 Schema — structured AI response format with WOW fields (confidence, regulatory markers, etc.).
• EN ISO 13857 / 13854 — European standards for safety distances regarding access by upper / lower limbs.
• Italian Legislative Decree 81/2008 — Consolidated Law on Workplace Safety in Italy.
• Machinery Directive 2006/42/EC — European directive on the CE marking of machinery.

23. Contacts and support

23.1 Owner

RAVENG by CE4U S.r.l. Registered office: Via Gioacchino Rossini 29/2, 37012 Bussolengo (VR), Italy VAT / Tax Code: 04731920239

23.2 Email

• General technical support: c.tenca@raveng.it
• Privacy / GDPR: privacy@raveng.it
• RAVENG portal integration request: info@raveng.it

23.3 Response times

• Technical support: within 3 business days
• Privacy requests: within 30 days (extendable to 60 under Article 12(3) GDPR for complex cases)

Manual version: 1.0 App version: Iridai 0.3.0 Date: 11 May 2026 © 2026 RAVENG by CE4U S.r.l. — All rights reserved