hermes-font-scale 0.1.1__tar.gz

hermes_font_scale-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LUKE
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hermes_font_scale-0.1.1/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: hermes-font-scale
+Version: 0.1.1
+Summary: Unofficial community helper — make Hermes Desktop GUI font bigger in one command.
+Author: LUKE
+License: MIT
+Project-URL: Homepage, https://github.com/hsukevin0407-crypto/hermes-font-scale
+Project-URL: Issues, https://github.com/hsukevin0407-crypto/hermes-font-scale/issues
+Keywords: hermes-agent,cli,accessibility,font-size,electron
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# 🐍 hermes-font-scale
+
+> Unofficial community helper — patch **Hermes Desktop GUI** font size in one command, atomically and reversibly.
+> NOT affiliated with [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent).
+
+![Tests](https://img.shields.io/github/actions/workflow/status/hsukevin0407-crypto/hermes-font-scale/test.yml?branch=main&label=tests)
+![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)
+![License](https://img.shields.io/github/license/hsukevin0407-crypto/hermes-font-scale)
+![Version](https://img.shields.io/github/v/release/hsukevin0407-crypto/hermes-font-scale)
+
+---
+
+## ✨ Features
+
+- **Atomic font patch** — rewrites only the `html { font-size: clamp(...) }` line; crash-safe via temp-file + `os.replace()`
+- **Reversible** — `reset` restores from an auto-created `.bak`; `set` is idempotent and skips unnecessary writes
+- **Zero runtime deps** — stdlib only; works on Python 3.9–3.12 across Windows / macOS / Linux
+- **Multi-OS path resolution** — auto-detects Hermes install from `HERMES_HOME`, env var, or 10+ known install paths
+- **Diagnostic `doctor` command** — 4-check health report pinpoints the exact failure before you patch
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+- Python >= 3.9
+
+### Installation
+
+Currently available from source only (PyPI publication pending):
+
+```bash
+pip install "git+https://github.com/hsukevin0407-crypto/hermes-font-scale.git@v0.1.1"
+```
+
+Or clone and install locally:
+
+```bash
+git clone https://github.com/hsukevin0407-crypto/hermes-font-scale.git
+cd hermes-font-scale
+pip install -e .
+```
+
+### Usage
+
+```bash
+# Check current state (run this first)
+hermes-font-scale status
+
+# Set base font size (10–32 px; responsive max is auto-computed)
+hermes-font-scale set 18
+
+# Preview without writing anything
+hermes-font-scale set 18 --dry-run
+
+# Run the 4-check diagnostic
+hermes-font-scale doctor
+
+# Restore the original CSS from the .bak file
+hermes-font-scale reset
+
+# Machine-readable output
+hermes-font-scale status --json
+```
+
+After `set`, **restart Hermes Desktop** to see the change.
+
+---
+
+## 🏗️ Architecture
+
+```mermaid
+graph LR
+    A[CLI: hermes-font-scale] --> B{Command}
+    B -->|set N| C[Locate globals.css]
+    B -->|reset| D[Restore from .bak]
+    B -->|status| E[Read current value]
+    B -->|doctor| F[4-check diagnostic]
+    C --> G[Atomic rewrite via os.replace]
+    G --> H[globals.css patched]
+```
+
+Hermes Desktop hard-codes font size in one CSS anchor:
+
+```css
+/* node_modules/@nous-research/ui/dist/ui/globals.css */
+html {
+  font-size: clamp(14px, calc(14px + 2 * ((100vw - 1400px) / 400)), 18px);
+}
+```
+
+`hermes-font-scale set N` rewrites the two numeric bounds to `N` and `N+4`, preserving responsive behavior. Everything else in the file is untouched.
+
+**Compatibility note:** the official Hermes Desktop installer may bundle `node_modules` inside `app.asar`. Run `hermes-font-scale doctor` — if the "font-size clause present" check fails because the file is inside an ASAR archive, see the [open issue](https://github.com/hsukevin0407-crypto/hermes-font-scale/issues) for workarounds.
+
+---
+
+## 🤝 Contributing
+
+Pull requests are welcome. For major changes, please open an issue first.
+
+```bash
+# Run tests
+pip install pytest pytest-cov
+pytest
+
+# Lint
+pip install ruff
+ruff check src tests
+```
+
+CI runs on Python 3.9, 3.10, 3.11, 3.12 across Ubuntu / Windows / macOS.
+
+## 📄 License
+
+[MIT](LICENSE)
+
+---
+
+> **Disclaimer:** Unofficial community project. Not affiliated with or endorsed by Nous Research. Use at your own risk.

hermes_font_scale-0.1.1/README.md

@@ -0,0 +1,121 @@
+# 🐍 hermes-font-scale
+
+> Unofficial community helper — patch **Hermes Desktop GUI** font size in one command, atomically and reversibly.
+> NOT affiliated with [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent).
+
+![Tests](https://img.shields.io/github/actions/workflow/status/hsukevin0407-crypto/hermes-font-scale/test.yml?branch=main&label=tests)
+![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)
+![License](https://img.shields.io/github/license/hsukevin0407-crypto/hermes-font-scale)
+![Version](https://img.shields.io/github/v/release/hsukevin0407-crypto/hermes-font-scale)
+
+---
+
+## ✨ Features
+
+- **Atomic font patch** — rewrites only the `html { font-size: clamp(...) }` line; crash-safe via temp-file + `os.replace()`
+- **Reversible** — `reset` restores from an auto-created `.bak`; `set` is idempotent and skips unnecessary writes
+- **Zero runtime deps** — stdlib only; works on Python 3.9–3.12 across Windows / macOS / Linux
+- **Multi-OS path resolution** — auto-detects Hermes install from `HERMES_HOME`, env var, or 10+ known install paths
+- **Diagnostic `doctor` command** — 4-check health report pinpoints the exact failure before you patch
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+- Python >= 3.9
+
+### Installation
+
+Currently available from source only (PyPI publication pending):
+
+```bash
+pip install "git+https://github.com/hsukevin0407-crypto/hermes-font-scale.git@v0.1.1"
+```
+
+Or clone and install locally:
+
+```bash
+git clone https://github.com/hsukevin0407-crypto/hermes-font-scale.git
+cd hermes-font-scale
+pip install -e .
+```
+
+### Usage
+
+```bash
+# Check current state (run this first)
+hermes-font-scale status
+
+# Set base font size (10–32 px; responsive max is auto-computed)
+hermes-font-scale set 18
+
+# Preview without writing anything
+hermes-font-scale set 18 --dry-run
+
+# Run the 4-check diagnostic
+hermes-font-scale doctor
+
+# Restore the original CSS from the .bak file
+hermes-font-scale reset
+
+# Machine-readable output
+hermes-font-scale status --json
+```
+
+After `set`, **restart Hermes Desktop** to see the change.
+
+---
+
+## 🏗️ Architecture
+
+```mermaid
+graph LR
+    A[CLI: hermes-font-scale] --> B{Command}
+    B -->|set N| C[Locate globals.css]
+    B -->|reset| D[Restore from .bak]
+    B -->|status| E[Read current value]
+    B -->|doctor| F[4-check diagnostic]
+    C --> G[Atomic rewrite via os.replace]
+    G --> H[globals.css patched]
+```
+
+Hermes Desktop hard-codes font size in one CSS anchor:
+
+```css
+/* node_modules/@nous-research/ui/dist/ui/globals.css */
+html {
+  font-size: clamp(14px, calc(14px + 2 * ((100vw - 1400px) / 400)), 18px);
+}
+```
+
+`hermes-font-scale set N` rewrites the two numeric bounds to `N` and `N+4`, preserving responsive behavior. Everything else in the file is untouched.
+
+**Compatibility note:** the official Hermes Desktop installer may bundle `node_modules` inside `app.asar`. Run `hermes-font-scale doctor` — if the "font-size clause present" check fails because the file is inside an ASAR archive, see the [open issue](https://github.com/hsukevin0407-crypto/hermes-font-scale/issues) for workarounds.
+
+---
+
+## 🤝 Contributing
+
+Pull requests are welcome. For major changes, please open an issue first.
+
+```bash
+# Run tests
+pip install pytest pytest-cov
+pytest
+
+# Lint
+pip install ruff
+ruff check src tests
+```
+
+CI runs on Python 3.9, 3.10, 3.11, 3.12 across Ubuntu / Windows / macOS.
+
+## 📄 License
+
+[MIT](LICENSE)
+
+---
+
+> **Disclaimer:** Unofficial community project. Not affiliated with or endorsed by Nous Research. Use at your own risk.

hermes_font_scale-0.1.1/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hermes-font-scale"
+version = "0.1.1"
+description = "Unofficial community helper — make Hermes Desktop GUI font bigger in one command."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "LUKE" }]
+keywords = ["hermes-agent", "cli", "accessibility", "font-size", "electron"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Utilities",
+]
+# Intentionally zero runtime deps — stdlib only.
+dependencies = []
+
+[project.scripts]
+hermes-font-scale = "hermes_font_scale.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/hsukevin0407-crypto/hermes-font-scale"
+Issues = "https://github.com/hsukevin0407-crypto/hermes-font-scale/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+hermes_font_scale = ["py.typed"]
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+testpaths = ["tests"]
+addopts = "-v --tb=short"
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP"]
+ignore = ["E501"]

hermes_font_scale-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

hermes_font_scale-0.1.1/src/hermes_font_scale/__init__.py

@@ -0,0 +1,12 @@
+"""hermes-font-scale: Unofficial community helper for Hermes Desktop font size.
+
+Public API:
+    CLI entry point: ``hermes-font-scale`` (see cli.main)
+"""
+
+from __future__ import annotations
+
+from .constants import VERSION
+
+__version__ = VERSION
+__all__ = ["__version__"]

hermes_font_scale-0.1.1/src/hermes_font_scale/__main__.py

@@ -0,0 +1,8 @@
+"""Entry point so ``python -m hermes_font_scale`` works."""
+
+from __future__ import annotations
+
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

hermes_font_scale-0.1.1/src/hermes_font_scale/cli.py

@@ -0,0 +1,190 @@
+"""Command-line interface for hermes-font-scale.
+
+Subcommands:
+  set <PX>   set font size (10..32)
+  reset      restore from .bak
+  status     print current state
+  doctor     run 4 diagnostic checks
+
+Common flags:
+  --hermes-home PATH   override install root
+  --dry-run            show what would happen without writing
+  --json               machine-readable output for status
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+# On Windows, the default console codepage is often cp1252 which chokes on
+# the non-ASCII strings we use in messages. Reconfigure stdout/stderr to
+# UTF-8 so help text and error messages don't crash the CLI.
+#
+# Skip this when running under pytest — capsys replaces stdout/stderr
+# and reconfigure() breaks the capture machinery.
+if os.name == "nt" and not os.environ.get("PYTEST_CURRENT_TEST"):
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[attr-defined]
+    except (AttributeError, OSError):
+        pass
+
+from . import __version__
+from . import doctor as doctor_mod
+from . import scale as scale_mod
+from .constants import MAX_PX, MIN_PX
+from .locate import HermesNotFound, locate_globals_css, _display_path
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="hermes-font-scale",
+        description=(
+            "Unofficial community helper — make Hermes Desktop GUI font "
+            "bigger in one command. NOT part of NousResearch/hermes-agent."
+        ),
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"hermes-font-scale {__version__}",
+    )
+    parser.add_argument(
+        "--hermes-home",
+        type=Path,
+        default=None,
+        help="Path to Hermes install root (overrides HERMES_HOME and search).",
+    )
+
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p_set = sub.add_parser("set", help=f"Set font size in px (range {MIN_PX}..{MAX_PX}).")
+    p_set.add_argument("px", type=int, help=f"Target base font size in px ({MIN_PX}..{MAX_PX}).")
+    p_set.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Show diff without writing anything.",
+    )
+
+    sub.add_parser("reset", help="Restore globals.css from the .bak file (if any).")
+
+    p_status = sub.add_parser("status", help="Show current patch state.")
+    p_status.add_argument("--json", action="store_true", help="Print JSON instead of text.")
+
+    sub.add_parser("doctor", help="Run 4 diagnostic checks.")
+
+    return parser
+
+
+def _resolve_css(args: argparse.Namespace) -> Path:
+    try:
+        return locate_globals_css(hermes_home=args.hermes_home)
+    except HermesNotFound as exc:
+        print(str(exc), file=sys.stderr)
+        raise SystemExit(2)
+
+
+def cmd_set(args: argparse.Namespace) -> int:
+    css = _resolve_css(args)
+    try:
+        if args.dry_run:
+            before, after = scale_mod.diff_lines(css, args.px)
+            print(f"--- {css}")
+            print(f"- {before}")
+            print(f"+ {after}")
+            print("(dry run — no changes written)")
+            return 0
+
+        result = scale_mod.patch_css(css, args.px, dry_run=False)
+        if result.old_base == result.new_base:
+            print(f"already at {result.new_base}px — nothing to do")
+            return 0
+        backup_note = " (backup created)" if result.backup_created else ""
+        print(
+            f"patched {css.name}: "
+            f"{result.old_base}px → {result.new_base}px{backup_note}\n"
+            f"restart Hermes Desktop to see the change."
+        )
+        return 0
+    except scale_mod.FontSizeOutOfRange as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 2
+    except scale_mod.FontSizeClauseNotFound as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 3
+    except PermissionError as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 4
+
+
+def cmd_reset(args: argparse.Namespace) -> int:
+    css = _resolve_css(args)
+    if scale_mod.reset_css(css):
+        print(f"restored {css.name} from backup. restart Hermes Desktop.")
+        return 0
+    print(f"no backup found at {css.name}.bak — nothing to restore.")
+    return 1
+
+
+def cmd_status(args: argparse.Namespace) -> int:
+    try:
+        css = locate_globals_css(hermes_home=args.hermes_home)
+    except HermesNotFound as exc:
+        if args.json:
+            print(json.dumps({"ok": False, "error": str(exc)}))
+        else:
+            print(str(exc), file=sys.stderr)
+        return 2
+
+    base = scale_mod.read_current_base(css)
+    backup = css.with_name(css.name + ".bak")
+    payload = {
+        "ok": True,
+        "css_path": _display_path(css),
+        "current_base_px": base,
+        "backup_exists": backup.exists(),
+    }
+    if args.json:
+        print(json.dumps(payload, indent=2))
+    else:
+        print(f"css:          {payload['css_path']}")
+        print(f"current base: {payload['current_base_px']}px")
+        print(f"backup:       {'yes' if payload['backup_exists'] else 'no'}")
+    return 0
+
+
+def cmd_doctor(args: argparse.Namespace) -> int:
+    css = None
+    try:
+        css = locate_globals_css(hermes_home=args.hermes_home)
+    except HermesNotFound:
+        # doctor must still report something useful when locate fails.
+        pass
+
+    results = doctor_mod.run_all(css)
+    for r in results:
+        print(r.render())
+    return 0 if doctor_mod.all_passed(results) else 1
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = _build_parser()
+    args = parser.parse_args(argv)
+    if args.command == "set":
+        return cmd_set(args)
+    if args.command == "reset":
+        return cmd_reset(args)
+    if args.command == "status":
+        return cmd_status(args)
+    if args.command == "doctor":
+        return cmd_doctor(args)
+    parser.error(f"unknown command: {args.command}")
+    return 2  # unreachable, but keeps type-checkers happy
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

hermes_font_scale-0.1.1/src/hermes_font_scale/constants.py

@@ -0,0 +1,99 @@
+"""Constants for hermes-font-scale.
+
+Single source of truth for paths, ranges, and supported versions.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+__all__ = [
+    "VERSION",
+    "MIN_PX",
+    "MAX_PX",
+    "DEFAULT_BASE_PX",
+    "PX_DELTA_MAX",
+    "FONT_SIZE_REGEX",
+    "REPLACEMENT_TEMPLATE",
+    "BACKUP_SUFFIX",
+    "SUPPORTED_HERMES_MAJOR",
+    "CSS_RELATIVE_PATH_COMPONENTS",
+    "WINDOWS_SEARCH_PATHS",
+    "MACOS_SEARCH_PATHS",
+    "LINUX_SEARCH_PATHS",
+]
+
+VERSION = "0.1.1"
+
+# Font size range (px). Outside this range we reject with a clear error.
+MIN_PX = 10
+MAX_PX = 32
+
+# Original Hermes base font size (line 379 of globals.css).
+DEFAULT_BASE_PX = 14
+
+# Original max-min delta (18 - 14 = 4). We preserve this so the responsive
+# scaling behavior remains identical, just shifted.
+PX_DELTA_MAX = 4
+
+# Regex matching the exact font-size clause from Hermes Desktop's globals.css.
+# Captures: (1) base px, (2) unused (the calc body), (3) max px.
+FONT_SIZE_REGEX = (
+    r"font-size\s*:\s*clamp\(\s*(\d+)px\s*,\s*"
+    r"calc\(\s*\d+px\s*\+\s*2\s*\*\s*\(\(100vw\s*-\s*1400px\)\s*/\s*400\)\s*\)\s*,\s*"
+    r"(\d+)px\s*\)"
+)
+
+# Replacement template. Caller fills {base} and {max}.
+REPLACEMENT_TEMPLATE = "font-size: clamp({base}px, calc({base}px + 2 * ((100vw - 1400px) / 400)), {max}px)"
+
+BACKUP_SUFFIX = ".bak"
+
+# Minimum Hermes major version we support (the @nous-research/ui package
+# was extracted around this version).
+SUPPORTED_HERMES_MAJOR = 1
+
+# Relative path components from Hermes install root to globals.css.
+# Each entry is a candidate (some installs unpack @nous-research/ui, others don't).
+CSS_RELATIVE_CANDIDATES: list[tuple[str, ...]] = [
+    # Production installer (asar unpacked)
+    (
+        "resources", "app.asar.unpacked", "node_modules",
+        "@nous-research", "ui", "dist", "ui", "globals.css",
+    ),
+    # Dev checkout
+    (
+        "apps", "desktop", "node_modules",
+        "@nous-research", "ui", "dist", "ui", "globals.css",
+    ),
+    # Top-level dev checkout (monorepo root)
+    (
+        "node_modules", "@nous-research", "ui", "dist", "ui", "globals.css",
+    ),
+]
+
+
+def _join(*parts: str) -> Path:
+    return Path(*parts)
+
+
+# Windows search roots (relative to known locations).
+WINDOWS_SEARCH_ROOTS: list[Path] = [
+    Path.home() / "AppData" / "Local" / "hermes",
+    Path("C:") / "Program Files" / "Hermes",
+    Path("C:") / "Program Files (x86)" / "Hermes",
+]
+
+# macOS search roots.
+MACOS_SEARCH_ROOTS: list[Path] = [
+    Path("/Applications/Hermes.app/Contents/Resources"),
+    Path.home() / "Applications" / "Hermes.app" / "Contents" / "Resources",
+]
+
+# Linux search roots.
+LINUX_SEARCH_ROOTS: list[Path] = [
+    Path.home() / ".local" / "share" / "hermes",
+    Path("/opt/hermes"),
+    Path("/usr/local/share/hermes"),
+    Path("/usr/share/hermes"),
+]