Getting Started

System Requirements

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

macOS

# If you have a manual installation, remove it first:
# rm -rf /Applications/openloomi.app
 
# Install via Homebrew
brew tap melandlabs/openloomi https://github.com/melandlabs/openloomi
brew install --cask openloomi
 
# Upgrade
brew upgrade --cask openloomi
 
# If install or upgrade fails with "App source is not there", clear cache and reinstall:
# rm -rf ~/Library/Caches/Homebrew/openloomi
# brew uninstall --cask openloomi
# brew install --cask openloomi

Linux (Ubuntu/Debian)

sudo dpkg -i openloomi_0.5.0_linux_amd64.deb
sudo apt-get install -f
 
# Fix resource path (required for v0.5.0 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

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

How to grant or revoke:

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

You can revisit these settings at any time.

Windows

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.

AI Configuration

OpenLoomi uses your existing AI agent configuration to work. To get started, set up your agent’s environment variables in ~/.claude/settings.json.

Default: Claude

OpenLoomi automatically detects your Claude configuration — no extra setup required if you’re already using Claude Code or Claude for Desktop.

Supported Agents

Note: OpenLoomi currently supports Claude. Additional agent support (Codex, Pi, OpenClaw, Hermes) is on the roadmap and will be available in a future release.

Configuring Your Agent

Edit ~/.claude/settings.json to customize your environment:

{
  "skipWebFetchPreflight": true,
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-auth-token-here",
    "ANTHROPIC_BASE_URL": "your-base-url-here",
    "ANTHROPIC_MODEL": "your-model-here"
  }
}

Security: Your API keys are stored locally in ~/.claude/settings.json. Always keep your settings file private.