Incident AI
App Manual

Voice-Based HSE Observation Reporting System

Field User Documentation

Web App: https://incidentai.applivity.com
Also available on: RealWear Store ยท Google Play Store ยท App Store
Version: 1.0

ยฉ 2026 Applivity. All rights reserved.

๐Ÿ“‹ Table of Contents

1
Introduction & Overview
3
2
Sign In โ€” Email Login
4
3
Sign In โ€” QR Code Login
6
4
License Activation
7
5
Main Reporting Screen
8
6
Selecting Your Location
10
7
Selecting Your Language
11
8
Making a Voice Observation
12
9
Completing & Submitting a Report
14
10
Troubleshooting & Tips
16
Section 01
Introduction & Overview
Understanding the Incident AI Voice Reporting App

What is Incident AI?

Incident AI is an intelligent, voice-powered Health, Safety and Environment (HSE) observation and incident reporting platform. The Reporting App (incidentai.applivity.com) is designed for everyone who needs to file safety observations on the go โ€” both Admins and Inspectors can sign in and submit reports from the app.

๐ŸŽค Voice-First Design

Simply speak your observation aloud โ€” the AI transcribes it in real time, extracts the relevant details (area, type, action taken), and generates a structured report automatically. No typing required!

App Features

๐ŸŽค
Voice Reporting
Report incidents simply by speaking. AI handles transcription and structured data extraction automatically.
๐ŸŒ
Multi-Language
Report in English or Urdu โ€” the system understands both languages for maximum inclusivity.
๐Ÿ“
Location-Based
Select your current work area to precisely tag where the incident or observation occurred.
๐Ÿ“ท
Photo Evidence
Attach photos to your reports for visual documentation and evidence.
๐Ÿ“ฑ
QR Login
Quick access via QR code โ€” no need to type your credentials each time.
๐Ÿ”’
Device License
Secure device licensing ensures only authorized devices access the reporting system.

Who Uses the App?

The Incident AI App is open to both Inspectors and Admins:

You do not need any technical expertise to use the app โ€” it is designed to be simple and intuitive for every role.

โ„น๏ธ App vs. Admin Portal

The App (incidentai.applivity.com) is for submitting reports and is available to both Admins and Inspectors. The Admin Portal (a separate URL) is for reviewing/approving reports and managing the organization, and is restricted to Admins only.

Where to Get the App

Incident AI is available across multiple platforms so you can report observations from any device you use in the field:

๐ŸŒ
Web App
Open https://incidentai.applivity.com in any modern browser. No install required โ€” ideal for desktops, laptops and tablets.
๐Ÿฅฝ
RealWear Store
Optimized build for RealWear HMT-1 and Navigator 500 head-mounted devices. Hands-free voice reporting for field operations.
๐Ÿค–
Google Play Store
Native Android app for phones and tablets. Search for "Incident AI" on the Play Store to install.
๐ŸŽ
App Store
Native iOS app for iPhone and iPad. Search for "Incident AI" on the App Store to install.

System Requirements

Requirement Details
Web Browser Chrome 90+, Firefox 88+, Safari 14+, Edge 90+ (with microphone access)
Android Android 8.0 (Oreo) or later โ€” install from Google Play Store
iOS iOS 14 or later โ€” install from the App Store
RealWear RealWear HMT-1, HMT-1Z1, or Navigator 500 โ€” install from RealWear Store
Microphone Required for voice reporting. Allow microphone permission when prompted.
Internet Stable connection required for report submission and AI processing
Web App URL https://incidentai.applivity.com/sign-in
Role Required Admin or Inspector role (any active user in your organization can sign in)
Section 02
Sign In โ€” Email Login
How to access the Incident AI Reporting App with email and password

The Sign In Screen

When you open the app, you'll see the main Sign In screen with two login options: Login with Email and Login with QR. The red button is the Email login option.

https://incidentai.applivity.com/sign-in
INCIDENT AI
LOGIN WITH EMAIL
LOGIN WITH QR
ยฉ 2026 Applivity. All rights reserved.

Figure 2.1 โ€” App Sign In Screen with Login Options

Email Login Steps

1

Click "LOGIN WITH EMAIL"

Click the red "LOGIN WITH EMAIL" button. A form will appear with email and password fields.

2

Enter Your Email Address

Type your registered email address in the email field (e.g., user@example.com). This is the email your admin created your account with.

3

Enter Your Password

Type your password in the password field. Click the eye icon to toggle visibility if needed.

4

Click SIGN IN

Click the red SIGN IN button. After authentication, you may be prompted to activate your device license.

https://incidentai.applivity.com/sign-in (Email Form)
GO BACK
Enter your email
Enter your password
SIGN IN

Figure 2.2 โ€” Email Login Form

โš ๏ธ Forgot Password?

Contact your organization's administrator if you have forgotten your password. They can reset it for you from the Admin Portal.

Section 03
Sign In โ€” QR Code Login
Faster login using your organization's QR code

What is QR Login?

QR Code Login is a faster alternative to email login. Your organization admin will provide a QR code that encodes your login credentials. Simply scan it with your device camera to log in instantly โ€” no typing required.

QR Login Steps

1

Click "LOGIN WITH QR"

On the Sign In screen, click the white "LOGIN WITH QR" button. Your device's camera will activate.

2

Point Camera at QR Code

Hold your device so the camera can clearly see the QR code provided by your administrator. The app will automatically scan it.

3

Automatic Login

Once the QR code is recognized, you will be automatically logged in and directed to the reporting screen.

โ„น๏ธ QR Code Setup

QR codes are generated by your organization's Admin Portal. Each QR code is linked to a specific user account and organization. Ask your admin to generate one for you if you don't have one.

How Your Admin Generates Your QR Code

Your organization administrator can create a sign-in QR code for any user directly from the Admin Portal. The steps they follow are:

1

Open the Users Page

In the Admin Portal, the admin navigates to Organization โ†’ Users to see the full list of users.

2

Open the User Actions Menu

The admin clicks the three-dot icon (โ‹ฎ) in the Action column for your row. A dropdown appears with four options: Edit, Change Password, Delete, and Generate QR Code.

3

Click "Generate QR Code"

Selecting Generate QR Code produces a QR image tied to your account. The admin can share it with you on screen, send it to you, or print it for a shared device.

4

Use It to Sign In

Once you have the QR image, follow the QR Login Steps above โ€” tap LOGIN WITH QR in the app and point your camera at it. You'll be signed in instantly.

When to Use QR Login

QR Login is the recommended method on any Tablet, RealWear device, or Mobile device โ€” these devices have a built-in camera that can scan the QR code, making sign-in fast and typing-free.

Device Recommended Login Method
Tablet (Android or iPad) QR Code Login โ€” fastest, no typing required
RealWear device (HMT-1, Navigator 500) QR Code Login โ€” ideal for hands-free, head-mounted use
Mobile phone (Android or iPhone) QR Code Login โ€” quickest on small screens
Desktop / laptop browser Email Login โ€” no camera needed
Section 04
License Activation
Activating your device license to use the reporting app

What is License Activation?

After signing in for the first time on a new device, you will be shown the Activate License screen. This is a one-time setup step that ties your device to your organization's subscription, ensuring secure and authorized access.

https://incidentai.applivity.com/reporting (License Dialog)

Activate License

Please enter your license key to continue using the service.

License Key
XXXX-XXXX-XXXX-XXXX
SCAN LICENSE KEY
DEVICE IDca2e997a2b0c...
USERuser@example.com
VALIDATE LICENSE
LOGOUT

Figure 4.1 โ€” License Activation Screen

Activating Your License

1

Enter Your License Key

Type your license key in the field using the format XXXX-XXXX-XXXX-XXXX. Your administrator will provide this key. Alternatively, if a key is pre-filled, proceed to step 2.

2

Or Scan License Key via QR

Click "SCAN LICENSE KEY" to use your camera to scan a QR code version of the license key provided by your administrator.

3

Verify Device Info

Confirm that the Device ID and User email shown match your device and account. This is pre-filled automatically.

4

Click VALIDATE LICENSE

Click the blue "VALIDATE LICENSE" button. The system will verify your key. If valid, you'll be taken to the reporting screen immediately.

โœ… One-Time Setup

License activation is typically only required once per device. After activation, you will be taken directly to the reporting screen on subsequent logins from the same device.

โš ๏ธ Don't Have a License Key?

Contact your organization administrator to obtain a license key for your device.

Section 05
Main Reporting Screen
Understanding the app's main interface

The Reporting Dashboard

After a successful login and license activation, you are taken to the Main Reporting Screen. This is the central hub of the app โ€” everything you need to make a report is here.

https://incidentai.applivity.com/reporting
INCIDENT AI
LOGOUT
START REPORTING
Click "START REPORTING" to begin
SELECT LOCATION
(Main Back Yard)
SELECT LANGUAGE
(English)
ยฉ 2026 Applivity. All rights reserved.

Figure 5.1 โ€” Main Reporting Screen

Screen Elements Explained

Element Location Description
INCIDENT AI Logo Top left header App branding with Incident AI name and icon
LOGOUT button Top right header Click to sign out of the app securely
START REPORTING button Center of screen The main action button โ€” click to begin recording your voice observation
Instruction text Below START REPORTING "Click START REPORTING to begin" โ€” guidance text for new users
SELECT LOCATION Bottom left Shows current location (e.g., Main Back Yard). Click to change your work location.
SELECT LANGUAGE Bottom right Shows current language (e.g., English). Click to change the reporting language.
โš ๏ธ Before You Start

Before clicking "START REPORTING", make sure you have selected the correct Location and Language. These settings ensure your report is filed correctly in the system.

Section 06
Selecting Your Location
Choosing the correct workplace area before reporting

Why Location Matters

Every report must be linked to a specific workplace location. This ensures that safety observations are properly tracked by area, allowing management to identify patterns and high-risk zones.

How to Select a Location

1

Click "SELECT LOCATION"

Click the "SELECT LOCATION (location name)" button at the bottom left of the main screen. A dialog will appear.

2

Say the Location Name (Voice)

A microphone dialog will open with the message "SAY THE LOCATION NAME TO SELECT IT". Simply speak the name of your location clearly (e.g., say "Main Back Yard").

3

Location Updates

The AI will recognize the spoken location name and update the SELECT LOCATION button to show your chosen location. The dialog will close automatically.

Location Selection Dialog
๐Ÿ“ SAY THE LOCATION NAME TO SELECT IT
๐ŸŽค
CLOSE

Figure 6.1 โ€” Voice-Based Location Selection Dialog

Available Locations

The locations you can choose from are configured by your organization's admin in the Admin Portal (Configurations โ†’ Locations). Only the locations the admin has added will be recognized by voice. Examples might look like:

Location Name How to Say It
Main Back Yard "Main Back Yard"
Central Tech Yard "Central Tech Yard"

If your work area isn't in the list โ€” or if you need a new location added โ€” contact your organization administrator. They can add it from the Admin Portal and it will immediately become available in the app.

โ„น๏ธ Tip

If the system doesn't recognize your location name, try speaking more clearly and slowly, or click CLOSE and try again.

Section 07
Selecting Your Language
Choosing the language for your voice observation

Language Selection Overview

Incident AI supports multiple languages for voice reporting. The languages you see in this dialog are the ones your organization's admin has turned on in the Admin Portal (Configurations โ†’ Languages) โ€” so the list may look different in your app depending on what's enabled. Select your preferred language before starting so the AI correctly transcribes your spoken observation.

Voice recognition is powered by Microsoft Azure Cognitive Services โ€” Speech to Text, which supports the languages listed below. Your admin can enable any of these from the Admin Portal. Each language may include several regional variants (locales) โ€” for example, English ships with US, UK, Australian, Indian and many other accents; Spanish covers all major Latin American and European variants.

โ„น๏ธ Locales

Locale codes follow the language-REGION pattern (for example, en-US = English / United States, ur-PK = Urdu / Pakistan). Choosing a locale closer to your accent typically improves recognition accuracy.

For the full, always-current list of supported languages and locales, refer to the official Microsoft documentation: learn.microsoft.com/azure/ai-services/speech-service/language-support.

Language Options Dialog
๐ŸŒ LANGUAGE OPTIONS
ENGLISH
URDU
CLOSE

Figure 7.1 โ€” Language Options Dialog

How to Select a Language

1

Click "SELECT LANGUAGE"

Click the "SELECT LANGUAGE (current language)" button at the bottom right of the main screen.

2

Choose Your Language

Click either "ENGLISH" or "URDU" based on the language you want to speak your observation in. The selected language will be highlighted.

3

Close the Dialog

Click CLOSE or click outside the dialog. The SELECT LANGUAGE button will update to show your chosen language.

Example Languages

Below are examples of languages that may be enabled by your admin. The actual list shown in your app is controlled centrally โ€” if a language you need isn't there, ask your admin to enable it from Configurations โ†’ Languages in the Admin Portal.

๐Ÿ‡ฌ๐Ÿ‡ง
English
Report your observation in English. The AI transcribes and processes English speech accurately. Typically set as the default.
๐Ÿ‡ต๐Ÿ‡ฐ
Urdu (ุงุฑุฏูˆ)
Report in Urdu. The AI supports Urdu voice recognition for workers more comfortable speaking in Urdu.
Section 08
Making a Voice Observation
Step-by-step guide to recording a safety observation using your voice

The Voice Reporting Screen

After clicking "START REPORTING", the app switches to the Voice Reporting screen. This is where you speak your observation. The AI processes your speech in real time.

https://incidentai.applivity.com/reporting (Active Recording)
GO BACK
LOGOUT

Please report an INCIDENT / OBSERVATION
to see the summary.

๐ŸŽค
COMPLETE REPORT
PAUSE

Figure 8.1 โ€” Active Voice Recording Screen

Voice Recording Screen Elements

Element Description
GO BACK button Returns to the main reporting screen without saving. Use if you started by mistake.
Center message area "Please report an INCIDENT / OBSERVATION to see the summary." โ€” This area will fill with your transcribed observation as you speak.
Microphone button (red circle, bottom left) The active recording indicator. The pulsing red circle shows the microphone is listening. Click to toggle mute.
COMPLETE REPORT button (green) Click when you've finished speaking your observation to generate the structured report summary.
PAUSE button Temporarily pause recording without losing your observation. Click again to resume.

How to Make a Voice Observation

1

Select Location & Language First

Before clicking START REPORTING, ensure the correct location (e.g., "Main Back Yard") and language (e.g., "English") are selected at the bottom of the main screen.

2

Click START REPORTING

Click the red "START REPORTING" button. The app switches to the recording screen. Allow microphone access if prompted.

3

Speak Your Observation Clearly

With the microphone active (pulsing red button), describe what you observed. Be specific and include: what you saw, where exactly, and any action taken. Example: "Workers in the electrical room were not wearing safety helmets. I informed the site supervisor."

4

Include Key Details

For the best report, include: the area name, what the unsafe act or condition was, who was involved (if applicable), and what action was taken.

5

Review the Transcription

As you speak, the AI transcribes your words in the center area of the screen. Review it to ensure accuracy. Use PAUSE if you need a moment to think.

6

Click COMPLETE REPORT

When done speaking, click the green "COMPLETE REPORT" button to finalize and generate the structured report summary.

Tips for Better Voice Reporting

๐Ÿ“ Example Voice Observation

"Workers in the electrical room were not wearing safety gear. Two workers without hard hats observed during morning inspection. I informed the field safety engineer to take immediate action."

Section 09
Completing & Submitting a Report
Reviewing the AI-generated summary and submitting your report

Report Summary Generation

After clicking "COMPLETE REPORT", the AI processes your voice observation and generates a structured report summary. This summary extracts key information from your speech into organized fields.

What the AI Extracts

The Incident AI system automatically extracts the following information from your voice observation:

Field What AI Detects Example
Description The main observation description "Workers not wearing safety gear"
Area Specific area mentioned "Electrical Room"
Type Classification of observation "unsafe act"
Action Taken Any corrective action mentioned "Informed field safety engineer"
Language Language used for reporting "English"
Location The pre-selected work location "Main Back Yard"

Report Types

โš ๏ธ
Unsafe Act
When a person is doing something that violates safety procedures (e.g., not wearing PPE, bypassing safety guards).
๐Ÿ”ง
Unsafe Condition
When equipment, environment, or infrastructure poses a safety risk (e.g., wet floor, exposed wiring, broken barrier).
โœ…
Safe Condition
A positive observation noting that safety procedures are being followed correctly. Encourages and reinforces good safety behavior.

Submitting the Report

1

Review the Summary

After the AI processes your observation, review the generated summary on screen. Verify that the description, area, type, and action details are accurate.

2

Add Photos (Optional)

If available, attach photos of the incident or observation as visual evidence. Photos are highly recommended for unsafe conditions.

3

Submit the Report

Click the Submit button to send the report to the admin portal. Once submitted, the status will be "Submitted" and it will appear in the admin's All Reports dashboard for review.

โœ… Report Submitted Successfully

After successful submission, your report is stored in the system with "Submitted" status. Your organization's safety admin will review it and approve valid observations.

โ„น๏ธ Post-Submission

Once submitted, you will be returned to the main reporting screen, ready to make another observation. Each report is independent โ€” you can make multiple reports in a single session.

Section 10
Troubleshooting & Tips
Common issues and best practices for field users

Frequently Asked Questions

Q: The app isn't recognizing my voice. What should I do?

Ensure you have allowed microphone permissions in your browser. Try refreshing the page and clicking Start Reporting again. Make sure you are in a quiet environment and speaking clearly into the microphone.

Q: How do I allow microphone access?

When prompted by your browser, click "Allow" to grant microphone access. If you accidentally blocked it, go to your browser settings > Privacy > Site Settings > Microphone and allow incidentai.applivity.com.

Q: The transcription is not accurate. What can I do?

Q: I see the "Activate License" screen every time I log in. Is this normal?

No, this should only happen on a new device. If you see it repeatedly, your license may have expired or the device ID changed. Contact your admin to re-activate the license.

Q: I forgot my password. Who do I contact?

Contact your organization administrator. They can reset your password from the Admin Portal. Alternatively, use QR Code Login if available.

Q: Can I make reports offline?

No. The Incident AI system requires an active internet connection for voice processing and report submission. Ensure you have a stable network connection before making reports.

Q: My location isn't in the list. What do I do?

Contact your organization administrator to add the missing location in the Admin Portal (Configurations โ†’ Locations). Once added, it will be available for voice selection.

Common Error Messages

Message Cause Solution
Microphone not accessible Browser permission denied Allow microphone in browser settings
Invalid license key Wrong or expired key Get new key from admin
Login failed Wrong email/password Check credentials or reset password
Report submission failed No internet connection Check connection and try again
Location not recognized Unclear speech Speak location name clearly and retry

Safety Reporting Best Practices

๐Ÿ“ž Support Contact

For technical issues or questions, contact your organization administrator using the contact details they provided during account setup.