{"id":933,"date":"2026-08-29T18:51:00","date_gmt":"2026-08-29T08:51:00","guid":{"rendered":"http:\/\/diyyourdata.com\/?page_id=933"},"modified":"2026-08-29T18:51:00","modified_gmt":"2026-08-29T08:51:00","slug":"troubleshooting","status":"publish","type":"page","link":"https:\/\/diyyourdata.com\/?page_id=933","title":{"rendered":"Troubleshooting"},"content":{"rendered":"<h2>Troubleshooting Common Issues<\/h2>\n<h3>Installation Problems<\/h3>\n<h4>\\&#8221;command not found: hermes\\&#8221;<\/h4>\n<p>Add to PATH or restart shell:<\/p>\n<pre><code class=\\\"language-bash\\\">export PATH=\\\"\\$HOME\/.local\/bin:\\$PATH\\\"\nsource ~\/.bashrc<\/code><\/pre>\n<h4>Python version errors<\/h4>\n<p>Requires Python 3.10+. Check with:<\/p>\n<pre><code class=\\\"language-bash\\\">python3 --version<\/code><\/pre>\n<h4>Permission denied on install<\/h4>\n<pre><code class=\\\"language-bash\\\">pip install --user hermes-agent\n# or\npipx install hermes-agent<\/code><\/pre>\n<h3>Configuration Issues<\/h3>\n<h4>Model not found \/ API errors<\/h4>\n<ul>\n<li>Verify API key in <code>hermes auth status<\/code><\/li>\n<li>Check model name spelling in <code>~\/.hermes\/config.yaml<\/code><\/li>\n<li>Test with: <code>hermes chat -Q -m deepseek\/deepseek-v4-flash-0731 -q test<\/code><\/li>\n<\/ul>\n<h4>Gateway won&#8217;t start<\/h4>\n<pre><code class=\\\"language-bash\\\">hermes gateway status\ntail -50 ~\/.hermes\/logs\/gateway.log\n# Common fix: install missing platform SDK\nsudo ~\/.local\/lib\/hermes-agent\/venv\/bin\/python -m pip install python-telegram-bot[webhooks]==22.8<\/code><\/pre>\n<h3>Telegram\/Discord Not Working<\/h3>\n<ul>\n<li>Check <code>hermes gateway status<\/code> \u2014 should show \\&#8221;connected\\&#8221;<\/li>\n<li>Verify bot token in <code>hermes auth status<\/code><\/li>\n<li>Re-run <code>hermes setup<\/code> to reconfigure platforms<\/li>\n<\/ul>\n<h3>Skills Not Loading<\/h3>\n<pre><code class=\\\"language-bash\\\">hermes skills list\nhermes skills install <skill-name>\nhermes doctor<\/code><\/pre>\n<h3>Performance Issues<\/h3>\n<ul>\n<li>Reduce <code>context_length<\/code> in config<\/li>\n<li>Disable unused toolsets per platform<\/li>\n<li>Use faster model (e.g., <code>deepseek-v4-flash<\/code>)<\/li>\n<\/ul>\n<h3>Reset Everything<\/h3>\n<pre><code class=\\\"language-bash\\\">hermes config reset\nrm -rf ~\/.hermes\/skills\nhermes setup<\/code><\/pre>\n<hr>\n<p><em>Still stuck? Check <a href=\\\"https:\/\/github.com\/NousResearch\/hermes-agent\/issues\\\">GitHub Issues<\/a> or <a href=\\\"https:\/\/discord.gg\/nousresearch\\\">Discord<\/a>.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Troubleshooting Common Issues Installation Problems \\&#8221;command not found: hermes\\&#8221; Add to PATH or restart shell: export PATH=\\&#8221;\\$HOME\/.local\/bin:\\$PATH\\&#8221; source ~\/.bashrc Python version errors Requires Python 3.10+. Check with: python3 &#8211;version Permission denied on install pip install &#8211;user hermes-agent # or pipx install hermes-agent Configuration Issues Model not found \/ API errors Verify API key in hermes [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"parent":928,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-933","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/diyyourdata.com\/index.php?rest_route=\/wp\/v2\/pages\/933","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/diyyourdata.com\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/diyyourdata.com\/index.php?rest_route=\/wp\/v2\/types\/page"}],"replies":[{"embeddable":true,"href":"https:\/\/diyyourdata.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=933"}],"version-history":[{"count":0,"href":"https:\/\/diyyourdata.com\/index.php?rest_route=\/wp\/v2\/pages\/933\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/diyyourdata.com\/index.php?rest_route=\/wp\/v2\/pages\/928"}],"wp:attachment":[{"href":"https:\/\/diyyourdata.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=933"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}