| name: "🔧 Setup / Installation Help" |
| description: Having trouble installing or configuring Hermes? Ask here. |
| title: "[Setup]: " |
| labels: ["setup"] |
| body: |
| - type: markdown |
| attributes: |
| value: | |
| Sorry you're having trouble! Please fill out the details below so we can help. |
| |
| **Quick checks first:** |
| - Run `hermes doctor` and include the output below |
| - Try `hermes update` to get the latest version |
| - Check the [README troubleshooting section](https://github.com/NousResearch/hermes-agent#troubleshooting) |
| - For general questions, consider the [Nous Research Discord](https://discord.gg/NousResearch) for faster help |
|
|
| - type: textarea |
| id: description |
| attributes: |
| label: What's Going Wrong? |
| description: Describe what you're trying to do and where it fails. |
| placeholder: | |
| I ran `hermes setup` and selected Nous Portal, but when I try to |
| start the gateway I get... |
| validations: |
| required: true |
|
|
| - type: textarea |
| id: steps |
| attributes: |
| label: Steps Taken |
| description: What did you do? Include the exact commands you ran. |
| placeholder: | |
| 1. Ran the install script: `curl -fsSL ... | bash` |
| 2. Ran `hermes setup` and chose "Quick setup" |
| 3. Selected OpenRouter, entered API key |
| 4. Ran `hermes chat` and got error... |
| validations: |
| required: true |
|
|
| - type: dropdown |
| id: install-method |
| attributes: |
| label: Installation Method |
| options: |
| - Install script (curl | bash) |
| - Manual clone + pip/uv install |
| - PowerShell installer (Windows) |
| - Docker |
| - Other |
| validations: |
| required: true |
|
|
| - type: input |
| id: os |
| attributes: |
| label: Operating System |
| placeholder: Ubuntu 24.04 / macOS 15.2 / Windows 11 |
| validations: |
| required: true |
|
|
| - type: input |
| id: python-version |
| attributes: |
| label: Python Version |
| description: Output of `python --version` (or `python3 --version`) |
| placeholder: "3.11.9" |
|
|
| - type: input |
| id: hermes-version |
| attributes: |
| label: Hermes Version |
| description: Output of `hermes version` (if install got that far) |
| placeholder: "2.1.0" |
|
|
| - type: textarea |
| id: doctor-output |
| attributes: |
| label: Output of `hermes doctor` |
| description: Run `hermes doctor` and paste the full output. This will be auto-formatted. |
| render: shell |
|
|
| - type: textarea |
| id: error-output |
| attributes: |
| label: Full Error Output |
| description: Paste the complete error message or traceback. This will be auto-formatted. |
| render: shell |
| validations: |
| required: true |
|
|
| - type: textarea |
| id: tried |
| attributes: |
| label: What I've Already Tried |
| description: List any fixes or workarounds you've already attempted. |
| placeholder: | |
| - Ran `hermes update` |
| - Tried reinstalling with `pip install -e ".[all]"` |
| - Checked that OPENROUTER_API_KEY is set in ~/.hermes/.env |
| |
