hermes-profile-kit 3.0.0__tar.gz

hermes_profile_kit-3.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hermes-profile-kit contributors
+
+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_profile_kit-3.0.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: hermes-profile-kit
+Version: 3.0.0
+Summary: Interactive multi-profile setup utility for Hermes Agent
+Author: NewTurn2017
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: packaging>=23
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13
+Requires-Dist: pyyaml>=6
+Requires-Dist: pydantic>=2
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-mock>=3; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
+Dynamic: license-file
+
+# hermes-profile-kit
+
+Interactive multi-profile setup utility for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![CI](https://github.com/NewTurn2017/hermes-profile-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/NewTurn2017/hermes-profile-kit/actions/workflows/ci.yml)
+
+> 🇰🇷 [한국어 README](README.ko.md)
+
+## Quick start
+
+```bash
+pipx install hermes-profile-kit
+hpk setup
+```
+
+The wizard walks you through 4 profiles (`coder` / `assistant` / `research` / `community-bot`), prompts for the right tokens per channel (Anthropic, Telegram, Slack, Discord, Brave, Exa), and optionally enables recommended plugins (Honcho memory, Brave search tool).
+
+## What hpk does (and doesn't)
+
+- ✅ Creates and configures four isolated Hermes profiles.
+- ✅ Walks you through BotFather, Slack app, Discord devportal flows.
+- ✅ Atomic, idempotent `.env` writes (chmod 600). Re-running is safe.
+- ✅ Daily upstream-sync via GitHub Actions — kit stays current with Hermes changes.
+- ❌ Does not install Hermes itself (see [Hermes installation](https://github.com/NousResearch/hermes-agent#installation)).
+- ❌ Does not start gateway services automatically.
+- ❌ Does not invoke any hermes command that isn't verified in upstream.
+
+## How it stays correct
+
+`hpk` never embeds a hermes command that hasn't been observed in the upstream argparse tree. CI AST-parses `hermes_cli/main.py` daily, regenerates `docs/commands.md` and `build/cmd_index.json`, and opens a PR when drift is detected.
+
+## Profiles
+
+| Profile | Role | Model tier | Channels |
+|---|---|---|---|
+| `coder` | Full-stack dev assistant | Sonnet | CLI |
+| `assistant` | Personal daily assistant | Sonnet | CLI + Telegram |
+| `research` | Web-search-backed research | Opus | CLI |
+| `community-bot` | Korean dev community helper | Haiku | Telegram + Discord |
+
+## Customization
+
+| Goal | Edit |
+|---|---|
+| Change model | `~/.hermes/profiles/<name>/config.yaml` |
+| Change persona | `~/.hermes/profiles/<name>/SOUL.md` |
+| Add new profile | `profiles/<name>/{SOUL.md,config.yaml,.env.example}` + add to `manifest.yaml` → `hpk setup` |
+| Enable a plugin | Add to `manifest.yaml` `plugins:` + reference from `recommended_plugins` |
+
+API keys go in `~/.hermes/profiles/<name>/.env`. They're plain text with `chmod 600` — the kit deliberately does not pretend to encrypt them.
+
+## Commands
+
+```bash
+hpk setup [profile...]    # interactive wizard
+hpk verify                # doctor + FILL_IN scan
+hpk doctor                # hpk's own health
+hpk reset [profile...]    # remove kit-created profiles
+hpk plugin list           # show recommended_plugins
+hpk sync --dry-run        # local drift check
+```
+
+## License
+
+MIT. See `LICENSE`.

hermes_profile_kit-3.0.0/README.md

@@ -0,0 +1,66 @@
+# hermes-profile-kit
+
+Interactive multi-profile setup utility for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![CI](https://github.com/NewTurn2017/hermes-profile-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/NewTurn2017/hermes-profile-kit/actions/workflows/ci.yml)
+
+> 🇰🇷 [한국어 README](README.ko.md)
+
+## Quick start
+
+```bash
+pipx install hermes-profile-kit
+hpk setup
+```
+
+The wizard walks you through 4 profiles (`coder` / `assistant` / `research` / `community-bot`), prompts for the right tokens per channel (Anthropic, Telegram, Slack, Discord, Brave, Exa), and optionally enables recommended plugins (Honcho memory, Brave search tool).
+
+## What hpk does (and doesn't)
+
+- ✅ Creates and configures four isolated Hermes profiles.
+- ✅ Walks you through BotFather, Slack app, Discord devportal flows.
+- ✅ Atomic, idempotent `.env` writes (chmod 600). Re-running is safe.
+- ✅ Daily upstream-sync via GitHub Actions — kit stays current with Hermes changes.
+- ❌ Does not install Hermes itself (see [Hermes installation](https://github.com/NousResearch/hermes-agent#installation)).
+- ❌ Does not start gateway services automatically.
+- ❌ Does not invoke any hermes command that isn't verified in upstream.
+
+## How it stays correct
+
+`hpk` never embeds a hermes command that hasn't been observed in the upstream argparse tree. CI AST-parses `hermes_cli/main.py` daily, regenerates `docs/commands.md` and `build/cmd_index.json`, and opens a PR when drift is detected.
+
+## Profiles
+
+| Profile | Role | Model tier | Channels |
+|---|---|---|---|
+| `coder` | Full-stack dev assistant | Sonnet | CLI |
+| `assistant` | Personal daily assistant | Sonnet | CLI + Telegram |
+| `research` | Web-search-backed research | Opus | CLI |
+| `community-bot` | Korean dev community helper | Haiku | Telegram + Discord |
+
+## Customization
+
+| Goal | Edit |
+|---|---|
+| Change model | `~/.hermes/profiles/<name>/config.yaml` |
+| Change persona | `~/.hermes/profiles/<name>/SOUL.md` |
+| Add new profile | `profiles/<name>/{SOUL.md,config.yaml,.env.example}` + add to `manifest.yaml` → `hpk setup` |
+| Enable a plugin | Add to `manifest.yaml` `plugins:` + reference from `recommended_plugins` |
+
+API keys go in `~/.hermes/profiles/<name>/.env`. They're plain text with `chmod 600` — the kit deliberately does not pretend to encrypt them.
+
+## Commands
+
+```bash
+hpk setup [profile...]    # interactive wizard
+hpk verify                # doctor + FILL_IN scan
+hpk doctor                # hpk's own health
+hpk reset [profile...]    # remove kit-created profiles
+hpk plugin list           # show recommended_plugins
+hpk sync --dry-run        # local drift check
+```
+
+## License
+
+MIT. See `LICENSE`.

hermes_profile_kit-3.0.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hermes-profile-kit"
+version = "3.0.0"
+description = "Interactive multi-profile setup utility for Hermes Agent"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "NewTurn2017" }]
+dependencies = [
+  "click>=8.1",
+  "packaging>=23",
+  "questionary>=2.0",
+  "rich>=13",
+  "pyyaml>=6",
+  "pydantic>=2",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-mock>=3", "ruff>=0.5", "mypy>=1.10", "types-PyYAML"]
+
+[project.scripts]
+hpk = "hpk.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+hpk = ["py.typed"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "RUF"]
+
+[tool.mypy]
+strict = true
+files = ["src/hpk"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra -q"

hermes_profile_kit-3.0.0/setup.cfg

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

hermes_profile_kit-3.0.0/src/hermes_profile_kit.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: hermes-profile-kit
+Version: 3.0.0
+Summary: Interactive multi-profile setup utility for Hermes Agent
+Author: NewTurn2017
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: packaging>=23
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13
+Requires-Dist: pyyaml>=6
+Requires-Dist: pydantic>=2
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-mock>=3; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
+Dynamic: license-file
+
+# hermes-profile-kit
+
+Interactive multi-profile setup utility for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![CI](https://github.com/NewTurn2017/hermes-profile-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/NewTurn2017/hermes-profile-kit/actions/workflows/ci.yml)
+
+> 🇰🇷 [한국어 README](README.ko.md)
+
+## Quick start
+
+```bash
+pipx install hermes-profile-kit
+hpk setup
+```
+
+The wizard walks you through 4 profiles (`coder` / `assistant` / `research` / `community-bot`), prompts for the right tokens per channel (Anthropic, Telegram, Slack, Discord, Brave, Exa), and optionally enables recommended plugins (Honcho memory, Brave search tool).
+
+## What hpk does (and doesn't)
+
+- ✅ Creates and configures four isolated Hermes profiles.
+- ✅ Walks you through BotFather, Slack app, Discord devportal flows.
+- ✅ Atomic, idempotent `.env` writes (chmod 600). Re-running is safe.
+- ✅ Daily upstream-sync via GitHub Actions — kit stays current with Hermes changes.
+- ❌ Does not install Hermes itself (see [Hermes installation](https://github.com/NousResearch/hermes-agent#installation)).
+- ❌ Does not start gateway services automatically.
+- ❌ Does not invoke any hermes command that isn't verified in upstream.
+
+## How it stays correct
+
+`hpk` never embeds a hermes command that hasn't been observed in the upstream argparse tree. CI AST-parses `hermes_cli/main.py` daily, regenerates `docs/commands.md` and `build/cmd_index.json`, and opens a PR when drift is detected.
+
+## Profiles
+
+| Profile | Role | Model tier | Channels |
+|---|---|---|---|
+| `coder` | Full-stack dev assistant | Sonnet | CLI |
+| `assistant` | Personal daily assistant | Sonnet | CLI + Telegram |
+| `research` | Web-search-backed research | Opus | CLI |
+| `community-bot` | Korean dev community helper | Haiku | Telegram + Discord |
+
+## Customization
+
+| Goal | Edit |
+|---|---|
+| Change model | `~/.hermes/profiles/<name>/config.yaml` |
+| Change persona | `~/.hermes/profiles/<name>/SOUL.md` |
+| Add new profile | `profiles/<name>/{SOUL.md,config.yaml,.env.example}` + add to `manifest.yaml` → `hpk setup` |
+| Enable a plugin | Add to `manifest.yaml` `plugins:` + reference from `recommended_plugins` |
+
+API keys go in `~/.hermes/profiles/<name>/.env`. They're plain text with `chmod 600` — the kit deliberately does not pretend to encrypt them.
+
+## Commands
+
+```bash
+hpk setup [profile...]    # interactive wizard
+hpk verify                # doctor + FILL_IN scan
+hpk doctor                # hpk's own health
+hpk reset [profile...]    # remove kit-created profiles
+hpk plugin list           # show recommended_plugins
+hpk sync --dry-run        # local drift check
+```
+
+## License
+
+MIT. See `LICENSE`.

hermes_profile_kit-3.0.0/src/hermes_profile_kit.egg-info/SOURCES.txt

@@ -0,0 +1,44 @@
+LICENSE
+README.md
+pyproject.toml
+src/hermes_profile_kit.egg-info/PKG-INFO
+src/hermes_profile_kit.egg-info/SOURCES.txt
+src/hermes_profile_kit.egg-info/dependency_links.txt
+src/hermes_profile_kit.egg-info/entry_points.txt
+src/hermes_profile_kit.egg-info/requires.txt
+src/hermes_profile_kit.egg-info/top_level.txt
+src/hpk/__init__.py
+src/hpk/__main__.py
+src/hpk/cli.py
+src/hpk/hermes.py
+src/hpk/manifest.py
+src/hpk/plugins.py
+src/hpk/profiles.py
+src/hpk/py.typed
+src/hpk/ui.py
+src/hpk/verify.py
+src/hpk/wizard.py
+src/hpk/codegen/__init__.py
+src/hpk/codegen/argparse_walker.py
+src/hpk/codegen/cmd_index.py
+src/hpk/codegen/validate.py
+src/hpk/tokens/__init__.py
+src/hpk/tokens/anthropic.py
+src/hpk/tokens/base.py
+src/hpk/tokens/brave.py
+src/hpk/tokens/discord.py
+src/hpk/tokens/exa.py
+src/hpk/tokens/openai_codex.py
+src/hpk/tokens/slack.py
+src/hpk/tokens/telegram.py
+tests/test_cli.py
+tests/test_codegen.py
+tests/test_drift_report.py
+tests/test_hermes.py
+tests/test_manifest.py
+tests/test_plugins.py
+tests/test_profiles.py
+tests/test_ui.py
+tests/test_update_pin.py
+tests/test_verify.py
+tests/test_wizard.py

hermes_profile_kit-3.0.0/src/hermes_profile_kit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hermes_profile_kit-3.0.0/src/hermes_profile_kit.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hpk = hpk.cli:main

hermes_profile_kit-3.0.0/src/hermes_profile_kit.egg-info/requires.txt

@@ -0,0 +1,13 @@
+click>=8.1
+packaging>=23
+questionary>=2.0
+rich>=13
+pyyaml>=6
+pydantic>=2
+
+[dev]
+pytest>=8
+pytest-mock>=3
+ruff>=0.5
+mypy>=1.10
+types-PyYAML

hermes_profile_kit-3.0.0/src/hermes_profile_kit.egg-info/top_level.txt

@@ -0,0 +1 @@
+hpk

hermes_profile_kit-3.0.0/src/hpk/__init__.py

@@ -0,0 +1,3 @@
+"""hermes-profile-kit — interactive multi-profile setup for Hermes Agent."""
+
+__version__ = "3.0.0"

hermes_profile_kit-3.0.0/src/hpk/__main__.py

@@ -0,0 +1,4 @@
+from hpk.cli import main
+
+if __name__ == "__main__":
+    main()

hermes_profile_kit-3.0.0/src/hpk/cli.py

@@ -0,0 +1,176 @@
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import click
+
+from hpk import __version__, ui, verify, wizard
+from hpk.manifest import Manifest, ManifestValidationError, load_manifest
+
+
+def _manifest_path() -> Path:
+    return Path.cwd() / "manifest.yaml"
+
+
+def _load() -> Manifest:
+    try:
+        return load_manifest(_manifest_path())
+    except ManifestValidationError as e:
+        ui.err(f"manifest invalid: {e}")
+        sys.exit(40)
+    except FileNotFoundError:
+        ui.err(f"manifest.yaml not found at {_manifest_path()}")
+        sys.exit(40)
+
+
+@click.group(invoke_without_command=True)
+@click.version_option(version=__version__, prog_name="hpk")
+@click.pass_context
+def main(ctx: click.Context) -> None:
+    """hpk — interactive multi-profile setup for Hermes Agent."""
+    if ctx.invoked_subcommand is None:
+        ctx.invoke(setup)
+
+
+@main.command()
+@click.argument("profile", nargs=-1)
+@click.option("--force", is_flag=True, help="Overwrite SOUL.md/config.yaml even if present.")
+@click.option("--skip-tokens", is_flag=True)
+@click.option("--skip-plugins", is_flag=True)
+def setup(
+    profile: tuple[str, ...],
+    force: bool,
+    skip_tokens: bool,
+    skip_plugins: bool,
+) -> None:
+    """Interactive multi-profile setup."""
+    manifest = _load()
+    try:
+        wizard.run_wizard(
+            manifest,
+            targets=list(profile),
+            force=force,
+            skip_tokens=skip_tokens,
+            skip_plugins=skip_plugins,
+        )
+    except wizard.HermesNotInstalledError as e:
+        ui.err(str(e))
+        sys.exit(10)
+    except wizard.HermesVersionTooOldError as e:
+        ui.err(str(e))
+        sys.exit(11)
+    except wizard.PreflightError as e:
+        ui.err(str(e))
+        sys.exit(30)
+
+
+@main.command()
+@click.argument("profile", nargs=-1)
+def verify_cmd(profile: tuple[str, ...]) -> None:
+    """Run hermes doctor + FILL_IN scan."""
+    manifest = _load()
+    names = list(profile) or [p.name for p in manifest.profiles]
+    r = verify.run_verify(names)
+    for name in r.passing:
+        ui.ok(f"{name}: doctor green")
+    for name, reason in r.failing:
+        ui.err(f"{name}: {reason}")
+    for name, rows in r.fill_in_remaining.items():
+        for line, key in rows:
+            ui.warn(f"{name}/.env:{line}: {key} still FILL_IN")
+    sys.exit(0 if r.ok else 30)
+
+
+@main.command()
+def doctor() -> None:
+    """Check hpk's own health: hermes presence, manifest validity, codegen freshness."""
+    manifest = _load()
+    from hpk import hermes as _h
+
+    try:
+        v = _h.get_version()
+        ui.ok(f"hermes {v}")
+    except _h.HermesNotFoundError:
+        ui.err("hermes not found")
+        sys.exit(10)
+    ui.ok(f"manifest valid; pinned to {manifest.upstream.pinned_commit}")
+
+
+@main.command()
+@click.argument("profile", nargs=-1)
+@click.option("--yes", is_flag=True, help="Skip confirmation.")
+@click.option("--backup", is_flag=True, help="Export profile before deleting.")
+def reset(profile: tuple[str, ...], yes: bool, backup: bool) -> None:
+    """Remove profiles created by this kit (never touches default ~/.hermes/)."""
+    manifest = _load()
+    names = list(profile) or [p.name for p in manifest.profiles]
+    if not yes:
+        click.confirm(f"Really delete profiles: {', '.join(names)}?", abort=True)
+    from hpk import hermes as _h
+
+    for n in names:
+        if backup:
+            _h.run_raw(["hermes", "profile", "export", n])
+        _h.run_raw(["hermes", "profile", "delete", n, "--yes"])
+        ui.ok(f"deleted {n}")
+
+
+@main.group()
+def plugin() -> None:
+    """List, enable, or disable manifest-declared recommended plugins."""
+
+
+@plugin.command("list")
+def plugin_list() -> None:
+    manifest = _load()
+    for p in manifest.profiles:
+        ids = [rp.id for rp in p.recommended_plugins]
+        ui.console.print(f"  {p.name}: {ids or '(none)'}")
+
+
+@plugin.command("enable")
+@click.argument("profile")
+@click.argument("plugin_id")
+def plugin_enable(profile: str, plugin_id: str) -> None:
+    manifest = _load()
+    plugins_catalog = manifest.plugins
+    if plugin_id not in plugins_catalog:
+        ui.err(f"unknown plugin: {plugin_id}")
+        sys.exit(40)
+    from hpk import plugins as _p
+
+    _p.run_plugin(plugins_catalog[plugin_id], profile=profile)
+    ui.ok(f"enabled {plugin_id} for {profile}")
+
+
+@plugin.command("disable")
+@click.argument("profile")
+@click.argument("plugin_id")
+def plugin_disable(profile: str, plugin_id: str) -> None:
+    ui.warn(f"manual disable required for {plugin_id} on {profile}; see plugin docs")
+
+
+@main.command()
+@click.option(
+    "--upstream",
+    type=click.Path(exists=True, file_okay=False, path_type=Path),
+    help="Path to a local hermes-agent clone. Without it, sync prints guidance and exits.",
+)
+@click.option("--dry-run", is_flag=True, help="Run --check mode (no writes).")
+def sync(upstream: Path | None, dry_run: bool) -> None:
+    """Local upstream-drift check (CI does it daily). Requires an upstream clone."""
+    import subprocess as _sp
+
+    if upstream is None:
+        ui.warn("hpk sync needs --upstream PATH (a local hermes-agent clone).")
+        ui.warn("CI's daily upstream-sync workflow does this automatically.")
+        sys.exit(0)
+    cmd = [sys.executable, "scripts/regen_docs.py", "--upstream", str(upstream)]
+    if dry_run:
+        cmd.append("--check")
+    r = _sp.run(cmd)
+    sys.exit(50 if r.returncode else 0)
+
+
+main.add_command(verify_cmd, name="verify")