[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-79178":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":8,"language":10,"languages":8,"totalLinesOfCode":8,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":8,"pushedAt":8,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":15,"starSnapshotCount":15,"syncStatus":28,"lastSyncTime":29,"discoverSource":30},79178,"Hermes-USB-Portable","techjarves\u002FHermes-USB-Portable","techjarves",null,"","Shell",348,127,6,8,0,7,48,242,35,84.32,false,"main",true,[],"2026-06-12 04:01:24","# \u003Cp align=\"center\">🛸 Hermes Agent — Portable & Cross-Platform\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FHermes_Agent-Portable-8A2BE2?style=for-the-badge&logo=ai\" alt=\"Hermes Agent Portable\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002FNousResearch\u002Fhermes-agent?style=for-the-badge&color=2563EB\" alt=\"License\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPlatform-Windows%20%7C%20macOS%20%7C%20Linux-059669?style=for-the-badge\" alt=\"Platforms\">\n\u003C\u002Fp>\n\n---\n\n\u003Cp align=\"center\">\n  \u003Cstrong>Run a fully self-contained, self-improving AI agent from a single folder or USB drive.\u003C\u002Fstrong>\u003Cbr>\n  No global installation. Zero host pollution. All conversations, configs, memories, and skills stay inside your folder.\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FgL220WHXWeo\" target=\"_blank\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FgL220WHXWeo\u002Fmaxresdefault.jpg\" alt=\"Hermes Portable Setup Walkthrough Video\" width=\"700\" style=\"border-radius: 12px; box-shadow: 0 8px 30px rgba(0, 0, 0, 0.3); border: 1px solid rgba(255, 255, 255, 0.15);\">\n  \u003C\u002Fa>\n  \u003Cbr>\n  \u003Cem>📺 \u003Cstrong>Watch the Setup & Demo Video:\u003C\u002Fstrong> Click the image above to watch the step-by-step walkthrough.\u003C\u002Fem>\n\u003C\u002Fp>\n\n---\n\n## ✨ Key Features\n\n*    **Zero Host Dependencies**: No pre-installed Python, Node.js, or package managers required on the computer. All runtimes are downloaded locally.\n*    **100% Portable**: Copy the entire directory to a USB flash drive or external SSD. Run it on any Windows, macOS, or Linux computer instantly.\n*    **True Privacy & Isolation**: Your API keys (`data\u002F.env`), conversations (`data\u002Fsessions\u002F`), persistent memory, and custom skills are kept strictly within the portable folder.\n*    **Interactive Console Launcher**: Includes a beautiful terminal UI dashboard with state-tracking for setup status, LLM providers, and background gateways.\n*    **Full Hermes Capabilities**: Retains all features of [Nous Research's Hermes Agent](https:\u002F\u002Fgithub.com\u002FNousResearch\u002Fhermes-agent), including memory storage and reusable skill generation.\n\n---\n\n## ⚡ Quick Start\n\nGet Hermes running in seconds depending on your operating system:\n\n### Windows (10 \u002F 11)\nSimply double-click the **`launch.bat`** file in this folder.\n> *Note: On first run, it will launch a PowerShell window to download dependencies and configure your runtime environment.*\n\n###  macOS & Linux\nOpen your terminal in this directory and execute:\n```bash\nchmod +x launch.sh\n.\u002Flaunch.sh\n```\n\n> 💡 **macOS Double-Click Shortcut:** If you want to double-click in Finder to launch, rename `launch.sh` to `launch.command`. macOS recognizes `.command` files and opens them in Terminal automatically.\n\n---\n\n## ⚙️ How It Works (Under the Hood)\n\nHermes Portable solves the host-dependency issue by establishing a sandboxed runtime context pointing inwards.\n\n```mermaid\ngraph TD\n    A[User triggers launch script] --> B{Runtimes setup?}\n    B -- No \u002F First Run --> C[Download Portable Python 3.11 & Node.js 22]\n    C --> D[Clone Hermes Agent Source to src\u002F]\n    D --> E[Create isolated virtual env using uv]\n    E --> F[Install Python & Node packages locally]\n    F --> G[Generate ready.flag]\n    B -- Yes \u002F Ready --> H[Configure environment variables]\n    G --> H\n    H --> I[Set HERMES_HOME = data\u002F]\n    I --> J[Prepend portable bin\u002F paths to Env PATH]\n    J --> K[Launch Terminal Dashboard Menu]\n    K --> L[Start Chat \u002F Background Gateway]\n```\n\n### The Isolation Design\n1. **Custom Data Directory**: The launcher overrides `HERMES_HOME` to the local `data\u002F` folder, forcing Hermes to write configuration and data locally rather than in `~\u002F.hermes\u002F`.\n2. **Local Path Sandboxing**: The scripts download self-contained Python and Node.js binaries into `.cache\u002Fruntimes\u002F` and prepend them directly to the active process `PATH`.\n3. **No Registry\u002FHost Pollution**: System configurations, environment variables, or packages on the host machine are left untouched.\n\n---\n\n## 📁 Workspace Directory Structure\n\nA clean, modular layout where runtime caches are separated from your personal configurations.\n\n```yaml\nhermes-portable\u002F\n├── launch.bat                 # Windows interactive launcher script\n├── launch.sh                  # macOS & Linux interactive launcher script\n├── scripts\u002F\n│   ├── setup-windows.ps1      # Windows first-run configuration script\n│   └── setup-unix.sh          # Unix (macOS\u002FLinux) first-run configuration script\n├── data\u002F                      # ⚠️ [BACKUP THIS] All your private files\n│   ├── config.yaml            # Hermes LLM provider configurations\n│   ├── .env                   # API Keys and active credentials\n│   ├── sessions\u002F              # Chronological chat histories\n│   ├── memories\u002F              # Persistent memory databases\n│   └── skills\u002F                # Learned custom skills\n├── src\u002F                       # Downloaded Hermes Agent source code\n│   └── hermes-agent\u002F\n└── .cache\u002F                    # Sandbox cache & binaries\n    └── runtimes\u002F              # Platform-specific portable interpreters\n        ├── windows-x64\u002F\n        ├── macos-arm64\u002F\n        ├── macos-x64\u002F\n        ├── linux-x64\u002F\n        └── linux-arm64\u002F\n```\n\n---\n\n## 🗝️ Setup API Keys\n\nTo configure your language models, open and edit the environment variables in `data\u002F.env`:\n\n```env\n# Add the keys for the providers you wish to use:\nOPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxx\nOPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxx\nANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx\n```\n\nAlternatively, you can select option **`[2]` (Setup \u002F Reconfigure)** in the Launcher Terminal Menu to configure model providers interactively.\n\n---\n\n## 🖥️ Supported Platforms\n\n| Operating System | CPU Architecture | Setup Status | Notes |\n| :--- | :--- | :--- | :--- |\n| **Windows 10 \u002F 11** | x86_64 | ✅ Supported | Default Powershell ExecutionPolicy bypassed for script |\n| **macOS 13+** | Apple Silicon (ARM64) | ✅ Supported | Native M1\u002FM2\u002FM3 execution |\n| **macOS 13+** | Intel (x86_64) | ✅ Supported | Legacy Intel Mac support |\n| **Linux (Ubuntu\u002FArch\u002FDebian)** | x86_64 | ✅ Supported | Fully self-contained |\n| **Linux (Fedora\u002FCentOS)** | ARM64 | ✅ Supported | Supports SBCs and ARM Servers |\n\n---\n\n## 📦 Cache & Runtime Footprint\n\n| Component | Storage Size | Notes |\n| :--- | :--- | :--- |\n| **Launchers & Scripts** | ~50 KB | Metadata and setup automation scripts |\n| **Per-Platform Runtime** | ~600 – 900 MB | Includes Python, Node, uv, and pip caches |\n| **Hermes Source Code** | ~50 MB | Cloned Git repository |\n| **User Data** | ~10 MB → 2 GB+ | Grows as memory and chat history expand |\n\n> ℹ️ *Note: If you run this folder across multiple operating systems (e.g., Windows at home and macOS at work), the `.cache\u002Fruntimes\u002F` folder will scale to store the respective platforms (~1.8 GB total).*\n\n---\n\n## 🔄 Updating Hermes Agent\n\nKeep your agent up-to-date with the latest improvements from Nous Research:\n\n*   **Via Chat Command**: Within an active Hermes conversation, type:\n    ```text\n    \u002Fhermes update\n    ```\n*   **Via Launcher**: Navigate to `[4] Advanced Options` -> `[5] Update Hermes` in the Launcher terminal dashboard.\n*   **Manual Rebuild**: Delete `.cache\u002Fruntimes\u002F\u003Cyour-platform>` and the `src\u002Fhermes-agent` directory, then re-run the launcher to fetch the latest code from scratch.\n\n---\n\n## 🔒 Security Advisory\n\n> [!WARNING]\n> **Your portable directory contains your identity.**\n> Because `data\u002F.env` stores raw API keys and `data\u002Fsessions\u002F` contains logs of your conversations, anyone with access to your portable drive can access your accounts.\n> \n> *   **Recommended Action**: Encrypt your USB flash drive or SSD using **BitLocker** (Windows), **FileVault** (macOS), or a cross-platform utility like **VeraCrypt**.\n> *   Avoid storing large API balances or production keys on drives you carry daily.\n\n---\n\n## 🔍 Troubleshooting & FAQ\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong> First-run setup fails or times out\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n*   Verify your internet connection (the setup downloads ~600 MB of data).\n*   Some corporate\u002Fschool firewall settings block Node.js CDNs or GitHub releases. Try configuring a VPN.\n*   Delete the `.cache\u002F` folder and launch again to clean-install the runtimes.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong> macOS: \"cannot be opened because the developer cannot be verified\"\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n*   Right-click `launch.sh` (or `launch.command`), choose **Open With** and select **Terminal**.\n*   Alternatively, open terminal and strip macOS quarantine flags using:\n    ```bash\n    xattr -dr com.apple.quarantine \u002Fpath\u002Fto\u002Fhermes-portable\n    ```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong> Windows Defender flags the launcher scripts\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n*   This is a false positive caused by PowerShell scripts downloading files from remote sources (GitHub & Node.js servers).\n*   Click **\"More info\"** on the Windows SmartScreen dialog, then click **\"Run anyway\"**.\n*   The setup scripts are fully open-source and human-readable under the `scripts\u002F` directory for your inspection.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong> Hermes is running slowly from my flash drive\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n*   Older USB 2.0 drives have slow read\u002Fwrite speeds, which bottleneck Python's modules import.\n*   **Solution**: Upgrade to a **USB 3.0 \u002F 3.1** drive, or an **external SSD** for optimal performance.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong> Playwright \u002F Web Browser tools are failing\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n*   Some OS sandboxing policies restrict web browsers (Chromium\u002FFirefox) from starting directly inside external\u002Fremovable directories.\n*   **Solution**: Copy the `hermes-portable` directory onto the local SSD and run from there.\n\u003C\u002Fdetails>\n\n---\n\n## 📝 Credits & Attribution\n\n*   **[Hermes Agent](https:\u002F\u002Fgithub.com\u002FNousResearch\u002Fhermes-agent)** — Powerful Agentic core created by [Nous Research](https:\u002F\u002Fgithub.com\u002FNousResearch).\n*   **[python-build-standalone](https:\u002F\u002Fgithub.com\u002Findygreg\u002Fpython-build-standalone)** — Portable Python interpreter compilation.\n*   **[uv](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv)** — Blazing fast package installer and resolver.\n","Hermes-USB-Portable 是一个可从单一文件夹或USB驱动器运行的全功能自包含AI代理项目。其核心功能包括无需主机依赖即可运行，支持跨平台（Windows、macOS、Linux），并保证用户数据如API密钥、对话记录等完全隔离于便携文件夹内，确保隐私安全。此外，它提供了一个交互式控制台启动器，简化了设置过程，并且保留了Hermes Agent的所有能力，比如记忆存储和技能生成。该项目非常适合需要在不同设备间移动工作环境而不希望安装额外软件或担心数据泄露的开发者和研究者使用。",2,"2026-06-11 03:57:35","CREATED_QUERY"]