Getting Started

3 minutes to set up. After that, OpenLoomi filters the noise for you.

You’ll know it’s working when you see your first Event appear.

System Requirements

OS	Minimum Version	Processor	RAM	Disk Space
macOS	macOS 12 (Monterey) or later	Apple Silicon (M1/M2/M3/M4) or Intel	4 GB	500 MB
Windows	Windows 10 (64-bit) or later	x86_64 / AMD64	4 GB	500 MB
Linux	Ubuntu 20.04 / Debian 11 or later, or equivalent	x86_64 or ARM64	4 GB	500 MB

Network: Internet connection required for sync and messaging features.

Linux only: GTK and libnotify libraries are required (usually pre-installed on desktop Ubuntu/Debian systems).

Download

Visit https://openloomi.ai to download, or use the direct links below:

macOS

Option	Notes
Download .dmg installer (Apple Silicon)	Recommended for M1/M2/M3/M4 Macs — double-click to install
Download .dmg installer (Intel)	For Intel Macs
Homebrew	For developers — see command below


# Install via Homebrew
brew tap melandlabs/openloomi https://github.com/melandlabs/release
brew install --cask openloomi

Linux (Ubuntu/Debian)

Option	Notes
Download .deb package (x86_64)	For x86_64 / AMD64 systems
Download .deb package (ARM64)	For ARM64 systems (e.g., Raspberry Pi, ARM servers)


sudo dpkg -i openloomi_0.4.2_linux_amd64.deb
sudo apt-get install -f
 
# Fix resource path (required for v0.4.2 and earlier)
sudo ln -sf /usr/lib/openloomi/_up_ /usr/bin/_up_
 
# Start the application
openloomi

Note: The symlink above is needed because of a known packaging issue where the binary looks for resources in /usr/bin/_up_ instead of /usr/lib/openloomi/_up_. This will be fixed in a future release.

Windows

Option	Notes
Download .exe installer	Recommended — run the installer to set up OpenLoomi
Winget	Coming Soon

Windows SmartScreen: If Windows shows a warning when running the installer, click “More info” then “Run anyway”. This is normal — OpenLoomi is open-source and the code is publicly verifiable. You only need to do this once per machine.

“Unable to Find Entry Point” / GetSystemTimePreciseAsFileTime error: If you see an error about GetSystemTimePreciseAsFileTime not being found in kernel32.dll, your Windows version is too old. OpenLoomi requires Windows 10 (build 1607 or later) or Windows 11. Windows XP, Vista, 7, and 8/8.1 are not supported. To check your version, press Win + R, type winver, and press Enter — or go to Settings > System > About.

View all releases →

Permissions

When you first launch OpenLoomi, the system will ask for a few permissions. Each one has a specific purpose — and you can decline any of them. OpenLoomi will continue to work; you’ll just lose the feature that requires that permission.

macOS

Permission	What it lets OpenLoomi do	Can I decline?
Full Disk Access	Read your iMessage history from the local database so OpenLoomi can surface important conversations in your Event feed	Yes — iMessage sync will be skipped
Automation	Send iMessages on your behalf when you ask OpenLoomi to reply or notify someone	Yes — you’ll receive drafts instead of automatic sends
Notifications	Push alerts when important events are detected (urgent emails, mentions, deadlines)	Yes — check the app manually instead

How to grant or revoke:

Open System Settings → Privacy & Security
Find the permission category (e.g., Full Disk Access, Automation, Notifications)
Toggle OpenLoomi on or off

You can revisit these settings at any time.

Windows

Permission	What it lets OpenLoomi do	Can I decline?
Notifications	Push alerts when important events are detected (urgent emails, mentions, deadlines)	Yes — check the app manually instead

Windows SmartScreen may also show a one-time warning when running the installer. Click “More info” then “Run anyway” — this is normal for open-source software. You only need to do this once per machine.

Linux

No special permissions are required on Linux. OpenLoomi uses the standard desktop notification system (libnotify) to send alerts if you have granted notification permissions to other apps, OpenLoomi will automatically use them too.

What to do next

Here’s how to go from set up to seeing real value with your AI Mates:

Day 1 — Explore your AI Mates

Wait for the first index to complete (~5 minutes)
Open your Mate list and review what each pre-selected Mate is set to do
Click into one Mate and check the Events it’s already pulling in
Add a new Mate from the marketplace — pick one that matches a workflow you do manually today

Days 2–3 — Customize and observe

Adjust a Mate’s instructions to fit your specific needs
Set a schedule — some Mates work best on a daily or weekly cadence
Connect a source (Slack, Telegram, or email) and watch your Mate react to real data

Days 4–7 — Expand and collaborate

Recruit more Mates to cover additional workflows
Set up the first automated action — draft a message, schedule a reminder, or trigger a notification