nousresearch/hermes-agent

Code health of nousresearch/hermes-agent

Repowise scores nousresearch/hermes-agent at 5.3 out of 10 for code health, which reads as needs work, alongside maintainability 6.8 and static performance 9.4 on the same scale. There are 43,909 open findings across the three pillars, and the lowest-scoring file is run.py at 1.0. Scores are computed from complexity, duplication, churn and git fix history, not from a linter.

Findings by severity

3,690 critical, 6,023 high, 11,162 medium, 21,954 low.

Hotspots

1,424 files are flagged as hotspots. The top 5:

gateway/run.py: 530 commits in the last 90 days from 198 contributors with 1,045 recent bug fixes
hermes_state.py: 238 commits in the last 90 days from 77 contributors with 265 recent bug fixes
hermes_cli/web_server.py: 283 commits in the last 90 days from 94 contributors with 307 recent bug fixes
apps/desktop/electron/main.ts: 270 commits in the last 90 days from 79 contributors with 184 recent bug fixes
hermes_cli/main.py: 267 commits in the last 90 days from 80 contributors with 482 recent bug fixes

Lowest-scoring files

gateway/run.py: 1.0 out of 10 with 1,045 bug fixes in the last 180 days
plugins/platforms/telegram/adapter.py: 1.0 out of 10 with 119 bug fixes in the last 180 days
plugins/platforms/matrix/adapter.py: 1.0 out of 10 with 37 bug fixes in the last 180 days
agent/conversation_loop.py: 1.0 out of 10 with 208 bug fixes in the last 180 days
agent/agent_runtime_helpers.py: 1.0 out of 10 with 108 bug fixes in the last 180 days

Checked against bug fixes

Of the 20 files Repowise scores lowest, 20 had a bug fix in the last 180 days. Across all 8,758 scored files, 55.5% had a bug fix in that window.

Dead code and refactoring

Repowise found 382 unused exports. 1,056 refactoring targets across 1,056 files would raise the score.

More on hermes-agent: summary and FAQ, codebase overview, architecture.