https://github.com/deepseek-ai/awesome-deepseek-agent/blob/main/docs/hermes.md这是 DeepSeek 开源整合的地址。Hermes is a self-improving AI agent built by Nous Research. It includes a built-in learning loop: it creates skills from experience, improves them during use, persists knowledge, and builds an evolving model of your preferences across sessions.Hermes 是由 Nous Research 开发的一款具备自我提升能力的 AI 智能体。它内置了学习循环机制能够从经验中习得技能并在使用过程中加以改进持久保存知识并跨会话构建关于你偏好的演进式模型。1. Install HermesQuick InstallGet Hermes Agent up and running in under two minutes with the one-line installer.Linux / macOS / WSL2curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bashThe only prerequisite is Git. The installer automatically handles everything else.For more installation instructions, please refer to the Hermes installation page.2. Run and ConfigureReload your shell and start Hermes configuration:Execute thehermes setupcommandChoose the Quick Setup optionWhen prompted for the model provider, selectDeepSeekEnter your DeepSeek API KeyEnter the Base URL ashttps://api.deepseek.comSelect thedeepseek-v4-promodelContinue with the remaining optionsWhat the Installer DoesThe installer handles everything automatically — all dependencies (Python, Node.js, ripgrep, ffmpeg), the repo clone, virtual environment, globalhermescommand setup, and LLM provider configuration. By the end, youre ready to chat.Install LayoutWhere the installer puts things depends on whether youre installing as a normal user or as root:InstallerCode lives athermesbinaryData directoryPer-user (git installer)~/.hermes/hermes-agent/~/.local/bin/hermes(symlink)~/.hermes/Root-mode (sudo curl … | sudo bash)/usr/local/lib/hermes-agent//usr/local/bin/hermes/root/.hermes/(or$HERMES_HOME)The root-modeFHS layout(/usr/local/lib/…,/usr/local/bin/hermes) matches where other system-wide developer tools land on Linux. Its useful for shared-machine deployments where one system install should serve every user. Per-user config (auth, skills, sessions) still lives under each users~/.hermes/or explicitHERMES_HOME.After InstallationReload your shell and start chatting:source ~/.bashrc # or: source ~/.zshrc hermes # Start chatting!To reconfigure individual settings later, use the dedicated commands:hermes model # Choose your LLM provider and model hermes tools # Configure which tools are enabled hermes gateway setup # Set up messaging platforms hermes config set # Set individual config values hermes setup # Or run the full setup wizard to configure everything at onceFastest path: Nous PortalOne subscription covers 300 models plus the Tool Gateway (web search, image generation, TTS, cloud browser). Skip the per-tool key juggling:hermes setup --portalThat logs you in, sets Nous as your provider, and turns on the Tool Gateway in one command.PrerequisitesInstaller:On non-Windows platforms, the only prerequisite isGit. On Linux, also make surecurlandxz-utilsare available (the installer downloads Node.js as a.tar.xzarchive). The desktop app additionally requiresg(orbuild-essentialon Debian/Ubuntu) to compile native modules. The installer automatically handles everything else:uv(fast Python package manager)Python 3.11(via uv, no sudo needed)Node.js v22(for browser automation and WhatsApp bridge)ripgrep(fast file search)ffmpeg(audio format conversion for TTS)infoYou donotneed to install Python, Node.js, ripgrep, or ffmpeg manually. The installer detects whats missing and installs it for you. Just make suregitis available (git --version). On Linux, ensurecurlandxz-utilsare installed (sudo apt install curl xz-utilson Debian/Ubuntu). For the desktop app, also installbuild-essential(sudo apt install build-essential).Nix usersNix isno longer an explicitly supported install path(best-effort only). If you already use Nix (on NixOS, macOS, or Linux), theres a dedicated setup path with a Nix flake, declarative NixOS module, and optional container mode. See theNix NixOS Setupguide.Manual / Developer InstallationIf you want to clone the repo and install from source — for contributing, running from a specific branch, or having full control over the virtual environment — see the Development Setup section in the Contributing guide.Non-Sudo / System Service User InstallsRunning Hermes as a dedicated unprivileged user (e.g. ahermessystemd service account, or any user withoutsudoaccess) is supported. The only thing on the install path that genuinely needs root is Playwrights--with-depsstep, whichapt-installs shared libraries (libnss3,libxkbcommon, etc.) used by Chromium. The installer detects whether sudo is available and gracefully degrades when it isnt — it will install the Chromium binary into the service users own Playwright cache and print the exact command an administrator needs to run separately.支持以专用的非特权用户例如 hermes systemd 服务账户或任何没有 sudo 权限的用户身份运行 Hermes。在安装过程中唯一真正需要 root 权限的步骤是 Playwright 的 --with-deps 环节该步骤会通过 apt 安装 Chromium 所需的共享库如 libnss3、libxkbcommon 等。安装程序会自动检测是否存在 sudo 权限若无权限则会采取降级处理将 Chromium 二进制文件安装到服务用户自己的 Playwright 缓存目录中并输出管理员需单独执行的具体命令。Recommended split (Debian/Ubuntu):One time, as an admin user with sudo, install the system libraries Chromium needs:sudo npx playwright install-deps chromium(You can run this from anywhere —npxwill fetch Playwright on the fly.)As the unprivileged service user, run the regular installer. It will detect the missing sudo, skip--with-deps, and install Chromium into the users local Playwright cache:curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashIf you want to skip the Playwright step entirely — for example because youre running headless and dont need browser automation — pass--skip-browser:curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browserMakehermesavailable to the service users shells.The installer writes the launcher to~/.local/bin/hermes. System service accounts often have a minimal PATH that doesnt include~/.local/bin. Either add it to the users environment, or symlink the launcher into a system location:# Option A — add to the service users profile echo export PATH$HOME/.local/bin:$PATH ~/.bashrc # Option B — symlink system-wide (run as an admin) sudo ln -s /home/hermes/.hermes/hermes-agent/venv/bin/hermes /usr/local/bin/hermesVerify:hermes doctorshould now run cleanly. If you getModuleNotFoundError: No module named dotenv, youre invoking the repo sourcehermesfile (~/.hermes/hermes-agent/hermes) with system Python instead of the venv launcher (~/.hermes/hermes-agent/venv/bin/hermes) — fix step 3.The same pattern works on Arch (the installer uses pacman with the same sudo-detection logic), Fedora/RHEL, and openSUSE — those distros dont support--with-depsat all, so an administrator always installs the system libraries separately. The relevantdnf/zyppercommands are printed by the installer.TroubleshootingProblemSolutionhermes: command not foundReload your shell (source ~/.bashrc) or check PATHAPI key not setRunhermes modelto configure your provider, orhermes config set OPENROUTER_API_KEY your_keyMissing config after updateRunhermes config checkthenhermes config migrateFor more diagnostics, runhermes doctor— it will tell you exactly whats missing and how to fix it.Install method auto-detectionHermes auto-detects whether it was installed viapip, the git installer, Homebrew, or NixOS, andhermes updateprints the matching update command for that path. Theres no env var to set — the detection is based on the install layout (Python site-packages,~/.hermes/hermes-agent/, Homebrew prefix, or Nix store path).hermes doctoralso surfaces the detected method under its environment summary.