Hermes Agent — Fork ☤

Upstream: NousResearch/hermes-agent — the self-improving AI agent by Nous Research. Full documentation: hermes-agent.nousresearch.com/docs.

Что это

Форк Hermes Agent — self-improving AI агента от Nous Research. Не официальный релиз, не поддерживается Nous Research. Ставьте на свой риск. Форк поддерживает upstream-синхронизацию через scripts/merge-upstream.sh и вырезает функции, не нужные автору (cron, voice/wake, ACP, i18n, pet) — остальное работает как в upstream.

Что изменено

Удалены мёртвые модули (~29K строк): cron, voice/wake, ACP adapter, i18n/locales, pet. Все продакшн-импорты guarded (try/except ImportError).
Fork installer (fork-install.ps1) — wrapper поверх канонического scripts/install.ps1: клонирует форк по тегу, передаёт управление оригинальному установщику, добавляет .env template и desktop shortcut.
release-node-dists.yml — CI workflow: при push тега v* собирает JS-dist (web/, ui-tui/) и крепит к GitHub Release. Ассеты готовы для будущего no-Node fast-path (пока установщик сам бутстрапит Node и собирает из исходников).
Durability-тесты — 20 тестов покрытия crash-safety: SessionDB, holographic store, memory_tool, active_sessions.
Версионирование holographic store — PRAGMA user_version, транзакционные миграции v1/v2, hrr_vector backfill.
Улучшения memory system — CacheAligner, effort routing, failure mining, provenance tracking через threading.local, Jaccard dedup, secret scrubbing.
Графовая память (graphify) — os.getcwd() вместо phantom _launch_cwd, mtime fallback для shallow clones, dynamic scope в tool description.
Skill Gate — 4 слоя защиты: protected skills, deletion/rename detection, held-out validation (документировано в AGENTS.md).
Очистка — tenacity удалён из deps, packages.json → .gitignore + локальная генерация, graphify-out/ → .gitignore, log.txt удалён, atomic_write консолидирован.
merge-upstream.sh — REMOVE_LIST предотвращает возврат удалённых модулей при upstream-merge.

Чего нет (удалено)

Модуль	Причина
`cron`	Не используется в данной конфигурации
`voice/wake`	Не используется (wake word detection)
`ACP adapter`	Не используется (agent communication protocol)
`i18n/locales`	Не используется (локализация)
`pet`	Не используется (orchestra/pet система)

Установка

Desktop App (Windows) — самый простой путь

Скачайте установщик с GitHub Releases:

Откройте https://github.com/DredusCLWN/hermes-agent-fork/releases в браузере
Скачайте Hermes-0.20.0-win-x64.exe (NSIS установщик, ~113 МБ)
Запустите — установщик поставит desktop app
При первом запуске app сам скачает и установит Python-бэкенд (uv, Python 3.11, Node.js, ripgrep, ffmpeg, PortableGit)

Ничего не нужно устанавливать заранее — только интернет.

SmartScreen предупредит о неподписанном exe — нажмите «Run anyway». Форк не имеет code-signing сертификата.

Windows (PowerShell) — CLI-установка

# Вариант A: через fork-install.ps1 (нужен Git for Windows)
powershell -ExecutionPolicy Bypass -File fork-install.ps1

# Вариант B: без Git — установщик сам скачает PortableGit
irm https://raw.githubusercontent.com/DredusCLWN/hermes-agent-fork/v2026.8.10/scripts/install.ps1 | iex

Опции fork-install.ps1:

# Пин к конкретному тегу
powershell -ExecutionPolicy Bypass -File fork-install.ps1 -Tag v2026.8.10

# Пропустить setup wizard
powershell -ExecutionPolicy Bypass -File fork-install.ps1 -SkipSetup

# Собрать desktop app
powershell -ExecutionPolicy Bypass -File fork-install.ps1 -IncludeDesktop

# Без ярлыка на рабочем столе
powershell -ExecutionPolicy Bypass -File fork-install.ps1 -NoShortcut

Установщик:

Клонирует форк по тегу (git clone --depth 1 --branch <tag>)
Передаёт управление scripts/install.ps1 (uv, Python 3.11, Node.js, ripgrep, ffmpeg, PortableGit)
Создаёт .env template для API-ключей
Создаёт ярлык desktop (если собран)

Требования для варианта A: Git for Windows. Для варианта B: ничего, только интернет.

Windows (CMD)

:: Только клонировать
 git clone --depth 1 --branch v2026.8.10 https://github.com/DredusCLWN/hermes-agent-fork C:\hermes
cd C:\hermes

 :: Клонировать + полная установка
 git clone --depth 1 --branch v2026.8.10 https://github.com/DredusCLWN/hermes-agent-fork C:\hermes
cd C:\hermes
powershell -ExecutionPolicy Bypass -File scripts\install.ps1

 :: Без Git — одна команда
powershell -Command "irm https://raw.githubusercontent.com/DredusCLWN/hermes-agent-fork/v2026.8.10/scripts/install.ps1 | iex"

Linux, macOS, WSL2

# Клонировать форк по тегу
git clone --depth 1 --branch v2026.8.10 https://github.com/DredusCLWN/hermes-agent-fork ~/hermes-agent
cd ~/hermes-agent

# Venv вне исходников
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate

uv pip install -e ".[all,dev]"

⚠️ Не используйте curl install.sh | bash + git remote set-url — это ломает hermes update (detached HEAD на теге, origin переписан). Клонируйте форк напрямую.

После установки

hermes              # CLI — начать разговор
hermes setup        # Setup wizard (провайдер, модель, ключи)
hermes model        # Выбрать LLM
hermes --tui        # TUI режим

Начало работы

hermes              # Interactive CLI
hermes model        # Выбрать LLM провайдера и модель
hermes tools        # Настроить инструменты
hermes config set   # Установить значение конфигурации
hermes config get   # Прочитать значение конфигурации
hermes gateway      # Запустить messaging gateway (Telegram, Discord, и т.д.)
hermes setup        # Полный setup wizard
hermes update       # Обновить до последней версии
hermes doctor       # Диагностика проблем

📖 Документация upstream →

CLI vs Messaging

Действие	CLI	Messaging
Начать чат	`hermes`	`hermes gateway setup` + `hermes gateway start`, затем сообщение боту
Новая сессия	`/new` или `/reset`	`/new` или `/reset`
Сменить модель	`/model [provider:model]`	`/model [provider:model]`
Личность	`/personality [name]`	`/personality [name]`
Retry / undo	`/retry`, `/undo`	`/retry`, `/undo`
Compress / usage	`/compress`, `/usage`, `/insights [--days N]`	`/compress`, `/usage`, `/insights [days]`
Skills	`/skills` или `/<skill-name>`	`/<skill-name>`
Прервать	`Ctrl+C` или новое сообщение	`/stop` или новое сообщение

Полный список команд: CLI guide и Messaging Gateway guide.

Провайдеры

Hermes работает с любым провайдером — OpenRouter, OpenAI, Anthropic, DeepSeek, своим endpoint, или Nous Portal. Переключение: hermes model — без смены кода.

hermes model              # Интерактивный выбор провайдера и модели
# Примеры:
#   DeepSeek (free/дешёвые модели)
#   OpenRouter (агрегатор, 100+ провайдеров)
#   Свой endpoint (OpenAI-совместимый API)

hermes setup --portal    # Nous Portal: 300+ моделей + Tool Gateway (опционально)

Разработка

# Клонировать форк
git clone https://github.com/DredusCLWN/hermes-agent-fork
cd hermes-agent

# Venv вне исходников (важно — venv внутри может быть уничтожен агентом)
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate    # Linux/macOS
# или: ~/.hermes/venvs/hermes-dev/Scripts/activate   # Windows

uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Desktop App сборка

# Из корня репо
npm ci
cd apps\desktop
npm run dist:win

# Результат: apps\desktop\release\Hermes-0.20.0-win-x64.exe

Требуется Node.js 22+ и ~5 ГБ свободного места. CI workflow release-desktop.yml собирает автоматически при push тега v*.

Upstream sync

scripts/merge-upstream.sh

Скрипт подтягивает изменения из NousResearch/hermes-agent, применяет REMOVE_LIST (предотвращает возврат удалённых модулей), и оставляет fork-specific файлы нетронутыми.

Архитектура

Полная документация архитектуры: upstream docs.

Ключевые fork-specific файлы:

Файл	Назначение
`fork-install.ps1`	Wrapper установщика форка
`scripts/merge-upstream.sh`	Upstream sync + REMOVE_LIST
`.github/workflows/release-node-dists.yml`	CI: сборка JS-dist на тег
`.github/workflows/release-desktop.yml`	CI: сборка desktop exe на тег
`plugins/memory/holographic/store.py`	Версионирование schema + миграции
`agent/live_session_registry.py`	Live session tracking
`agent/refine_snapshot.py`	Refine snapshot logic
`tools/agent_message_tool.py`	Agent messaging tool

Community

License

MIT — see LICENSE.

Upstream: NousResearch/hermes-agent by Nous Research.

Name		Name	Last commit message	Last commit date
.ai-memory		.ai-memory
.github		.github
.plans		.plans
agent		agent
apps		apps
assets		assets
contributors		contributors
datagen-config-examples		datagen-config-examples
docker		docker
docs		docs
gateway		gateway
hermes_cli		hermes_cli
mcp-research-data		mcp-research-data
native/fts5_cjk		native/fts5_cjk
nix		nix
optional-mcps		optional-mcps
optional-skills		optional-skills
plugins		plugins
providers		providers
scripts		scripts
skills		skills
tests-js		tests-js
tests		tests
tools		tools
tui_gateway		tui_gateway
ui-tui		ui-tui
web		web
website		website
.dockerignore		.dockerignore
.env.example		.env.example
.envrc		.envrc
.gitattributes		.gitattributes
.gitignore		.gitignore
.hadolint.yaml		.hadolint.yaml
.mailmap		.mailmap
.npmrc		.npmrc
.nvmrc		.nvmrc
.prettierignore		.prettierignore
.prettierrc		.prettierrc
.python-version		.python-version
.windsurfrules		.windsurfrules
AGENTS.md		AGENTS.md
AUDIT.md		AUDIT.md
CONTRIBUTING.es.md		CONTRIBUTING.es.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
PROJECT_STATE.md		PROJECT_STATE.md
README.es.md		README.es.md
README.md		README.md
README.ur-pk.md		README.ur-pk.md
README.zh-CN.md		README.zh-CN.md
SECURITY.es.md		SECURITY.es.md
SECURITY.md		SECURITY.md
batch_runner.py		batch_runner.py
cli-config.yaml.example		cli-config.yaml.example
cli.py		cli.py
constraints-termux.txt		constraints-termux.txt
create-bat.ps1		create-bat.ps1
docker-compose.windows.yml		docker-compose.windows.yml
docker-compose.yml		docker-compose.yml
eslint.config.shared.mjs		eslint.config.shared.mjs
flake.lock		flake.lock
flake.nix		flake.nix
fork-install.ps1		fork-install.ps1
hermes		hermes
hermes-already-has-routines.md		hermes-already-has-routines.md
hermes_bootstrap.py		hermes_bootstrap.py
hermes_constants.py		hermes_constants.py
hermes_logging.py		hermes_logging.py
hermes_state.py		hermes_state.py
hermes_state_common.py		hermes_state_common.py
hermes_state_portability.py		hermes_state_portability.py
hermes_state_schema.py		hermes_state_schema.py
hermes_state_search.py		hermes_state_search.py
hermes_time.py		hermes_time.py
mcp_serve.py		mcp_serve.py
mini_swe_runner.py		mini_swe_runner.py
model_tools.py		model_tools.py
package-lock.json		package-lock.json
package.json		package.json
pyproject.toml		pyproject.toml
restart-hermes.bat		restart-hermes.bat
run_agent.py		run_agent.py
setup-hermes.sh		setup-hermes.sh
setup.py		setup.py
sqlite_leak_fix.png		sqlite_leak_fix.png
toolset_distributions.py		toolset_distributions.py
toolsets.py		toolsets.py
trajectory_compressor.py		trajectory_compressor.py
utils.py		utils.py
uv.lock		uv.lock

Navigation Menu

Repository files navigation

Hermes Agent — Fork ☤

Что это

Что изменено

Чего нет (удалено)

Установка

Desktop App (Windows) — самый простой путь

Windows (PowerShell) — CLI-установка

Windows (CMD)

Linux, macOS, WSL2

После установки

Начало работы

CLI vs Messaging

Провайдеры

Разработка

Desktop App сборка

Upstream sync

Архитектура

Community

License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Hermes Agent — Fork ☤

Что это

Что изменено

Чего нет (удалено)

Установка

Desktop App (Windows) — самый простой путь

Windows (PowerShell) — CLI-установка

Windows (CMD)

Linux, macOS, WSL2

После установки

Начало работы

CLI vs Messaging

Провайдеры

Разработка

Desktop App сборка

Upstream sync

Архитектура

Community

License

About

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages