Skip to content
Aori
Blog

Desktop Setup

Overview

Section titled “Overview”

Aori on Desktop runs as a standalone application. In Desktop mode, Aori can operate as either a Chat assistant (responds when you message it) or an Agent (runs routines, sends briefings, monitors your calendar). Desktop is the recommended platform if you want to use Ollama for local models or run 24/7 routines.

Installation

Section titled “Installation”

macOS

Section titled “macOS”
1. Download the Apple Silicon `.dmg` for M-series Macs, or the Intel `.dmg` for older Macs, from the [download page](/download).
2. Open the `.dmg` and drag Aori to **Applications**.
3. Aori is notarized by Apple — double-click to launch. No right-click workaround needed.
4. Aori opens to the onboarding flow.

Windows

Section titled “Windows”
1. Download the Windows MSI installer from the [download page](/download).
2. Run the installer.
3. If SmartScreen appears for a new release, verify the download from the release page before continuing.
4. Aori installs and launches the onboarding flow.

Linux

Section titled “Linux”
1. Download the `.deb` package for Debian/Ubuntu-based distributions, or the AppImage for a portable build.
2. For `.deb`, install it with your package manager.
3. For AppImage, make it executable: `chmod +x Aori-*.AppImage`
4. Run it: `./Aori-*.AppImage` (or double-click if your file manager supports AppImage).

Initial Setup

Section titled “Initial Setup”

After installation, follow these steps to get Aori running:

  1. Add your AI provider: Go to Settings → AI Models and paste your API key.
  2. Onboarding: Follow the onboarding conversation — Aori will ask your name, how you’d like to be addressed, and your preferred communication style.
  3. Optional Channels: Connect Telegram or WhatsApp in Settings → Channels.
  4. Optional: Set up Routines from the Routines tab for proactive briefings.

Next Steps: