Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix [Bug]: Unable to Enter or Paste API Key During Hermes Setup on Ubuntu - CRITICAL [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#15768•Fetched 2026-04-26 05:25:10
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Author
alexandre-lengalexandre-leng
Participants
alexandre-lengalexandre-lengalt-glitchalt-glitch
Timeline (top)
labeled ×3commented ×1

Error Message

Additional Logs / Traceback (optional)

Root Cause

Root Cause Analysis (optional)

Code Example

...@...:~$ hermes setup

┌─────────────────────────────────────────────────────────┐
│             ⚕ Hermes Agent Setup Wizard                │
├─────────────────────────────────────────────────────────┤
│  Let's configure your Hermes Agent installation.       │
│  Press Ctrl+C at any time to exit.                     │
└─────────────────────────────────────────────────────────┘


◆ Welcome Back!
✓ You already have Hermes configured.



◆ Configuration Location
  Config file:  /home/.../.hermes/config.yaml
  Secrets file: /home/.../.hermes/.env
  Data folder:  /home/.../.hermes
  Install dir:  /home/.../.hermes/hermes-agent

  You can edit these files directly or use 'hermes config edit'

◆ Inference Provider
  Choose how to connect to your main chat model.
     Guide: https://hermes-agent.nousresearch.com/docs/integrations/providers


  Current model:    anthropic/claude-opus-4.6
  Active provider:  OpenRouter


Select default model:                                                           
                                                   In      Out  Cache  /Mtok    
     xiaomi/mimo-v2.5                           $0.40    $2.00  $0.08           
     openai/gpt-5.3-codex                       $1.75   $14.00  $0.17           
     google/gemini-3-flash-preview              $0.50    $3.00  $0.05           
     google/gemini-3.1-pro-preview              $2.00   $12.00  $0.20           
     google/gemini-3.1-flash-lite-preview       $0.25    $1.50  $0.02           
     qwen/qwen3.5-plus-02-15                    $0.26    $1.56                  
     qwen/qwen3.5-35b-a3b                       $0.16    $1.30                  
     stepfun/step-3.5-flash                     $0.10    $0.30                  
     minimax/minimax-m2.7                       $0.30    $1.20  $0.06           
     minimax/minimax-m2.5                       $0.15    $1.15  $0.03           
->   minimax/minimax-m2.5:free                   free     free                  
     z-ai/glm-5.1                               $1.05    $3.50  $0.52           
     z-ai/glm-5v-turbo                          $1.20    $4.00  $0.24           
     z-ai/glm-5-turbo                           $1.20    $4.00  $0.24           
     x-ai/grok-4.20                             $2.00    $6.00  $0.20           
     nvidia/nemotron-3-super-120b-a12b          $0.09    $0.45                  
     nvidia/nemotron-3-super-120b-a12b:free      free     free                  
     arcee-ai/trinity-large-thinking            $0.22    $0.85  $0.06           
     openai/gpt-5.5-pro                        $30.00  $180.00                  
     openai/gpt-5.4-nano                        $0.20    $1.25  $0.02           
     Enter custom model name                                                    
     Skip (keep current)                                                        

Default model set to: minimax/minimax-m2.5:free (via OpenRouter)


◆ Same-Provider Fallback & Rotation
  Hermes can keep multiple credentials for one provider and rotate between
  them when a credential is exhausted or rate-limited. This preserves
  your primary provider while reducing interruptions from quota issues.

  Current pooled credentials for openrouter: 1 (0 manual, 1 auto-detected from env/shared auth)
Add another credential for same-provider fallback? [y/N]: y
Paste your API key:

---
RAW_BUFFERClick to expand / collapse

Bug Description

When running hermes setup on Ubuntu, the CLI prompts for "Paste your API key:" but the terminal does not accept keyboard input (no characters appear, Ctrl+V doesn't work, right-click paste doesn't work). The wizard appears to hang on this step and cannot proceed.

Environment: Ubuntu (terminal), Hermes setup wizard interactive mode

Steps to Reproduce

  1. Run hermes setup in terminal on Ubuntu
  2. Progress through the wizard until "Inference Provider" section
  3. Select a model (e.g., minimax/minimax-m2.5:free)
  4. When prompted "Add another credential for same-provider fallback? [y/N]:", answer 'y'
  5. At "Paste your API key:" prompt, attempt to paste or type any characters
  6. Observe that no input is registered and the wizard cannot continue

Expected Behavior

The terminal should accept pasted or typed API key input (possibly with hidden characters for security) and allow the user to press Enter to submit and continue the setup.

Actual Behavior

The cursor remains static at the "Paste your API key:" prompt. No characters appear when typing, and paste operations (Ctrl+Shift+V, right-click, Ctrl+V) do not insert the API key. The only way to exit is Ctrl+C.

Affected Component

Setup / Installation

Messaging Platform (if gateway-related)

No response

Debug Report

...@...:~$ hermes setup

┌─────────────────────────────────────────────────────────┐
│             ⚕ Hermes Agent Setup Wizard                │
├─────────────────────────────────────────────────────────┤
│  Let's configure your Hermes Agent installation.       │
│  Press Ctrl+C at any time to exit.                     │
└─────────────────────────────────────────────────────────┘


◆ Welcome Back!
✓ You already have Hermes configured.



◆ Configuration Location
  Config file:  /home/.../.hermes/config.yaml
  Secrets file: /home/.../.hermes/.env
  Data folder:  /home/.../.hermes
  Install dir:  /home/.../.hermes/hermes-agent

  You can edit these files directly or use 'hermes config edit'

◆ Inference Provider
  Choose how to connect to your main chat model.
     Guide: https://hermes-agent.nousresearch.com/docs/integrations/providers


  Current model:    anthropic/claude-opus-4.6
  Active provider:  OpenRouter


Select default model:                                                           
                                                   In      Out  Cache  /Mtok    
     xiaomi/mimo-v2.5                           $0.40    $2.00  $0.08           
     openai/gpt-5.3-codex                       $1.75   $14.00  $0.17           
     google/gemini-3-flash-preview              $0.50    $3.00  $0.05           
     google/gemini-3.1-pro-preview              $2.00   $12.00  $0.20           
     google/gemini-3.1-flash-lite-preview       $0.25    $1.50  $0.02           
     qwen/qwen3.5-plus-02-15                    $0.26    $1.56                  
     qwen/qwen3.5-35b-a3b                       $0.16    $1.30                  
     stepfun/step-3.5-flash                     $0.10    $0.30                  
     minimax/minimax-m2.7                       $0.30    $1.20  $0.06           
     minimax/minimax-m2.5                       $0.15    $1.15  $0.03           
->   minimax/minimax-m2.5:free                   free     free                  
     z-ai/glm-5.1                               $1.05    $3.50  $0.52           
     z-ai/glm-5v-turbo                          $1.20    $4.00  $0.24           
     z-ai/glm-5-turbo                           $1.20    $4.00  $0.24           
     x-ai/grok-4.20                             $2.00    $6.00  $0.20           
     nvidia/nemotron-3-super-120b-a12b          $0.09    $0.45                  
     nvidia/nemotron-3-super-120b-a12b:free      free     free                  
     arcee-ai/trinity-large-thinking            $0.22    $0.85  $0.06           
     openai/gpt-5.5-pro                        $30.00  $180.00                  
     openai/gpt-5.4-nano                        $0.20    $1.25  $0.02           
     Enter custom model name                                                    
     Skip (keep current)                                                        

Default model set to: minimax/minimax-m2.5:free (via OpenRouter)


◆ Same-Provider Fallback & Rotation
  Hermes can keep multiple credentials for one provider and rotate between
  them when a credential is exhausted or rate-limited. This preserves
  your primary provider while reducing interruptions from quota issues.

  Current pooled credentials for openrouter: 1 (0 manual, 1 auto-detected from env/shared auth)
Add another credential for same-provider fallback? [y/N]: y
Paste your API key:

Operating System

Ubuntu 25.04 (Plucky)

Python Version

Python 3.13.3

Hermes Version

Hermes Agent v0.11.0 (2026.4.23) · upstream 283c8fd6

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

No response

Proposed Fix (optional)

No response

Are you willing to submit a PR for this?

  • I'd like to fix this myself and submit a PR

extent analysis

TL;DR

The issue can likely be resolved by checking the terminal settings or environment variables that might be interfering with the input prompt in the Hermes setup wizard.

Guidance

  • Verify that the terminal emulator being used supports hidden input, as the API key input is expected to be hidden for security reasons.
  • Check for any environment variables or shell configurations that might be causing the input prompt to malfunction.
  • Try running the hermes setup command in a different terminal emulator to see if the issue persists.
  • If possible, attempt to paste the API key using a different method, such as using a keyboard shortcut or a paste function provided by the terminal emulator.

Example

No code snippet is provided as the issue seems to be related to the terminal or environment settings rather than a code-specific problem.

Notes

The issue might be specific to the Ubuntu 25.04 (Plucky) operating system or the Python 3.13.3 version being used. Further investigation into the terminal settings and environment variables is necessary to determine the root cause.

Recommendation

Apply a workaround by trying a different terminal emulator or checking the environment variables to resolve the issue, as the root cause is unclear and may not be directly related to the Hermes Agent code.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#installation#callback error#memory management#agent setup

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix [Bug]: Unable to Enter or Paste API Key During Hermes Setup on Ubuntu - CRITICAL [1 comments, 2 participants]