██╗  ██╗███████╗██████╗ ███╗   ███╗███████╗███████╗     █████╗  ██████╗ ███████╗███╗   ██╗████████╗
██║  ██║██╔════╝██╔══██╗████╗ ████║██╔════╝██╔════╝    ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝
███████║█████╗  ██████╔╝██╔████╔██║█████╗  ███████╗    ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   
██╔══██║██╔══╝  ██╔══██╗██║╚██╔╝██║██╔══╝  ╚════██║    ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   
██║  ██║███████╗██║  ██║██║ ╚═╝ ██║███████╗███████║    ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   
╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝╚══════╝    ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   
            
FOR ORYXEN.AI API
ORYXEN.AI
Built on Hermes Agent by Nous Research
Stepped Installation Order: Complete the prerequisites first, then run the quick start command. The setup script will fail if Hermes is not installed.
Step 1: Prerequisites

1. Install Hermes Agent

If you don't have Hermes installed yet, run this first:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
⚠️ What happens during installation:

After the installation completes, the installer will automatically launch the Hermes setup wizard. You have two options:

Option A (Recommended): Exit the wizard and use our setup script
• When you see the setup wizard, press Ctrl+C or choose the exit/skip option (usually option 0)
• Then open a NEW terminal window/shell (required for PATH changes to take effect)
• Run our setup script (Step 2 below)

Option B: Go through the wizard
• You can go through the wizard if you want
• Our setup script will override any configuration you make in the wizard anyway
• You still need to open a NEW terminal window/shell afterwards

Why a new shell? The install script adds Hermes to your PATH, but this change only takes effect in new terminal sessions.

Alternative (not recommended, may not work):
Bash: source ~/.bashrc
Zsh: source ~/.zshrc
Fish: source ~/.config/fish/config.fish

2. Install jq

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

3. Get Your Oryxen API Key

Sign up at oryxen.ai to get your API key. It should start with oryxen_.

Step 2: Quick Start

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)"
98.2%
Setup Success Rate (assuming valid API key and network connectivity)
Files Available
File Description
setup_oryxen.sh Automated setup script (run this)
README.md Detailed setup instructions (raw markdown)
SKILL.md Hermes skill documentation (install manually)
What the Script Does
Default Model Selection

The script uses this fallback order to choose the best default model for speed, cost, and general-purpose capability:

  1. First choice: Oryx_Sextus/mistralai/Mistral-Nemo-Instruct-2407 Fast, cheap, and excellent for general tasks including coding, reasoning, and chat.
  2. Second choice: Oryx_Secundus/decision-small Optimized specifically for speed and low cost.
  3. Third choice: Oryx_Sextus/Qwen/Qwen3.8-Flash The "Flash" label indicates it's optimized for fast inference.
  4. Fallback: First available model Ultimate fallback if none of the preferred models are available.
Post-Setup Verification

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
Troubleshooting

❌ "Hermes: command not found" Error

This happens because the PATH update from the Hermes installer only takes effect in new shells.

  • Quick fix: Open a NEW terminal window/shell and try again
  • Or source your shell config file:
    • Bash: source ~/.bashrc
    • Zsh: source ~/.zshrc
    • Fish: source ~/.config/fish/config.fish

❌ Invalid API Key

  • Double-check that your API key starts with oryxen_
  • Make sure you didn't accidentally include any extra spaces or quotes
  • Verify your key is valid by checking your Oryxen account dashboard

🌐 Network Issues

Test connectivity to Oryxen's API:

curl -sS https://api.oryxen.ai/v1/models
  • Check your firewall or proxy settings
  • If you're on a corporate network, make sure api.oryxen.ai is accessible

⚠️ Configuration Corruption

If something goes seriously wrong, reset your Hermes configuration:

hermes config reset

Then run the setup script again.