LORA Assistant Documentation
🔖What is LORA?
- LORA is an advanced AI voice assistant with local processing
- LORA supports natural language conversations and commands
- LORA integrates with Spotify for music control
- LORA connects with Home Assistant for smart home automation
- LORA maintains intelligent memory about users and conversations
- LORA keeps all your data local and secure
Key Features
| Feature | Description |
|---|---|
| Voice Control | Wake LORA with "Hey LORA" and speak naturally |
| Local Processing | All data stays on your device - privacy first |
| Smart Memory | LORA remembers users and conversation context |
| Multi-language | Supports multiple languages out of the box |
| Music Control | Play and control Spotify with voice commands |
| Smart Home | Control lights, temperature, and devices via Home Assistant |
What You Will Learn
- How to set up LORA for the first time
- Connecting LORA to your WiFi network
- Navigating the LORA Web App interface
- Setting up user profiles with voice recognition
- Integrating Spotify and Home Assistant
- Using voice commands effectively
- Managing subscriptions and updates
- Troubleshooting common issues
Introduction to LORA
🔖How LORA Works
LORA operates as a self-contained system that processes everything locally on your device. This means:
- Your voice data never leaves your device
- Conversations are stored locally for 2 days (today and yesterday)
- User profiles and memories are kept on your device
- Internet connection is only needed for external services (Spotify, weather, etc.)
System Requirements
What You Need
- LORA device (provided in the box)
- WiFi network (2.4GHz or 5GHz)
- Computer, tablet, or smartphone with web browser
- Email address for account creation
- Optional: Spotify Premium account
- Optional: Home Assistant installation
Subscription Models
| Plan | Description | Best For |
|---|---|---|
| LORA Single | One user, one device | Individual users or single households |
| LORA Duo | Two users, two devices | Couples or shared environments |
Initial Setup Guide
🔖Step-by-Step Setup
Take LORA out of the box and plug it into a power outlet. LORA will boot up automatically.
LORA will announce that it is ready to connect to your WiFi. You will hear: “Scan QR code with LORA.”
On your phone, tablet, or computer, go to:
Enter your home WiFi name and password.
Click “Generate QR Code”.
Hold the generated QR code in front of LORA’s camera. Keep the QR code very close (5–10 cm) so the camera can read it clearly. If it is too far away, the scan will not work.
Once scanned, LORA will automatically connect to your home WiFi.
LORA will confirm successful WiFi setup and reload its services. Wait until you hear the launch sound.
Now that LORA is connected to your home WiFi, open:
If lora.local doesn’t work, try lora-2.local or lora-3.local. If none load, contact office@loratech.io.
First Launch Configuration
🔖Create Your Account
When prompted, please enter your own email address. Do not use the pre-filled email (loraailabs@gmail.com) — it is only a placeholder and must be replaced with your email.
The system keeps credentials locally. If you update LORA, your credentials will be erased from the system. Write them on paper and keep them safe!
You will be prompted to accept voice consent, allowing LORA to process your voice and text data locally.
After completing the previous steps, you'll have full access to the LORA Web App interface.
What's Next?
Now that you've completed the initial setup, you should:
- Purchase a subscription plan (LORA Single or LORA Duo)
- Set up user profiles with voice recognition
- Configure timezone and language settings
- Optionally connect Spotify and Home Assistant
Subscription Plans
🔖Purchasing Your Subscription
To use LORA, you need an active subscription. Navigate to the Plans section in the Web App.
LORA Single
Setup Process
In the Web App, click on Plans in the navigation.
You'll see a button-link that will redirect you to the payment page.
Follow the payment process to complete your subscription.
After successful payment, return to the LORA Web App.
LORA Duo
Setup Process
Follow the same payment process as LORA Single.
After payment, you will be asked to enter a secondary user's email address. This will be used for the second LORA device.
The second LORA device must be signed in during configuration with the same email address you entered as the secondary email.
Verifying Your Subscription
After purchasing and authenticating your subscription:
- Go to the Plans section
- You should see "Subscription Control"
- Check for "Current subscription Mode: [your mode]"
- Visit the Portal section to see your request limits
Managing Your Subscription
You can cancel your subscription at any time from the Plans section in the Web App.
LORA Web App Overview
🔖Main Sections
| Section | Description |
|---|---|
| Welcome Page | Home page and quick start guide |
| Stream | Real-time chat streaming for seeing responses as they generate |
| Portal | View limits, chat history, memory threads, and timers |
| Profiles | Manage user profiles and register new users with voice |
| Control | Microphone control, LORA modes, and system reload |
| Settings | Volume, language, timezone, Spotify, Home Assistant, and custom prompts |
| Plans | Manage subscriptions and view current plan |
| Update | Download and install system updates |
Accessing the Web App
Stream
🔖Real-Time Chat Streaming
The Stream section allows you to chat with LORA in real-time through the web interface and see responses as they are generated.
Features
- See LORA's response being written in real-time
- Useful for monitoring longer responses
- Alternative to voice commands for text-based interaction
- Great for testing and debugging
How to Use
Portal
🔖Portal Overview
The Portal section is your information hub for monitoring usage, history, memories, and scheduled tasks.
Limit
Shows your current usage limits and remaining requests based on your subscription plan.
- View how many requests you have left
- Monitor your daily usage
Chat History
LORA keeps your conversation history locally for the past 2 days.
- Today: All conversations from today
- Yesterday: All conversations from yesterday
- Older conversations are automatically deleted for privacy
- All history is stored locally on your device
Memory Threads
LORA's intelligent memory system that remembers information about each user.
Viewing Memories
- By default, memory cores are in read-only mode
- See what LORA remembers about each registered user
- Memory threads are organized by user profile
Editing Memories
Clearing Memories
- Clear user-specific memories: Remove memories for a single user
- Clear all users' memories: Reset all memory threads
Time
Manage your timers, reminders, and alarms.
- View all active timers and alarms
- See upcoming reminders
- Delete timers or reminders you no longer need
Profiles
🔖User Profile Management
The Profiles section allows you to register and manage users with voice recognition.
User Profiles
View and manage registered users:
- See all registered users
- Delete users by name
- Check which profiles have voice recognition enabled
Register New User
Registration Process
Go to the Profiles section and select "Register User"
You have two options:
- Add Voice: Register with voice only (recommended)
- Add Voice & Face: Register with voice and facial recognition (beta)
You will be prompted to record your voice. Pronounce the text shown on the screen clearly.
After recording, the system will reload and process your voice profile. This may take a few moments.
Once complete, your user profile will appear in the User Profiles list.
Why Register Users?
- Personalization: LORA can recognize who is speaking
- Memory Threads: LORA maintains separate memories for each user
- Context Awareness: Better understanding of individual preferences
- Multi-user Support: Multiple people can use the same LORA device
Control
🔖LORA Control Panel
The Control section allows you to manage LORA's operational settings and modes.
Microphone Control
Manage LORA's microphone status:
- View current microphone status (active/muted)
- Mute: Disable voice listening temporarily
- Unmute: Re-enable voice listening
LORA Modes
Initial Setup
When you first launch LORA Modes, you need to:
Choose your geographic region to set data privacy and consent preferences (e.g., GDPR for EU users).
You'll be prompted for two consent options:
- Infinity Vision Mode: Advanced visual recognition (not currently working)
- Hand Gesture Mode: Control LORA with hand gestures (beta testing)
Available Modes
- Infinity Vision: Not operational in this version
- Hand Gesture Mode: Beta stage - control LORA with hand movements
LORA Control
System Reload
You can reload the entire LORA software system:
- Reboots the LORA software
- Does NOT reboot the main hardware controller
- Useful for applying new settings or fixing minor issues
- Wait for the launch sound before using LORA again
- After connecting Spotify
- After changing critical settings
- When LORA seems unresponsive
- After user profile registration
Settings
🔖LORA Settings
Configure LORA's behavior and integrations to match your preferences.
Change Volume
Adjust LORA's voice output volume:
- Use the slider to increase or decrease volume
- Changes take effect immediately
- Applies to all voice responses and sounds
Change Language
Control the language for pre-recorded sounds and UI:
- Changes language for pre-recorded speech sounds
- Changes Web App UI language
- Does NOT affect conversational language
Change Timezone
Highly Recommended: Set your correct timezone
- Critical for accurate time-based features
- Required for alarms and reminders to work correctly
- Affects scheduled tasks and time-related queries
Custom Prompt
Personalize LORA with custom instructions:
- Give LORA context about your location, preferences, or needs
- Set permanent instructions for how LORA should behave
- Add background information LORA should remember
Example Custom Prompts
Tailscale
⚠️ Advanced Feature - Do Not Touch
- Used for remote support and troubleshooting
- Only to be configured by LORA support team
- Contact support if you need remote assistance
Spotify Integration
🔖Connect Spotify to LORA
Integrate your Spotify account to control music playback with voice commands.
Requirements
- Active Spotify Premium account (required for API access)
- LORA connected to WiFi
- Access to LORA Web App
Connection Process
Go to Settings → Connect Spotify +
Click the button labeled "Authorize Spotify"
Click the button "Click here to authorize Spotify"
You'll be redirected to Spotify's authentication page. Sign in with your Spotify credentials.
Grant LORA permission to access your Spotify account. If you see {'success'} or a similar message, you're done!
Navigate back to the LORA Web App
Go to Control section and click "Reload" so LORA can initialize the new Spotify connection
After LORA plays the launch sound:
- Go to Settings → Connect Spotify +
- Click "Check Connection"
- If you see your Spotify username, you're successfully connected!
Troubleshooting
- Connection fails: Make sure you have Spotify Premium
- Username doesn't show: Try reloading LORA again
- Commands don't work: Verify connection status in Settings
Home Assistant Integration
🔖Connect LORA to Home Assistant
Integrate LORA with Home Assistant to control your smart home devices with voice commands.
https://github.com/dykyivladk1/lora-ha-integration/blob/main/blueprints/automation/lora/config.yaml
Important: First, you need to access your Home Assistant configuration interface.
The interface location may differ depending on your setup, but by default it is usually available at:
http://homeassistant.local:8123/
Prerequisites
- Running Home Assistant installation
- Access to Home Assistant settings
- LORA and Home Assistant on the same network
Home Assistant Setup
Step 1: Install MQTT Broker
Step 2: Create LORA User
Step 3: Import Blueprint
Step 4: Create Automation
Step 5: Configure Mosquitto Broker
logins: [] with:
Final Configuration Should Look Like
Step 6: Get Home Assistant IP Address
192.168.1.x)
LORA Configuration
Verify Connection
Example Voice Commands
System Updates
🔖Updating LORA
Keep your LORA system up-to-date with the latest features and improvements.
Update Process
In the Web App, go to the Update section
Read about what's included in the new update
Tick the checkbox: "I confirm I want to download and install this update"
Click the "Download Update" button
LORA will automatically download and process the updated OS
- Do NOT use LORA
- Do NOT disconnect power
- Do NOT turn off the device
- Wait patiently for the process to complete
LORA will play the launch signal when the update is complete and the system is ready
After Update
After an update, you'll need to:
- Re-enter your email and password (this is why you wrote them down!)
- Re-configure some settings
- User profiles and memories are preserved
Failed Updates
Voice Commands
🔖Using Voice Commands
Control LORA with natural voice commands by first saying the wake phrase.
Wake Phrase
Activating LORA
To activate LORA, say:
After saying "Hey LORA", you'll hear a short trigger sound indicating that LORA is listening. You can then speak your command or question.
Command Structure
Tips for Better Recognition
- Speak clearly and at a normal pace
- Wait for the trigger sound before speaking your command
- Ensure the microphone is not muted (check Control section)
- Minimize background noise when possible
- Be specific with location-based queries
Command Categories
| Category | Examples |
|---|---|
| Music & Entertainment | Play music, control playback, adjust volume |
| Weather & Time | Get weather forecasts, check current time |
| Search & Information | Search the web, get answers, translations |
| Reminders & Alarms | Set timers, create reminders, schedule alarms |
| Home Assistant Control | Control lights, temperature, smart devices |
Music & Entertainment Commands
🔖Spotify Control
Control your Spotify playback with voice commands (requires Spotify Premium and connection setup).
Playing Music
Playback Control
Volume Control
Search & Information Commands
🔖Weather Queries
Time & Date
Web Search
General Knowledge
Translations
Reminders & Alarms
Home Assistant Control Commands
🔖Smart Home Voice Control
Control your Home Assistant devices with natural voice commands (requires Home Assistant integration).
Lighting Control
Temperature Control
Device Control
Scenes & Automation
Troubleshooting
🔖Common Issues & Solutions
LORA Doesn't Respond to Voice Commands
- Check microphone status in Control section - ensure it's unmuted
- Make sure you're saying "Hey LORA" clearly
- Wait for the trigger sound before speaking your command
- Reduce background noise
- Try moving closer to LORA
- Reload LORA from the Control section
Can't Access Web App
- Ensure you're connected to the same WiFi network as LORA
- Try accessing:
https://lora.local:8501/ - Accept any HTTPS certificate warnings
- Clear your browser cache
- Try a different browser
- Restart LORA by unplugging and plugging back in
Spotify Not Working
- Verify you have Spotify Premium (required)
- Check connection status in Settings → Connect Spotify +
- Re-authorize Spotify if needed
- Reload LORA after connecting Spotify
- Make sure Spotify is not playing on another device
Home Assistant Commands Not Working
- Verify Home Assistant and LORA are on the same network
- Check device discovery in Settings → Home Assistant Connect +
- Ensure MQTT broker is configured correctly
- Verify the LORA user has admin access in Home Assistant
- Try re-entering the Home Assistant IP address
Alarms or Reminders Not Working
- Check timezone setting in Settings → Change Timezone
- Ensure timezone is set correctly for your location
- Verify alarms are visible in Portal → Time section
- Check microphone is not muted
Update Failed or LORA Unresponsive After Update
- Wait patiently - LORA should automatically restore the previous version
- Do NOT disconnect power during recovery
- If stuck for more than 30 minutes, contact support
- After recovery, avoid updating until a stable version is available
User Profile Not Recognized
- Re-register the user profile with clearer voice samples
- Speak more clearly during registration
- Ensure environment is quiet during voice recording
- Wait for system to fully process voice profile after registration
Memory Threads Not Saving
- Make sure you clicked "Save Changes" after editing
- Ensure you switched to "Editable Mode" before making changes
- Check that the user is registered in Profiles section
- Most issues can be resolved by reloading LORA from the Control section
- Keep your credentials written down for after updates
- Regularly check for stable system updates
- Ensure LORA has a stable WiFi connection
Contact Support
🔖Getting Help
If you experience any issues during setup or operation, or if LORA doesn't behave as expected, please contact our support team.
Contact Information
| Method | Details |
|---|---|
| office@loratech.io | |
| Response Time | Within 24–48 hours (Monday–Friday, CET) |
| Website | https://loratech.io |
Before Contacting Support
To help us assist you more quickly, please have the following information ready:
- Description of the issue you're experiencing
- Steps you've already taken to resolve it
- Your LORA subscription plan (Single or Duo)
- Current system version (check in Update section)
- Any error messages you've seen
- Screenshots if applicable
Common Support Topics
| Topic | Description |
|---|---|
| Setup Assistance | Help with initial configuration and network connection |
| Integration Issues | Problems with Spotify or Home Assistant connections |
| Update Problems | Failed updates or system recovery issues |
| Subscription Management | Questions about plans, billing, or account access |
| Feature Requests | Suggestions for new features or improvements |
| Technical Support | Voice recognition, device not responding, hardware issues |
Emergency Recovery
- Wait for automatic recovery if an update failed
- Do NOT disconnect power during recovery
- If unresponsive for over 1 hour, contact support immediately
- As a last resort, unplug LORA for 30 seconds and plug back in
Remote Support
For complex issues, our support team may need remote access to your LORA system using Tailscale. We will guide you through this process if needed - do not configure Tailscale on your own.
Don't hesitate to reach out if you need assistance. Our team is dedicated to ensuring you have the best experience with LORA.
Community & Resources
- Visit loratech.io for documentation and updates
- Check the troubleshooting guide before contacting support
- Keep this documentation bookmarked for quick reference