{"id":50818101,"url":"https://github.com/ericchansen/hermes-config","last_synced_at":"2026-06-13T11:04:30.878Z","repository":{"id":361543548,"uuid":"1251866533","full_name":"ericchansen/hermes-config","owner":"ericchansen","description":"Portable personal Hermes Agent profile distribution for Windows, WSL2, and Linux","archived":false,"fork":false,"pushed_at":"2026-05-28T01:31:03.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-31T06:27:49.413Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ericchansen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-28T01:31:00.000Z","updated_at":"2026-05-28T01:31:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ericchansen/hermes-config","commit_stats":null,"previous_names":["ericchansen/hermes-config"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ericchansen/hermes-config","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericchansen%2Fhermes-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericchansen%2Fhermes-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericchansen%2Fhermes-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericchansen%2Fhermes-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ericchansen","download_url":"https://codeload.github.com/ericchansen/hermes-config/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericchansen%2Fhermes-config/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34281700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-13T11:04:30.067Z","updated_at":"2026-06-13T11:04:30.870Z","avatar_url":"https://github.com/ericchansen.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hermes-config\n\nPortable personal Hermes Agent profile distribution for Windows native, WSL2, and Linux.\n\nThis repository is an official Hermes **profile distribution**. It packages the portable parts of a Hermes profile:\n\n- `SOUL.md` personal behavior preferences\n- `config.yaml` non-secret config defaults\n- `mcp.json` documented distribution MCP manifest\n- `skills/` personal Hermes skills\n- validation scripts and OS docs\n\nIt deliberately does **not** sync secrets, OAuth tokens, session history, memories, logs, or other machine-local state.\n\n## Install as a Hermes profile\n\nFrom a local checkout:\n\n```bash\nhermes profile install /path/to/hermes-config --name personal --alias -y\nhermes profile use personal\n```\n\nAfter this, run either:\n\n```bash\nhermes -p personal chat\n# or, if --alias created a wrapper:\npersonal chat\n```\n\nAfter the repo is pushed to GitHub, install on another machine with:\n\n```bash\nhermes profile install github.com/ericchansen/hermes-config --name personal --alias\nhermes profile use personal\n```\n\nUpdate later with:\n\n```bash\nhermes profile update personal\n```\n\n## Validate\n\nValidate the installed profile:\n\n```bash\n./scripts/validate.sh --profile personal --require-smoke\n```\n\nValidate the active/default profile:\n\n```bash\n./scripts/validate.sh --require-smoke\n```\n\nThe smoke test asks Hermes to reply with exactly `HERMES_OK` using Copilot `gpt-5.5` and the `safe` toolset.\n\n## What is portable\n\n| Artifact | Source controlled? | Notes |\n| --- | --- | --- |\n| Profile distribution manifest | Yes | `distribution.yaml` |\n| Personality/preferences | Yes | `SOUL.md` |\n| Personal skills | Yes | Installed into the profile's `skills/` directory |\n| Non-secret config defaults | Yes | `config.yaml` |\n| MCP definitions | Yes | `mcp.json` plus `config.yaml` `mcp_servers` for current Hermes runtime |\n| Secrets / OAuth tokens | No | Configure per machine with `hermes auth` / `.env` |\n| Memories, sessions, logs, DBs | No | User-owned runtime state |\n\n## Repository layout\n\n```text\ndistribution.yaml   Hermes profile distribution manifest\nSOUL.md             Personal profile instructions\nconfig.yaml         Non-secret Hermes config defaults\nmcp.json            Distribution MCP manifest\nskills/             Personal Hermes skills\nscripts/            Validation entrypoints\ndocs/               OS-specific setup notes\ntemplates/          Examples only, no secrets\n```\n\n## Supported environments\n\n- Windows native Hermes under Git Bash/MSYS\n- WSL2 Ubuntu\n- Generic Linux\n\nWindows native, WSL2, and Linux are separate Hermes installs. Do not copy `.env` or `auth.json` between them; authenticate each environment independently.\n\n## Principles\n\n- Use official Hermes profile distribution commands for install/update.\n- Keep secrets and auth per-machine.\n- Do not rely on ad hoc local Hermes source edits.\n- Personal profile does not need mandatory secret/PII push scans.\n- Validate real behavior, not just file copies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericchansen%2Fhermes-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fericchansen%2Fhermes-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericchansen%2Fhermes-config/lists"}