██╗ ██╗███████╗██████╗ ███╗ ███╗███████╗███████╗ █████╗ ██████╗ ███████╗███╗ ██╗████████╗
██║ ██║██╔════╝██╔══██╗████╗ ████║██╔════╝██╔════╝ ██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝
███████║█████╗ ██████╔╝██╔████╔██║█████╗ ███████╗ ███████║██║ ███╗█████╗ ██╔██╗ ██║ ██║
██╔══██║██╔══╝ ██╔══██╗██║╚██╔╝██║██╔══╝ ╚════██║ ██╔══██║██║ ██║██╔══╝ ██║╚██╗██║ ██║
██║ ██║███████╗██║ ██║██║ ╚═╝ ██║███████╗███████║ ██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║
╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝╚══════╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝
If you don't have Hermes installed yet, run this first:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Ctrl+C or choose the exit/skip option (usually option 0)source ~/.bashrcsource ~/.zshrcsource ~/.config/fish/config.fish
Required for parsing the model list from Oryxen's API:
# Ubuntu/Debian sudo apt install jq # Fedora/RHEL sudo dnf install jq # macOS brew install jq
Sign up at oryxen.ai to get your API key. It should start with oryxen_.
Now that you have Hermes and jq installed, run this in your terminal:
bash -c "$(curl -sS https://www.oryxen.ai/hermes/setup_oryxen.sh)"
Or with your API key pre-set (avoids the interactive prompt):
# Replace with your actual API key export ORYXEN_API_KEY="oryxen_abc123def456" bash -c "$(curl -sS https://www.oryxen.ai/hermes/setup_oryxen.sh)"
| File | Description |
|---|---|
| setup_oryxen.sh | Automated setup script (run this) |
| README.md | Detailed setup instructions (raw markdown) |
| SKILL.md | Hermes skill documentation (install manually) |
hermes doctor to confirm everything worksThe script uses this fallback order to choose the best default model for speed, cost, and general-purpose capability:
After the script completes, verify it's working with these commands:
# List all available Oryxen models hermes model list # Test chat functionality hermes chat -q "Hello! Please confirm you're working correctly." # Check your Oryxen token balance (if you have the oryxen-token-status skill) /oryxen-tokens
This happens because the PATH update from the Hermes installer only takes effect in new shells.
source ~/.bashrcsource ~/.zshrcsource ~/.config/fish/config.fishoryxen_Test connectivity to Oryxen's API:
curl -sS https://api.oryxen.ai/v1/models
api.oryxen.ai is accessibleIf something goes seriously wrong, reset your Hermes configuration:
hermes config reset
Then run the setup script again.