Portable Agents Hub
AbuZar-Ansarii/Portable-Agents
USB-ready, self-contained workspaces for Hermes Agent and OpenClaw on Windows, macOS and Linux
Portable Agents Hub is a collection of launcher scripts and workspaces that run Hermes Agent, OpenClaw and OpenClaude from a USB drive or external SSD without installing anything on the host computer.
What Portable Agents Hub does
The Hermes launchers, hermes.bat for Windows and hermes.sh for macOS and Linux, set up an isolated workspace. On first run the scripts download Python 3.11 and Node.js 22 into a local cache under Hermes/.cache/runtimes, create a virtual environment with uv, and clone and install Hermes. They set HERMES_HOME to the data folder next to the launcher, so API keys, history, skills and memories stay on the drive, and they prepend the downloaded binaries to PATH for the session only.
Provider keys such as OpenRouter, OpenAI and Anthropic go in Hermes/data/.env, or can be entered through a terminal menu option. The same layout is used for an OpenClaw workspace, with a menu for model setup, console chat, a web dashboard and Telegram pairing, and for an OpenClaude coding agent. Copying the drive between computers carries settings and memories with it.
Key features
- Launchers for Windows (.bat) and macOS or Linux (.sh)
- Python 3.11 and Node.js 22 downloaded into a local cache, with no host installs
- HERMES_HOME redirected to a data folder so keys, history, skills and memories stay on the drive
- Interactive terminal menu for provider setup
- Parallel workspaces for OpenClaw and OpenClaude
When to use it
- Carrying a Hermes setup between computers on a USB stick
- Trying Hermes on a machine where you cannot install Python or Node.js
- Keeping agent state and API keys off the host computer
Who it is for: Users who want to run Hermes Agent or OpenClaw from removable storage without touching the host system.
How it fits with Hermes Agent
Supports Hermes Agent alongside OpenClaw and OpenClaude, with a dedicated Hermes launcher and data folder.
How to install Portable Agents Hub
These commands are copied from the project's README. Check the repository for the latest steps before you run them.
chmod +x hermes.sh
./hermes.shRequirements: A USB drive or external SSD; the first run downloads Python 3.11 and Node.js 22 into a local cache
FAQ
What is Portable Agents Hub?
Portable Agents Hub is a repository of launcher scripts and workspaces that run Hermes Agent, OpenClaw and OpenClaude from a USB drive. Each agent keeps its runtimes and data inside its own folder.
Does Portable Agents Hub work with Hermes Agent?
Yes, Hermes Agent has its own launchers, hermes.bat and hermes.sh. They install Hermes into the drive's Hermes folder and store its state in Hermes/data.
Is Portable Agents Hub free and open source?
The repository has no license file, so default copyright applies and you should check with the author before reuse.
Similar deployment for Hermes Agent
All deploymentScripted setup that turns a used mini PC into an always-on Hermes Agent server with n8n, Pi-hole and backups
carterwayneskhizeine Hermes Agent Windows ForkWindows-native fork of Hermes Agent 0.13.0 with path, process and terminal fixes, no WSL required
tecno-consultores llm-labDocker Compose stack with profiles for n8n, Open WebUI, Ollama, Qdrant, OpenCode and Hermes Agent
JackTheGit Hermes Autonomous Server GuideGuide to running Hermes Agent headless on a Linux server with a systemd gateway and cron jobs
catamsp Hermes Agent for Termux (proot-distro)Installer scripts that run Hermes Agent on Android inside Termux using a proot-distro Debian or Ubuntu
JiaDe-Wu Hermes Agent on AWS with BedrockOne-click CloudFormation deployment of Hermes Agent on AWS using Amazon Bedrock and IAM authentication
Related guides: How to run Hermes Agent securely · How to install Hermes Agent · Connect Hermes agents on several machines with Hermes Desktop