# Use your own AI model on Omarchy with Hermes

Omarchy is the Linux desktop. Hermes is the agent that can read files and run tools. The model supplies the reasoning behind those actions. In this test Hermes ran in a Try Omarchy guest on a Mac, while Qwen3 ran in Ollama on the Mac itself.

[HTML](https://lukejbyrne.com/library/guides/3hlexifriio/)
Content language: en
Author: Luke Byrne
Video published: null
Guide published: 2026-11-18

[Watch the video](https://www.youtube.com/watch?v=3hLeXiFrIio)
Video language: English

## Install Hermes

1. In Omarchy, open Super + Space → Install → AI → Hermes Desktop. Complete the installer. On first launch, select a supported hosted provider and authenticate, or choose to add a provider later if following the local route.
2. Send a short hello and check that a fresh chat answers before changing your default agent.

## Connect the local model

The recorded setup used Settings → Providers → Custom Endpoints in Hermes Desktop.

Both apps on the same Linux machine: the usual base URL is `http://localhost:11434/v1`.

In the recorded Try Omarchy guest: the guest reached the Mac at `http://10.0.2.2:11434/v1`.

The second address is a fact about this guest, not a universal Mac address. Inside a guest, localhost points back at the guest. Use the address that actually reaches your own Ollama host.

## Match the context settings

The tested qwen3:4b model was configured for 32,768 tokens. This Hermes build rejected values below 64,000. On the Mac, the operator saved this as a file named Modelfile:

FROM qwen3:4b
PARAMETER num_ctx 65536

Then ran:

ollama create hermes-qwen3-64k -f Modelfile

1. In Hermes, select hermes-qwen3-64k:latest, set Context to 65536, and open a fresh chat. The recorded run returned “Hello!”. These settings solve the mismatch observed in this build; they are not a promise that every machine can comfortably run a 64K context.

## Make Hermes your default agent

In a normal Omarchy terminal:

omarchy default agent hermes

Open a terminal in your project folder and run:

a

Check that the project path in Hermes matches the folder you intended. Super + Shift + Ctrl + A opens the default agent elsewhere on the desktop. The menu route varies by build: the recording also used Setup → Defaults → Agent, and the script notes that a main-menu Agent entry may offer Harness.

The recorded session opened with command approvals bypassed. Check your own approval setting before using it on a project; the shortcut does not establish what actions the model should be allowed to take.

## The actual test and recovery

On the first attempt, Qwen omitted the tool name from its tool call, so the command never ran. The operator interrupted the attempt, ran the following in the guest, and opened a new session with a:

hermes config set tools.tool_search.enabled off

The successful request explicitly supplied:

pwd && omarchy theme set 'Tokyo Night' && omarchy theme current

The terminal and Hermes window changed theme. A separate shell check returned Tokyo Night. This establishes one successful command after a specific fix; it does not establish dependable general coding from the small model.

## Tested versions

The recorded run was on 12 November 2026:

Omarchy edge `4.0.0.r7594.g84b3f28-1`, aarch64 Try Omarchy guest.

Hermes Desktop `2026.9.7-7`.

Hermes runtime `2237be3559`.

Ollama model variant `hermes-qwen3-64k:latest`, based on `qwen3:4b`.

## Sources

Omarchy AI manual (https://omarchy.org/manual/ai/)

Try Omarchy (https://github.com/omacom/try-omarchy)

Hermes Desktop (https://hermes-agent.nousresearch.com/docs/user-guide/desktop)

Hermes providers (https://hermes-agent.nousresearch.com/docs/integrations/providers)

Hermes skills (https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)

Ollama networking FAQ (https://docs.ollama.com/faq)

The links lead to the projects’ documentation. The results described come from the recorded 12 November run with the versions listed above; they do not establish the same behaviour on other configurations.

## The takeaway

Hermes lets you choose the model behind the agent. Match the endpoint and context to your setup, check a fresh reply, then test one small action. This recorded local-model run needed a tool-search fix and an explicit command before it changed the theme.

## Workflow resources

- [docs.ollama.com](https://docs.ollama.com/faq)
- [github.com](https://github.com/omacom/try-omarchy)
- [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com/docs/integrations/providers)
- [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com/docs/user-guide/desktop)
- [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)
- [omarchy.org](https://omarchy.org/manual/ai/)

## Chapters

- [0:00 Hermes on Omarchy with your own model](https://www.youtube.com/watch?v=3hLeXiFrIio&t=0s)
- [0:34 What Omarchy and Hermes are](https://www.youtube.com/watch?v=3hLeXiFrIio&t=34s)
- [1:02 The desktop app and the terminal agent](https://www.youtube.com/watch?v=3hLeXiFrIio&t=62s)
- [1:30 Install Hermes Desktop on Omarchy](https://www.youtube.com/watch?v=3hLeXiFrIio&t=90s)
- [1:54 Choose who runs the model](https://www.youtube.com/watch?v=3hLeXiFrIio&t=114s)
- [2:44 Connect a local model from Ollama](https://www.youtube.com/watch?v=3hLeXiFrIio&t=164s)
- [3:16 Fix the 64K context error](https://www.youtube.com/watch?v=3hLeXiFrIio&t=196s)
- [4:12 Make Hermes your default agent](https://www.youtube.com/watch?v=3hLeXiFrIio&t=252s)
- [4:34 Open Hermes in a project with the letter a](https://www.youtube.com/watch?v=3hLeXiFrIio&t=274s)
- [4:56 Crash diagnosis with your default agent](https://www.youtube.com/watch?v=3hLeXiFrIio&t=296s)
- [5:14 The test: switching the theme to Tokyo Night](https://www.youtube.com/watch?v=3hLeXiFrIio&t=314s)
- [5:35 Verdict](https://www.youtube.com/watch?v=3hLeXiFrIio&t=335s)

## Sources and limitations

The links lead to the projects’ documentation. The results described come from the recorded 12 November run with the versions listed above; they do not establish the same behaviour on other configurations.

[Original video](https://www.youtube.com/watch?v=3hLeXiFrIio)
