Odysseus is a privacy-focused, self-hosted AI workspace that runs entirely on your own hardware. It provides a full-featured browser UI for chat, document analysis, deep web research, calendar sync, image generation, speech-to-text, email, and more — connecting to Ollama, LM Studio, OpenAI, Anthropic, and any OpenAI-compatible endpoint.
Nothing leaves your machine beyond the LLM API calls you explicitly configure. Your conversations, documents, uploaded files, and personal settings are stored in ~/snap/odysseus/common/app/data and persist across snap updates.
LOCAL AI
Run 'odysseus.inference-snap' to detect a Canonical inference snap (gemma4, gemma3, deepseek-r1, and others) and configure it as the Ollama-compatible backend in one step — fully offline, no API key required.
QUICK START
After installation, run:
odysseus
Then open http://localhost:7000 in your browser to reach the UI. The default port can be changed by setting ODYSSEUS_PORT in the environment or in your .env file.
CONFIGURATION
Place a .env file at ~/snap/odysseus/common/.env to set API keys, LLM hosts, and other options before starting the server. All variables from the upstream .env.example are supported; for example:
OPENAI_API_KEY=sk-... LLM_HOST=localhost ODYSSEUS_PORT=7000 ODYSSEUS_HOST=127.0.0.1
AUTH
Authentication can be enabled by setting AUTH_ENABLED=true in your .env file.
SECURITY NOTE
This tool is capable of executing code, accessing files, and interacting with external services on your behalf. Due to the nature of autonomous AI agents, we recommend installing and running this snap inside an LXD container as best practice. A container provides an extra layer of confinement, limiting the agent's reach to the container environment and reducing exposure to your host system and personal data.
lxc launch ubuntu:24.04 my-agent lxc exec my-agent -- snap install --classic odysseus
Thank you for your report. Information you provided will help us investigate further.
There was an error while sending your report. Please try again later.
Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.
Snaps are discoverable and installable from the Snap Store, an app store with an audience of millions.
On Arch Linux, snap can be installed from the Arch User Repository (AUR). The manual build process is the Arch-supported install method for AUR packages, and you’ll need the prerequisites installed before you can install any AUR package. You can then install snap with the following:
git clone https://aur.archlinux.org/snapd.git
cd snapd
makepkg -si
Once installed, the systemd unit that manages the main snap communication socket needs to be enabled:
sudo systemctl enable --now snapd.socket
If AppArmor is enabled in your system, enable the service which loads AppArmor profiles for snaps:
sudo systemctl enable --now snapd.apparmor.service
To enable classic snap support, enter the following to create a symbolic link between /var/lib/snapd/snap and /snap:
sudo ln -s /var/lib/snapd/snap /snap
Either log out and back in again, or restart your system, to ensure snap’s paths are updated correctly.
To install Odysseus, simply use the following command:
sudo snap install odysseus --candidate --classic
Browse and find snaps from the convenience of your desktop using the snap store snap.
Interested to find out more about snaps? Want to publish your own application? Visit snapcraft.io now.