Windows Desktop Port — A standalone, self-hosted AI workspace for chat, agents, research, documents, email, notes, calendar, and local model workflows.

Features · Download · Quick Start · Building · Main Project

---

About

This is the Windows desktop port of Odysseus — a self-hosted AI workspace. It packages the web UI into a native Windows application with system tray integration, single-instance locking, automatic updates, and a portable installer.

The core Odysseus project is developed at github.com/odysseus-dev/odysseus. This fork maintains the Windows-specific packaging and distribution.

---

Features

• Desktop Experience — Native Windows window (Edge Chromium via pywebview) with minimize-to-tray
• System Tray — Background operation with tray menu (Open, Launch on Startup, Check for Updates, Exit)
• Single Instance — Named mutex prevents duplicate launches; second instance brings the first to front
• Dynamic Port — Automatically finds an available port if the default (7000) is in use
• Auto-Updater — Checks both your fork and upstream for new releases every 12 hours
• Clean Shutdown — Graceful subprocess termination on exit
• Inno Setup Installer — ~65 MB installer, ~195 MB installed (single-file setup, no admin required)

---

Download

Get the latest installer from the Releases page.

Requirements: Windows 10+, 64-bit, 4 GB+ RAM recommended.

---

Quick Start

1. Download OdysseusSetup-1.0.6.exe from Releases
2. Run the installer — Odysseus starts automatically after installation
3. The app icon appears in your system tray
4. Click Open Odysseus from the tray to launch the window
5. Complete the initial setup wizard in the browser

The server runs in the background even when the window is closed. To fully quit, select Exit from the tray menu.

---

Building

Prerequisites

• Python 3.11+
• Node.js 18+
• Inno Setup 6+ (for installer)

Setup

git clone https://github.com/Pant0x/odysseus-windows-app.git
cd odysseus-windows-app
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Build Portable EXE + Installer

.\build-windows-portable.ps1

Outputs:

• dist\Odysseus\Odysseus.exe — portable standalone EXE
• dist\OdysseusSetup-1.0.6.exe — Inno Setup installer

Development Mode

python launcher.py

Opens at http://127.0.0.1:7000. Hot-reload is available for frontend changes.

---

Configuration

Environment Variable	Default	Description
APP_BIND	127.0.0.1	Server bind address
APP_PORT	7000	Preferred server port
ODYSSEUS_UPDATE_REPO	(optional)	Your GitHub fork for update checks (owner/repo)
ODYSSEUS_VERSION	1.0.6	Current version tag

---

Credits

• Odysseus — the original AI workspace project
• pywebview — native GUI window
• pystray — system tray integration

---