[{"data":1,"prerenderedAt":1177},["ShallowReactive",2],{"blog-post-hermes-agent-desktop-app":3,"related-posts-hermes-agent-desktop-app":1154},{"id":4,"title":5,"author":6,"body":11,"category":1130,"date":1131,"description":1132,"extension":1133,"featured":1134,"hideToc":1134,"image":1135,"imageAlt":1136,"imageHeight":1136,"imageWidth":1136,"itemList":1136,"lang":1136,"meta":1137,"navigation":1138,"noindex":1134,"path":1139,"readingTime":1140,"redirected":1134,"relatedSlugs":1136,"seo":1141,"seoTitle":1142,"stem":1143,"subtitle":1136,"tags":1144,"updatedDate":1131,"__hash__":1153},"blog/blog/hermes-agent-desktop-app.md","Hermes Agent Desktop App (v0.22.7): Install, Local Models, Plugins and Fixes",{"name":7,"role":8,"avatar":9,"bio":10},"Shabnam Katoch","Growth Head","/img/avatars/shabnam-profile.jpeg","Shabnam leads growth at BetterClaw and has spent the past three years building organic distribution for AI-native products. She writes about no-code agent builders, content strategy, and what it actually takes to grow without an ads budget.",{"type":12,"value":13,"toc":1099},"minimark",[14,18,30,33,39,42,47,50,53,115,123,126,130,133,140,145,152,158,176,192,195,211,218,222,229,235,238,241,276,279,285,291,301,305,311,315,318,334,337,367,370,374,377,380,387,390,403,406,410,413,416,431,434,446,450,453,456,470,473,477,480,569,572,575,578,584,590,600,604,607,610,613,655,658,663,666,672,680,684,687,741,747,846,853,859,863,871,935,941,944,962,969,987,990,993,997,1000,1006,1009,1012,1031,1035,1039,1042,1046,1057,1061,1067,1071,1074,1078,1081,1085,1088,1092,1095],[15,16,17],"p",{},"v0.22 \"Threshold\" turned Hermes into a signed desktop app with a setup chat, one-click local models and a plugin catalog that is now close to 1,000 entries. Here's how to install it on your OS, and what breaks.",[15,19,20,21,25,26,29],{},"The Hermes Agent desktop app is the native app for Nous Research's open-source agent. As of v0.22.7 (3 November 2026), Windows 11 22H2 or later installs it from the Microsoft Store or an ",[22,23,24],"code",{},".appinstaller"," file, and Apple Silicon Macs from a DMG. Intel Macs and Linux get no packaged app: install the CLI, then run ",[22,27,28],{},"hermes desktop",".",[15,31,32],{},"Picture this: it's Sunday night and you double-click the Hermes installer on your 2019 Intel MacBook Pro. It thinks for a second, then tells you it's \"not supported on this Mac\".",[15,34,35],{},[36,37,38],"em",{},"Did I download the wrong file?",[15,40,41],{},"You didn't. Since v0.22, the desktop app ships as a sealed package for exactly two kinds of machine, and everyone else takes a side door. We went through the v0.22 release notes, the repo tags and the official docs (checked 5 November 2026) so you can pick the right door the first time.",[43,44,46],"h2",{"id":45},"hermes-agent-desktop-at-a-glance-what-v0227-actually-ships","Hermes Agent desktop at a glance: what v0.22.7 actually ships",[15,48,49],{},"The big change came in v0.22.0, released on 13 October 2026 and nicknamed \"The Threshold Release\". Before it, the desktop app was something you built from source. After it, the app became a signed package that carries its own Python and Node, so first launch builds nothing.",[15,51,52],{},"v0.22.7, tagged on 3 November, is the latest stable release as we write. It rolls up about 174 merged pull requests, and Nous says the full curated notes for everything since v0.22.0 will ship with v0.23.0.",[54,55,56,69],"table",{},[57,58,59],"thead",{},[60,61,62,66],"tr",{},[63,64,65],"th",{},"Question",[63,67,68],{},"Answer at v0.22.7",[70,71,72,81,91,99,107],"tbody",{},[60,73,74,78],{},[75,76,77],"td",{},"Packaged app",[75,79,80],{},"Windows 11 22H2+ (x64, ARM64), macOS on Apple Silicon",[60,82,83,86],{},[75,84,85],{},"No packaged app",[75,87,88,89],{},"Intel Macs and Linux: CLI, then ",[22,90,28],{},[60,92,93,96],{},[75,94,95],{},"API key needed to start?",[75,97,98],{},"No. A first desktop install gets a one-time trial model",[60,100,101,104],{},[75,102,103],{},"Local models",[75,105,106],{},"Built-in llama.cpp, five-model catalog plus any GGUF",[60,108,109,112],{},[75,110,111],{},"Plugin catalog",[75,113,114],{},"975 reviewed entries (600 at v0.22.0)",[15,116,117,118,122],{},"One detail trips people up. The v0.22.3 to v0.22.7 notes all say the desktop app installed from the installer \"updates with the next bundled release\", while the Store app updates through the Store. So ",[119,120,121],"strong",{},"the version in your About panel can trail the newest tag",", and that's expected.",[15,124,125],{},"Patches have come fast: seven since 13 October, the last two on 2 and 3 November. If a CLI update stalls halfway, our guide to fixing a failed Hermes update covers the usual causes.",[43,127,129],{"id":128},"how-to-install-hermes-agent-desktop-on-windows-mac-and-linux","How to install Hermes Agent desktop on Windows, Mac and Linux",[15,131,132],{},"Find your machine below.",[15,134,135],{},[136,137],"img",{"alt":138,"src":139},"How to install Hermes Agent desktop on each OS: Windows MSIX, Apple Silicon DMG, Intel Mac and Linux via the CLI","/img/blog/hermes-agent-desktop-app-install-paths.jpg",[141,142,144],"h3",{"id":143},"windows-11-the-microsoft-store-or-the-appinstaller-file","Windows 11: the Microsoft Store or the .appinstaller file",[15,146,147,148,151],{},"You need Windows 11 22H2 or later. ",[119,149,150],{},"Windows 10 can't run the MSIX package",", even though the command-line installer supports it.",[15,153,154,155,157],{},"Both routes install the same signed package. Get it from the Microsoft Store and it updates through the Store, or download the package from the Hermes website and open the ",[22,156,24],{}," file with Windows App Installer, which records where future updates come from.",[15,159,160,161,164,165,168,169,172,173,175],{},"The package adds ",[22,162,163],{},"hermes",", ",[22,166,167],{},"hermes-agent"," and ",[22,170,171],{},"hermes-acp"," as terminal commands. If ",[22,174,163],{}," runs an older install instead, this lists every copy on your PATH:",[177,178,183],"pre",{"className":179,"code":180,"language":181,"meta":182,"style":182},"language-powershell shiki shiki-themes github-light","Get-Command hermes -All\n","powershell","",[22,184,185],{"__ignoreMap":182},[186,187,190],"span",{"class":188,"line":189},"line",1,[186,191,180],{},[15,193,194],{},"On Windows 10, or if you'd rather stay in a terminal, run the official PowerShell installer, then open the app from it:",[177,196,198],{"className":179,"code":197,"language":181,"meta":182,"style":182},"iex (irm https://hermes-agent.nousresearch.com/install.ps1)\nhermes desktop\n",[22,199,200,205],{"__ignoreMap":182},[186,201,202],{"class":188,"line":189},[186,203,204],{},"iex (irm https://hermes-agent.nousresearch.com/install.ps1)\n",[186,206,208],{"class":188,"line":207},2,[186,209,210],{},"hermes desktop\n",[15,212,213,214,217],{},"One trap: ",[22,215,216],{},"Hermes-Setup.exe"," is a different, bootstrap installer that sets up a source checkout. It isn't the self-contained MSIX.",[141,219,221],{"id":220},"macos-on-apple-silicon-the-dmg","macOS on Apple Silicon: the DMG",[15,223,224,225,228],{},"Download the DMG from the Hermes website, open it and copy ",[22,226,227],{},"Hermes.app"," to Applications. The build is signed and notarized, and it updates itself from then on.",[141,230,232,233],{"id":231},"intel-mac-cli-first-then-hermes-desktop","Intel Mac: CLI first, then ",[22,234,28],{},[15,236,237],{},"There's no Intel desktop bundle. Nous updated its platform support page on 4 November to say no release or CI workflow builds or tests one, and the macOS update feed is Apple Silicon only, so Intel Macs that installed an older bundle get no further updates.",[15,239,240],{},"The documented route is the command-line install, then the desktop command:",[177,242,246],{"className":243,"code":244,"language":245,"meta":182,"style":182},"language-bash shiki shiki-themes github-light","curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash\nhermes desktop\n","bash",[22,247,248,269],{"__ignoreMap":182},[186,249,250,254,258,262,266],{"class":188,"line":189},[186,251,253],{"class":252},"s7eDp","curl",[186,255,257],{"class":256},"sYu0t"," -fsSL",[186,259,261],{"class":260},"sYBdl"," https://hermes-agent.nousresearch.com/install.sh",[186,263,265],{"class":264},"sD7c4"," |",[186,267,268],{"class":252}," bash\n",[186,270,271,273],{"class":188,"line":207},[186,272,163],{"class":252},[186,274,275],{"class":260}," desktop\n",[15,277,278],{},"Go in with open eyes. The installation guide calls macOS on Intel processors \"not a supported platform\", so this path is what the docs offer, not a promise anyone will fix it first when it breaks.",[141,280,282,283],{"id":281},"linux-the-install-script-then-hermes-desktop","Linux: the install script, then ",[22,284,28],{},[15,286,287,288,290],{},"Linux is a Tier 1 platform for the agent, but desktop packaging is switched off in the release workflow. So you run the same install.sh one-liner as above, then ",[22,289,28],{},", which installs the Node dependencies, builds the Electron app for your machine and launches it.",[15,292,293,294,296,297,300],{},"One Ubuntu gotcha. On 23.10 and later, an AppArmor setting blocks Chromium's sandbox, so ",[22,295,28],{}," uses Chromium's setuid helper instead and asks for ",[22,298,299],{},"sudo"," again after each rebuild. The docs call that the recommended route, so don't treat it as a fault.",[141,302,304],{"id":303},"already-run-the-cli-one-command","Already run the CLI? One command",[15,306,307,308,310],{},"If Hermes already lives in your terminal, ",[22,309,28],{}," opens the app with your existing config, keys, sessions and skills. Same agent, new window.",[141,312,314],{"id":313},"prefer-ollama-let-it-drive","Prefer Ollama? Let it drive",[15,316,317],{},"Ollama's own docs offer a one-liner that installs the Hermes CLI if it's missing, lets you pick an Ollama model, points Hermes at it and opens the app:",[177,319,321],{"className":243,"code":320,"language":245,"meta":182,"style":182},"ollama launch hermes-desktop\n",[22,322,323],{"__ignoreMap":182},[186,324,325,328,331],{"class":188,"line":189},[186,326,327],{"class":252},"ollama",[186,329,330],{"class":260}," launch",[186,332,333],{"class":260}," hermes-desktop\n",[15,335,336],{},"To skip the picker and name the model up front:",[177,338,340],{"className":243,"code":339,"language":245,"meta":182,"style":182},"ollama launch hermes-desktop --model \u003Cmodel>\n",[22,341,342],{"__ignoreMap":182},[186,343,344,346,348,351,354,357,360,364],{"class":188,"line":189},[186,345,327],{"class":252},[186,347,330],{"class":260},[186,349,350],{"class":260}," hermes-desktop",[186,352,353],{"class":256}," --model",[186,355,356],{"class":264}," \u003C",[186,358,359],{"class":260},"mode",[186,361,363],{"class":362},"sgsFI","l",[186,365,366],{"class":264},">\n",[15,368,369],{},"If the install itself fights you (PATH problems, Python errors, a script that stops halfway), our guide to Hermes Agent installation errors walks through the usual suspects.",[43,371,373],{"id":372},"first-launch-a-setup-chat-that-runs-before-you-own-a-key","First launch: a setup chat that runs before you own a key",[15,375,376],{},"Open the app on a computer that has never run Hermes and you don't get a settings screen. You get a chat.",[15,378,379],{},"One card at a time, it asks your name, an accent colour and a layout, which apps to connect and which plugins to install. Then it gives a short tour and suggests up to four first tasks. The layout choice matters more than it looks: per the docs, Basic starts the app in Simple mode and Elite in Advanced.",[15,381,382,383,386],{},"The chat runs on ",[22,384,385],{},"nous/welcome",", a trial model Nous gives a first desktop install once per OS user. The CLI, TUI and gateway don't get it. It's a guided first five minutes, not a model you can live on.",[15,388,389],{},"Three controls worth knowing:",[391,392,393,397,400],"ul",{},[394,395,396],"li",{},"\"Choose provider later\" skips provider setup and drops you straight into the app.",[394,398,399],{},"\"Skip setup\" ends the chat, and Settings → Run onboarding again brings it back.",[394,401,402],{},"\"Run models locally\" sends you to the local runtime from inside onboarding.",[15,404,405],{},"Ready to bring your own key? Settings → Providers holds API keys, OAuth sign-ins and custom endpoints.",[43,407,409],{"id":408},"running-a-local-model-in-hermes-agent-desktop-no-api-key","Running a local model in Hermes Agent desktop (no API key)",[15,411,412],{},"This is the feature that makes v0.22 feel different. Hermes downloads and maintains llama.cpp itself, picks the engine for your hardware (CPU, CUDA, Metal, Vulkan or ROCm) and starts and stops the server with the app.",[15,414,415],{},"The flow, per the Local Models docs:",[417,418,419,422,425,428],"ol",{},[394,420,421],{},"Open Settings → Providers → Local Models.",[394,423,424],{},"Click Install runtime. Hermes fetches the official llama.cpp build for your hardware (a few hundred MB) and verifies it.",[394,426,427],{},"Pick a model and click Download.",[394,429,430],{},"Click Use, and new chats run on your machine.",[15,432,433],{},"In a terminal, the same setup sits under \"Local models\" in the model picker:",[177,435,437],{"className":243,"code":436,"language":245,"meta":182,"style":182},"hermes model\n",[22,438,439],{"__ignoreMap":182},[186,440,441,443],{"class":188,"line":189},[186,442,163],{"class":252},[186,444,445],{"class":260}," model\n",[141,447,449],{"id":448},"how-hermes-decides-what-fits","How Hermes decides what fits",[15,451,452],{},"Every catalog row is rated against your machine before you download a byte. Green fits in GPU memory, amber spills into system RAM and runs slower, red is too big.",[15,454,455],{},"The rules behind the rating, from the docs:",[391,457,458,461,464,467],{},[394,459,460],{},"It recommends the best model that runs fully in GPU or unified memory at a predicted 20 tokens per second or more.",[394,462,463],{},"It never offers builds below 4-bit, because the quality loss is too severe.",[394,465,466],{},"Every recommended model gets at least a 64K context window, which grows as the chat needs it.",[394,468,469],{},"Idle models unload after 15 minutes and reload on your next message.",[15,471,472],{},"If a model you add yourself complains about its window, our guide to the Hermes context length error explains what Hermes expects.",[141,474,476],{"id":475},"the-five-model-catalog-and-what-each-one-weighs","The five-model catalog, and what each one weighs",[15,478,479],{},"At v0.22.0 the catalog had four models. Nemotron 3.5 Bolt joined in the v0.22.3 window, so there are five now. The sizes below are the main weights file of each catalog build, read from Hermes's own catalog file at the v0.22.7 tag.",[54,481,482,498],{},[57,483,484],{},[60,485,486,489,492,495],{},[63,487,488],{},"Model",[63,490,491],{},"Catalog build",[63,493,494],{},"Weights download",[63,496,497],{},"Catalog note",[70,499,500,514,528,541,555],{},[60,501,502,505,508,511],{},[75,503,504],{},"Qwen3.8 27B",[75,506,507],{},"4-bit (UD-Q4_K_M)",[75,509,510],{},"16.5 GB",[75,512,513],{},"\"Best all-round agent model\"",[60,515,516,519,522,525],{},[75,517,518],{},"Nemotron 3.5 Bolt (74B MoE)",[75,520,521],{},"2-bit (IQ2)",[75,523,524],{},"22.0 GB",[75,526,527],{},"Never auto-recommended",[60,529,530,533,535,538],{},[75,531,532],{},"Qwen3.6 35B-A3B",[75,534,507],{},[75,536,537],{},"22.7 GB",[75,539,540],{},"Marked validated",[60,542,543,546,549,552],{},[75,544,545],{},"Qwen3.8 Flash Next",[75,547,548],{},"4-bit (UD-IQ4_XS)",[75,550,551],{},"93.7 GB",[75,553,554],{},"Fits 128 GB machines",[60,556,557,560,563,566],{},[75,558,559],{},"DeepSeek V4 Flash",[75,561,562],{},"4-bit (UD-Q4_K_XL)",[75,564,565],{},"155.1 GB",[75,567,568],{},"For 128GB+ memory",[15,570,571],{},"Here's the weird part. Bolt is a 2-bit build, which sits outside the docs' own 4-bit floor, and the catalog marks it so the recommender never picks it. It's there if you choose it, and only then.",[15,573,574],{},"Some builds also pull a vision file of about 1 to 2 GB, and some a draft model (DeepSeek's alone is 10.9 GB). Our advice: let the fit check choose and start with the model it stars.",[15,576,577],{},"Already running llama-server, Ollama or LM Studio? Hermes detects a running llama-server, LM Studio has a provider profile, and any OpenAI-compatible server works as a custom endpoint.",[15,579,580],{},[136,581],{"alt":582,"src":583},"Hermes Agent desktop local model catalog at v0.22.7: five models with weights download sizes","/img/blog/hermes-agent-desktop-app-local-model-catalog.jpg",[585,586,587],"blockquote",{},[15,588,589],{},"Local models in Hermes are a four-click job now. The hard part moved from setup to choosing a model your hardware can actually carry.",[15,591,592,593],{},"Still, every one of those clicks happens on a machine you maintain. If you'd rather have the agent live in the cloud and borrow your local models only when you want them, BetterClaw Desktop connects Ollama, LM Studio or llama.cpp on your computer to agents that live in the cloud. ",[594,595,599],"a",{"href":596,"rel":597},"https://app.betterclaw.io/signup",[598],"nofollow","Start your agent in 60 seconds",[43,601,603],{"id":602},"the-plugin-catalog-975-entries-and-one-sentence-to-take-seriously","The plugin catalog: 975 entries and one sentence to take seriously",[15,605,606],{},"The catalog launched with 600 entries in v0.22.0. At the v0.22.7 tag, its folder holds 975.",[15,608,609],{},"Every entry lands through a pull request a maintainer reviews, pins one exact 40-character commit and is scanned at admission. Memory providers such as Honcho, Supermemory, Hindsight and Mem0 moved into it in v0.22.0, along with Home Assistant, Spotify and Langfuse.",[15,611,612],{},"Install by name from the CLI, or with one click in the app:",[177,614,616],{"className":243,"code":615,"language":245,"meta":182,"style":182},"hermes plugins install \u003Cname>\nhermes plugins enable \u003Cname>\n",[22,617,618,638],{"__ignoreMap":182},[186,619,620,622,625,628,630,633,636],{"class":188,"line":189},[186,621,163],{"class":252},[186,623,624],{"class":260}," plugins",[186,626,627],{"class":260}," install",[186,629,356],{"class":264},[186,631,632],{"class":260},"nam",[186,634,635],{"class":362},"e",[186,637,366],{"class":264},[186,639,640,642,644,647,649,651,653],{"class":188,"line":207},[186,641,163],{"class":252},[186,643,624],{"class":260},[186,645,646],{"class":260}," enable",[186,648,356],{"class":264},[186,650,632],{"class":260},[186,652,635],{"class":362},[186,654,366],{"class":264},[15,656,657],{},"Now the sentence. The catalog's own page says a listing \"is not a security audit, and it says nothing about other commits in the same repository.\" The desktop docs go further: a desktop plugin is not sandboxed and \"runs inside the app with the app's own authority\".",[585,659,660],{},[15,661,662],{},"A reviewed pin tells you which code you're getting. It doesn't tell you that code is safe near your keys.",[15,664,665],{},"So treat a desktop plugin like a browser extension with your password manager unlocked. Read the capability summary the install prompt shows (tools, hooks, environment variables) before you say yes, and hand credentials only to plugins whose code you've read.",[15,667,668],{},[136,669],{"alt":670,"src":671},"Hermes Agent desktop plugin catalog trust model: reviewed, pinned and scanned, but not sandboxed","/img/blog/hermes-agent-desktop-app-plugin-trust.jpg",[15,673,674,675,679],{},"The same lesson applies on the OpenClaw side. Our ",[594,676,678],{"href":677},"/blog/clawhub-skills-security-audit","ClawHub skills security audit"," shows what can hide inside a marketplace listing that looks perfectly ordinary.",[43,681,683],{"id":682},"desktop-cli-or-remote-gateway-which-should-you-run","Desktop, CLI or remote gateway: which should you run?",[15,685,686],{},"They're one agent with three faces. The desktop docs are explicit: same config, same keys, same sessions, same memory, so you can start a chat in one and finish it in another.",[54,688,689,702],{},[57,690,691],{},[60,692,693,696,699],{},[63,694,695],{},"Setup",[63,697,698],{},"Best for",[63,700,701],{},"Watch out for",[70,703,704,715,726],{},[60,705,706,709,712],{},[75,707,708],{},"Desktop app, local backend",[75,710,711],{},"Founders, anyone who wants a UI",[75,713,714],{},"Plugins run with the app's authority",[60,716,717,720,723],{},[75,718,719],{},"CLI or TUI",[75,721,722],{},"Developers, SSH sessions, servers",[75,724,725],{},"No trial model: bring a key or a local model",[60,727,728,731,734],{},[75,729,730],{},"Desktop on a remote gateway",[75,732,733],{},"An always-on VPS or home server",[75,735,736,737,740],{},"You keep ",[22,738,739],{},"hermes serve"," running yourself",[15,742,743,744,746],{},"The remote option points the app at a ",[22,745,739],{}," backend under Settings → Gateways → Remote gateway. On the remote machine, the docs' trusted-network recipe sets a dashboard login, then binds the backend to a reachable address:",[177,748,750],{"className":243,"code":749,"language":245,"meta":182,"style":182},"cat >> ~/.hermes/.env \u003C\u003C'EOF'\nHERMES_DASHBOARD_BASIC_AUTH_USERNAME=admin\nHERMES_DASHBOARD_BASIC_AUTH_PASSWORD=choose-a-strong-password\nEOF\necho \"HERMES_DASHBOARD_BASIC_AUTH_SECRET=$(openssl rand -base64 32)\" >> ~/.hermes/.env\nchmod 600 ~/.hermes/.env\nhermes serve --host 0.0.0.0 --port 9119\n",[22,751,752,769,774,780,786,815,826],{"__ignoreMap":182},[186,753,754,757,760,763,766],{"class":188,"line":189},[186,755,756],{"class":252},"cat",[186,758,759],{"class":264}," >>",[186,761,762],{"class":260}," ~/.hermes/.env",[186,764,765],{"class":264}," \u003C\u003C",[186,767,768],{"class":260},"'EOF'\n",[186,770,771],{"class":188,"line":207},[186,772,773],{"class":260},"HERMES_DASHBOARD_BASIC_AUTH_USERNAME=admin\n",[186,775,777],{"class":188,"line":776},3,[186,778,779],{"class":260},"HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=choose-a-strong-password\n",[186,781,783],{"class":188,"line":782},4,[186,784,785],{"class":260},"EOF\n",[186,787,789,792,795,798,801,804,807,810,812],{"class":188,"line":788},5,[186,790,791],{"class":256},"echo",[186,793,794],{"class":260}," \"HERMES_DASHBOARD_BASIC_AUTH_SECRET=$(",[186,796,797],{"class":252},"openssl",[186,799,800],{"class":260}," rand ",[186,802,803],{"class":256},"-base64",[186,805,806],{"class":256}," 32",[186,808,809],{"class":260},")\"",[186,811,759],{"class":264},[186,813,814],{"class":260}," ~/.hermes/.env\n",[186,816,818,821,824],{"class":188,"line":817},6,[186,819,820],{"class":252},"chmod",[186,822,823],{"class":256}," 600",[186,825,814],{"class":260},[186,827,829,831,834,837,840,843],{"class":188,"line":828},7,[186,830,163],{"class":252},[186,832,833],{"class":260}," serve",[186,835,836],{"class":256}," --host",[186,838,839],{"class":256}," 0.0.0.0",[186,841,842],{"class":256}," --port",[186,844,845],{"class":256}," 9119\n",[15,847,848,849,852],{},"Then enter ",[22,850,851],{},"http://\u003Cbackend-host>:9119"," as the Remote URL in the app and sign in. That login is meant for a trusted LAN or a VPN such as Tailscale; for anything reachable from the internet, the docs tell you to use OAuth through Nous Portal instead.",[15,854,855,858],{},[119,856,857],{},"Never put a password-only backend on the open internet."," It reads your keys and runs agent commands.",[43,860,862],{"id":861},"hermes-agent-desktop-not-working-the-fixes-wed-try-first","Hermes Agent desktop not working? The fixes we'd try first",[15,864,865,866,870],{},"Most desktop trouble falls into a handful of buckets, and several were fixed in the 0.22 patches. So check your version before you debug anything, and for problems outside the app itself, our ",[594,867,869],{"href":868},"/blog/hermes-agent-not-working","Hermes Agent not working"," guide is the long version.",[54,872,873,883],{},[57,874,875],{},[60,876,877,880],{},[63,878,879],{},"Symptom",[63,881,882],{},"What to do",[70,884,885,893,901,908,916,927],{},[60,886,887,890],{},[75,888,889],{},"Store app stuck on \"Connecting\"",[75,891,892],{},"Update past 0.22.1; 0.22.2 replaced it",[60,894,895,898],{},[75,896,897],{},"Supervised gateway won't start after a reboot",[75,899,900],{},"Fixed in 0.22.2",[60,902,903,906],{},[75,904,905],{},"Long local turns die after the laptop sleeps",[75,907,900],{},[60,909,910,913],{},[75,911,912],{},"Chat frozen while the status says Connected",[75,914,915],{},"Status bar gateway menu, then Reconnect gateway",[60,917,918,924],{},[75,919,920,921],{},"App gone after ",[22,922,923],{},"hermes update",[75,925,926],{},"Rebuild it with the command below",[60,928,929,932],{},[75,930,931],{},"Can't delete sessions from 0.22.1",[75,933,934],{},"Known issue listed in 0.22.2",[15,936,937],{},[136,938],{"alt":939,"src":940},"Hermes Agent desktop not working: common symptoms mapped to the fix or the release that fixed them","/img/blog/hermes-agent-desktop-app-troubleshooting.jpg",[15,942,943],{},"If the app vanished after an update, the docs give one command to rebuild it by hand:",[177,945,947],{"className":243,"code":946,"language":245,"meta":182,"style":182},"hermes desktop --build-only --force-build\n",[22,948,949],{"__ignoreMap":182},[186,950,951,953,956,959],{"class":188,"line":189},[186,952,163],{"class":252},[186,954,955],{"class":260}," desktop",[186,957,958],{"class":256}," --build-only",[186,960,961],{"class":256}," --force-build\n",[15,963,964,965,968],{},"If the backend keeps dying, read ",[22,966,967],{},"HERMES_HOME/logs/desktop.log"," first. It records the exit code and the backend's last output, and you can follow it live:",[177,970,972],{"className":243,"code":971,"language":245,"meta":182,"style":182},"hermes logs gui -f\n",[22,973,974],{"__ignoreMap":182},[186,975,976,978,981,984],{"class":188,"line":189},[186,977,163],{"class":252},[186,979,980],{"class":260}," logs",[186,982,983],{"class":260}," gui",[186,985,986],{"class":256}," -f\n",[15,988,989],{},"After three crashes within two minutes, Desktop stops restarting the backend and shows a \"keeps crashing\" notice instead. Fix what the traceback says, then relaunch.",[15,991,992],{},"When a single turn fails, the error card names the layer that broke (provider, auth, gateway, local runtime and so on). Read it before you blame the model.",[43,994,996],{"id":995},"when-self-hosting-hermes-isnt-worth-your-weekend","When self-hosting Hermes isn't worth your weekend",[15,998,999],{},"v0.22 is the easiest Hermes has ever been to install: signed packages, a setup chat, local models in four clicks.",[15,1001,1002,1003,1005],{},"But you still own the box. You pick the update channel, you read the plugin code, you keep ",[22,1004,739],{}," alive if you go remote, and when the gateway won't start at 2 AM, it's your terminal.",[15,1007,1008],{},"If that sounds like fun, Hermes is a great project to run.",[15,1010,1011],{},"Nous named this release after a threshold, and it fits. The door is wider than it has ever been, but it's still a door you hold open yourself, every patch. If you'd rather not, our Hermes vs BetterClaw comparison lays the trade-offs side by side.",[1013,1014,1016,1021,1024],"callout",{"type":1015},"cta",[15,1017,1018],{},[119,1019,1020],{},"Run the agent, skip the maintenance",[15,1022,1023],{},"BetterClaw runs your agents in the cloud, so there's no app bundle to match to your OS and no gateway to restart after a reboot. You bring your own keys across 28+ providers with zero markup, connect 500+ apps, and add BetterClaw Desktop when you want local models in the mix.",[15,1025,1026,1027],{},"Plans start at $19 a month on Starter. Pro is $49 a month ($39 billed annually), Business $149 a month, and Enterprise is custom, all with a 7-day free trial. ",[594,1028,1030],{"href":596,"rel":1029},[598],"Build your agent in BetterClaw",[43,1032,1034],{"id":1033},"frequently-asked-questions","Frequently Asked Questions",[141,1036,1038],{"id":1037},"what-is-hermes-agent-desktop","What is Hermes Agent desktop?",[15,1040,1041],{},"It's the native app for Hermes Agent, the MIT-licensed agent from Nous Research. It drives the same agent as the CLI, with the same config, keys and sessions, and since v0.22 it ships as a signed package for Windows 11 and Apple Silicon Macs.",[141,1043,1045],{"id":1044},"how-do-i-install-the-hermes-agent-desktop-app","How do I install the Hermes Agent desktop app?",[15,1047,1048,1049,1051,1052,1054,1055,29],{},"Windows 11 22H2 or later: the Microsoft Store, or the ",[22,1050,24],{}," file. Apple Silicon Mac: copy ",[22,1053,227],{}," from the DMG to Applications. Intel Mac or Linux: install the CLI with the official script, then run ",[22,1056,28],{},[141,1058,1060],{"id":1059},"does-hermes-desktop-work-on-intel-macs","Does Hermes Desktop work on Intel Macs?",[15,1062,1063,1064,1066],{},"Not as a packaged app: no Intel bundle is built, and the installer reports \"not supported on this Mac\". The docs' route is the CLI plus ",[22,1065,28],{},", though the installation guide calls Intel macOS \"not a supported platform\".",[141,1068,1070],{"id":1069},"can-hermes-agent-desktop-run-a-local-model-without-an-api-key","Can Hermes Agent desktop run a local model without an API key?",[15,1072,1073],{},"Yes. Settings → Providers → Local Models installs a llama.cpp runtime, rates five catalog models against your hardware and downloads the one you pick. Nothing leaves your machine once the model is downloaded.",[141,1075,1077],{"id":1076},"hermes-desktop-or-cli-which-is-better","Hermes desktop or CLI: which is better?",[15,1079,1080],{},"Neither, because they share one agent and one config. Pick the desktop app for a UI, onboarding and one-click local models, and the CLI for servers, SSH and scripts; you can switch mid-conversation.",[141,1082,1084],{"id":1083},"how-much-does-hermes-agent-desktop-cost","How much does Hermes Agent desktop cost?",[15,1086,1087],{},"The app and agent are open source under the MIT licence, so there's no licence fee. You pay for the model provider you connect, unless you run a local model on your own hardware.",[141,1089,1091],{"id":1090},"are-hermes-plugins-safe","Are Hermes plugins safe?",[15,1093,1094],{},"Catalog plugins are human-reviewed, pinned to one commit and scanned at admission, but the catalog says a listing \"is not a security audit\". Desktop plugins aren't sandboxed and run with the app's authority, so read the capability summary and only give credentials to code you've reviewed.",[1096,1097,1098],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}html pre.shiki code .sYu0t, html code.shiki .sYu0t{--shiki-default:#005CC5}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html pre.shiki code .sD7c4, html code.shiki .sD7c4{--shiki-default:#D73A49}html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}",{"title":182,"searchDepth":207,"depth":207,"links":1100},[1101,1102,1112,1113,1117,1118,1119,1120,1121],{"id":45,"depth":207,"text":46},{"id":128,"depth":207,"text":129,"children":1103},[1104,1105,1106,1108,1110,1111],{"id":143,"depth":776,"text":144},{"id":220,"depth":776,"text":221},{"id":231,"depth":776,"text":1107},"Intel Mac: CLI first, then hermes desktop",{"id":281,"depth":776,"text":1109},"Linux: the install script, then hermes desktop",{"id":303,"depth":776,"text":304},{"id":313,"depth":776,"text":314},{"id":372,"depth":207,"text":373},{"id":408,"depth":207,"text":409,"children":1114},[1115,1116],{"id":448,"depth":776,"text":449},{"id":475,"depth":776,"text":476},{"id":602,"depth":207,"text":603},{"id":682,"depth":207,"text":683},{"id":861,"depth":207,"text":862},{"id":995,"depth":207,"text":996},{"id":1033,"depth":207,"text":1034,"children":1122},[1123,1124,1125,1126,1127,1128,1129],{"id":1037,"depth":776,"text":1038},{"id":1044,"depth":776,"text":1045},{"id":1059,"depth":776,"text":1060},{"id":1069,"depth":776,"text":1070},{"id":1076,"depth":776,"text":1077},{"id":1083,"depth":776,"text":1084},{"id":1090,"depth":776,"text":1091},"Guides","2026-11-05","Install the Hermes Agent desktop app on Windows, Mac or Linux, run a local model with no API key, add plugins safely and fix common v0.22.7 errors.","md",false,"/img/blog/hermes-agent-desktop-app.jpg",null,{},true,"/blog/hermes-agent-desktop-app","11 min read",{"title":5,"description":1132},"Hermes Agent Desktop App (v0.22.7): Install, Models, Fixes","blog/hermes-agent-desktop-app",[1145,1146,1147,1148,1149,1150,1151,1152],"hermes agent desktop","hermes agent desktop app","hermes agent desktop download","hermes agent desktop mac","hermes agent desktop windows","hermes agent local model","hermes agent plugins","hermes agent v0.22","Ug3GEPHIJDSw2ls43_KIq6GdF0jt8N0NF4-7EFiClvY",[1155,1163,1170],{"stem":1156,"title":1157,"description":1158,"date":1159,"image":1160,"category":1130,"redirected":1134,"author":1161,"readingTime":1162},"blog/hermes-agent-claude-chatgpt-subscription","Hermes Agent With Your Claude or ChatGPT Subscription: Setup and Limits","Use your Claude Pro/Max or ChatGPT Plus subscription in Hermes Agent: how to set it up, why you hit 429 and usage limits fast, and what it really costs.","2026-10-28","/img/blog/hermes-agent-claude-chatgpt-subscription.jpg",{"name":7,"role":8,"avatar":9,"bio":10},"10 min read",{"stem":1164,"title":1165,"description":1166,"date":1159,"image":1167,"category":1168,"redirected":1134,"author":1169,"readingTime":1162},"blog/hermes-agent-keeps-stopping","Hermes Agent Keeps Stopping? How to Make It Finish the Job","Hermes stops after every reply, gets stuck or says \"goal blocked\"? Use /goal, raise the turn budget, fix timeouts and keep the gateway up. Every fix.","/img/blog/hermes-agent-keeps-stopping.jpg","Troubleshooting",{"name":7,"role":8,"avatar":9,"bio":10},{"stem":1171,"title":1172,"description":1173,"date":1159,"image":1174,"category":1130,"redirected":1134,"author":1175,"readingTime":1176},"blog/hermes-agent-memory-providers","Hermes Agent Memory Providers Compared (and How to Fix Recall)","Honcho, Hindsight, Mem0, Supermemory, Mnemosyne and more for Hermes Agent: setup, cost, local vs cloud, and how to fix memory that won","/img/blog/hermes-agent-memory-providers.jpg",{"name":7,"role":8,"avatar":9,"bio":10},"13 min read",1793972867173]