HASSAR.AI — User Guide v1.0

01

Introduction

HASSAR.AI is a B2B smart home intelligence platform that helps property owners, integrators, and facilities managers plan, configure, and optimise smart home ecosystems. The platform combines structured data collection (Blueprints) with an AI-powered chat assistant (Jim) to deliver personalised, actionable guidance.

Key Features

Feature	Description
My IoT Blueprint	5-step wizard to document your smart home setup
AES-256-GCM Encryption	All blueprints encrypted client-side before export
Talk to Jim	Context-aware AI assistant powered by AGIM / Ollama
Multi-Session Chat	Multiple independent conversation sessions per user
System Admin Panel	User management, logs, and AI configuration

02

Getting Started

System Requirements

Requirement	Minimum
Browser	Chrome 120+, Firefox 120+, Safari 17+, or Edge 120+
Internet	Stable broadband connection (2 Mbps+)
Screen	1280 × 768 minimum resolution
JavaScript	Must be enabled

Creating an Account

Open your browser and navigate to the HASSAR.AI application URL.
On the landing page, click Get Started or Sign Up.
Fill in the registration form: Full Name, Email Address, and Password.
Review the password strength indicator (Weak / Fair / Good / Strong / Very Strong).
Click Create Account.
You will be redirected to the dashboard automatically.

Logging In

Navigate to the application URL and click Log In.
Enter your Email and Password.
Click Sign In. On success you are redirected to the dashboard.

Session Your session token is valid for 30 minutes and refreshes automatically while you are active. Closing the browser tab ends your session.

03

Dashboard Overview

After logging in, you land on the Dashboard — the central hub of HASSAR.AI. The left-hand sidebar provides navigation to all sections.

Sidebar Item	Description
Home	Dashboard overview screen
My IoT Blueprint	Create and export encrypted smart home blueprints
Talk to Jim	AI-powered smart home assistant
System Admin	Administrative panel (admin users only)

04

My IoT Blueprint

A Blueprint is a comprehensive record of your smart home installation — covering your property type, rooms, devices, network setup, and automation goals. Blueprints are exported as AES-256-GCM encrypted .hassar files that can be uploaded into Jim for AI-powered recommendations.

Navigate to My IoT Blueprint in the sidebar. From the hub you can Create New Blueprint (launch the 5-step wizard) or Review Existing Blueprint (decrypt and inspect a previously exported .hassar file).

Step 1 — Home Setup

Field	Options
Property Type	Apartment, House, Townhouse, Villa, Studio
Rooms	Living Room, Master Bedroom, Kitchen, Bathroom, Home Office, Garage, Garden/Outdoor, Laundry Room, Hallway, Basement, and more

Step 2 — Devices

Select the smart home brands and devices installed in your property.

Brand	Example Devices
Aqara	Hub M2/M3, Smart Plug, Door & Window Sensor, Motion Sensor P1, Wall Switch H1, Camera Hub G3, Presence Sensor FP2, Thermostat S3
Eve	Eve Energy, Eve Door & Window, Eve Motion, Eve Thermo, Eve Room, Eve Water Guard, Eve Cam Outdoor
Shelly	Shelly 1/1PM, Shelly 2.5/Plus 2PM, Shelly Dimmer 2, Shelly Pro 4PM, Shelly Plus Plug S, Shelly TRV
Eufy	EufyCam 2/3, Eufy Doorbell, Eufy Smart Lock, Eufy Robot Vacuum, Eufy Indoor Cam, Eufy Floodlight Cam
Nanoleaf	Shapes Hexagons, Light Panels, Lines, Canvas, Elements Wood Panels, Essentials Bulb, Essentials Lightstrip

You can also enter Other devices in the free-text field for brands or models not listed above.

Step 3 — Network

Select all network protocols and connectivity types used in your property:

WiFiEthernetMesh NetworkMatterZigbeeZ-WaveThreadBluetooth

Step 4 — Goals

Select your smart home automation goals (choose all that apply):

Energy savingSmart lightingBetter connectivityHome securityAutomation & schedulesAir quality monitoringWater leak detectionAccess controlEntertainmentChild safetyPet monitoringRemote access

Step 5 — Review & Export

The final step shows a complete summary. Review each section, then click Previous to go back and make changes.

Enter your Passphrase — this encrypts your blueprint file. Store it safely; it cannot be recovered if lost.
Confirm the passphrase in the second field.
Meet all strength requirements: 8+ chars, uppercase, lowercase, number, special character.
Click Export. A .hassar file is downloaded to your device.

Privacy guarantee Encryption is performed entirely in your browser. The server never sees your plaintext blueprint data or your passphrase.

Encryption Specification

Algorithm

AES-256-GCM

Key Derivation

PBKDF2-SHA256

Iterations

390,000

Salt

16 bytes

IV

12 bytes

Execution

Client-side

Review Existing Blueprint

From the Blueprint Hub, click Review Existing Blueprint.
Select your .hassar file.
Enter the passphrase used when exporting.
The blueprint contents are displayed on screen, organised by section.

05

Talk to Jim (AI Chat)

Jim is HASSAR.AI's AI-powered smart home assistant. Jim uses context from your blueprint and conversation history to provide personalised, actionable smart home recommendations.

Starting a Conversation

Navigate to Talk to Jim in the sidebar.
Click any suggested prompt or type your own question.
Press Enter or click the Send button.

Chat Sessions

HASSAR.AI supports multiple independent chat sessions per user. Each session maintains its own conversation history.

Action	Description
Click a session name	Switch to that session
+ New Session (at top)	Create a new empty session
Trash icon (on hover)	Delete that session

Up to 20 sessions per user · Up to 100 messages per session · Stored per browser/device

Loading a Blueprint into Chat

In an active chat session, click the upload icon in the chat input area.
Select your .hassar blueprint file.
Enter your passphrase when prompted.
Jim will confirm the blueprint is loaded and use it as context for all subsequent answers.

AI Routing

Source	Usage
AGIM (Agentic Intelligence Manager)	Primary AI — routes through Cloudflare, Firewall, and VPN to the Agentic Controller
Ollama	Local fallback when AGIM is unavailable

06

System Admin Panel

The System Admin panel is accessible only to users with the admin role. It appears as System Admin at the bottom of the sidebar.

Overview Stats

Stat	Description
Total Users	Count of all registered accounts
Admin Users	Count of accounts with admin role

User Management

Navigate to System Admin → Users to view and manage all accounts.

Action	Description
Promote to Admin	Grant admin privileges to a user
Demote to User	Remove admin privileges
Delete Account	Permanently remove the account (irreversible, requires confirmation)

System Logs

Navigate to System Admin → Logs to view application event logs — timestamp, log level, and message.

AI Configuration

Navigate to System Admin → AI Config to manage AI routing settings.

Setting	Description
AGIM URL	Endpoint URL for the AGIM service
AGIM API Key	Authentication key for AGIM
Ollama URL	URL for the local Ollama instance
Ollama Model	Model name to use (e.g. `llama3.2`)

07

Security & Privacy

Data Type	Storage	Encryption
Blueprint plaintext	Never stored on server	N/A
Blueprint files (`.hassar`)	User's local device	AES-256-GCM
Chat history	Browser localStorage	None (browser storage)
Account credentials	PostgreSQL database	bcrypt hashed
Auth tokens	sessionStorage + httpOnly cookie	TLS in transit

Best Practices

Use a unique, strong passphrase for each blueprint export.
Store blueprint passphrases separately from the .hassar files (use a password manager).
Log out when using shared or public computers.
Do not share your .hassar file and passphrase together.
Admin accounts should only be used when performing administrative tasks.

08

Troubleshooting

Issue	Possible Cause	Solution
Cannot log in	Wrong credentials	Re-enter credentials carefully
"Email already in use" on signup	Account exists	Use login page instead
Blueprint export not downloading	Browser popup blocker	Allow downloads from the app domain
"Incorrect passphrase or corrupted file"	Wrong passphrase entered	Re-enter exact passphrase used during export
Jim not responding	AI service unavailable	Wait and retry; check System Admin → AI Config
Chat history missing	Different browser or cleared storage	History is per-browser/device
Blueprint context lost in new session	By design	Re-upload `.hassar` file in the new session
System Admin not visible	Account is not admin	Contact an existing admin to promote your account

09

Glossary

Term	Definition
AGIM	Agentic Intelligence Manager — HASSAR.AI's primary AI routing engine
AES-256-GCM	Advanced Encryption Standard, 256-bit key, Galois/Counter Mode
Blueprint	A structured record of a property's smart home setup
`.hassar` file	The encrypted blueprint export file
Jim	HASSAR.AI's AI chat assistant
Matter	Universal smart home connectivity standard
Ollama	Local AI model runner used as fallback
Passphrase	The password used to encrypt and decrypt a blueprint
PBKDF2	Password-Based Key Derivation Function 2
Session	An independent chat conversation with Jim
Zigbee	Low-power wireless mesh protocol for smart home devices
Z-Wave	Sub-GHz wireless protocol for home automation