Settings Reference

Settings Reference

Portable Hermes keeps user-editable settings in the extracted app folder and in the Hermes profile directory. Secrets belong in .env; behavior settings should use the GUI or config.yaml when available.

Release and Update Paths

• Latest release: https://github.com/aivrar/portable-hermes-agent/releases/latest
• Portable distribution update: UPDATE.bat or hermes.bat update --backup --yes
• Optional upstream Hermes check/update: ask Hermes to check first, then run update_hermes if wanted

UPDATE.bat updates the tested Portable Hermes distribution from aivrar/portable-hermes-agent.

update_hermes updates upstream Hermes from NousResearch/hermes-agent and then repairs/preserves Portable Hermes tools, launchers, docs, extension folders, and runtime paths.

These are independent update channels. Run the Portable updater first; restart Hermes after a successful upstream update. See Keeping Portable Hermes Updated for cadence, exact prompts, Git-versus-ZIP behavior, and the complete recommended sequence.

Secrets

Store API keys and tokens in .env.

Variable	Description
OPENROUTER_API_KEY	OpenRouter API key
OPENAI_API_KEY	OpenAI-compatible API key
FIRECRAWL_API_KEY	Web search and page reading
SERPER_API_KEY	Google-quality search through Serper
FAL_KEY	Image generation through FAL.ai
BROWSERBASE_API_KEY	Cloud browser automation
GITHUB_TOKEN	Higher API rate limits for GitHub-backed features

Model Settings

Setting	Description	Example
LLM_MODEL	Active model name	google/gemini-2.5-flash
OPENAI_BASE_URL	OpenAI-compatible endpoint	https://openrouter.ai/api/v1
OPENAI_API_TYPE	Provider mode when needed	openai

Extension URLs

Variable	Default	Description
TTS_SERVER_URL	http://localhost:8200	TTS server address
MUSIC_SERVER_URL	http://localhost:9150	Music server address
COMFYUI_URL	http://localhost:8188	ComfyUI address

What Is Preserved During Updates

• .hermes/
• .hermes/custom_tools/
• .hermes/extensions/
• extensions/
• python_embedded/
• Portable launchers such as START.bat, UPDATE.bat, and hermes.bat
• Portable Hermes guide/docs and custom tool files