30ff395924
Add structured GitHub templates based on analysis of 200+ closed PRs and 50+ closed issues to improve submission quality: Issue templates (YAML form-based): - Bug Report: requires reproduction steps, expected/actual behavior, OS/Python/Hermes version. Optional root cause analysis field. - Feature Request: requires problem/use case, links to skill-vs-tool guidance in CONTRIBUTING.md to reduce misguided tool PRs. - Setup/Installation Help: requires install method, hermes doctor output, error logs, steps already tried. - Template chooser config with links to Discord, docs, contributing guide. PR template: - Type of change selector (bug/feature/security/docs/tests/refactor/skill) - Mandatory issue reference, changes list, testing steps - Checklist: conventional commits, no duplicates, focused changes, tests pass, tests added, platform tested - Dedicated 'New Skills' section asking if skill is broadly useful and properly formatted/tested Key problems these templates address: - Bug reports with no reproduction steps or environment info - Duplicate/racing PRs (multiple people fixing same issue) - Stale branches with 85+ unrelated file changes - Junk skill PRs that should go to Skills Hub instead of bundled - Missing tests on bug fix PRs - No issue references on PRs
101 lines
3.0 KiB
YAML
101 lines
3.0 KiB
YAML
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
|