Hermes Agent on Windows

Real, working PowerShell installer and helper scripts to run Hermes Agent on Windows 10/11. Hermes Agent is the AI agent by Nous Research; this repo provides the install path, model config, and a small launcher so you can keep it running under Windows Task Scheduler (or NSSM as a service).

This is not a placeholder. The scripts:

• Detect the package manager (winget, chocolatey, scoop) and install Python 3.12
• Create a venv at %LOCALAPPDATA%\hermes\venv
• Install hermes-agent and dependencies into that venv
• Generate a default config with the recommended model
• Register a Task Scheduler entry that keeps the agent alive across reboots
• Provide a tray-friendly launcher (Start Menu shortcut)

Files

File	Purpose
install.ps1	full installer (idempotent)
uninstall.ps1	clean remove
start-agent.ps1	launch agent in current shell
update.ps1	pull latest hermes-agent and restart the scheduled task
status.ps1	check if the agent is running and report PID/port
hermes-task.xml	Task Scheduler definition (auto-restart on failure)
hermes.cmd	wrapper for cmd.exe users
README.md	this file

Quick start

Open PowerShell as Administrator and run:

# Allow local scripts (one time)
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

# Install
irm https://raw.githubusercontent.com/Carlys17/Hermes-agent-Windows-OS/main/install.ps1 | iex

Or clone and run locally:

git clone https://github.com/Carlys17/Hermes-agent-Windows-OS.git
cd Hermes-agent-Windows-OS
.\install.ps1
.\start-agent.ps1

What install does

1. Installs Python 3.12 (via winget or chocolatey)
2. Creates %LOCALAPPDATA%\hermes\venv
3. pip install hermes-agent
4. Writes %LOCALAPPDATA%\hermes\config.yaml with a default model
5. Registers Task Scheduler entry HermesAgent that runs on user logon
6. Drops a Start Menu shortcut Hermes Agent.lnk

License

MIT