mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-06 02:41:48 +00:00
c5789f4309
* feat(achievements): share card render on unlocked badges Adds a Share button to each unlocked achievement card that opens a modal and renders a 1200x630 PNG share card client-side via Canvas2D (no backend, no network, no new deps). Two actions: Download PNG and Copy image to clipboard. Card layout mirrors the in-dashboard visual language: tier-colored glow, icon from the existing LUCIDE sprite set, achievement name, tier badge pill, description, progress stat line, and a Hermes Agent watermark. Sized for X/Twitter, Discord, LinkedIn, Bluesky link previews. Vendored on top of the upstream @PCinkusz bundle; the 'in-progress scan banner' precedent already established this divergence pattern. Manifest bumped 0.3.1 -> 0.4.0. * feat(achievements): share-on-X as primary action on share dialog Adds a 'Share on X' button as the primary action in the share dialog. Opens https://x.com/intent/post with a pre-filled tweet referencing the achievement name, tier, @NousResearch, and the Hermes docs URL. Copy image and Download PNG become secondary actions: users who want the badge attached can Copy image, paste into the X composer, post. Primary button styled as X's signature black-on-white fill so the action is unambiguous.
150 lines
4.8 KiB
Markdown
150 lines
4.8 KiB
Markdown
# Hermes Achievements
|
||
|
||
> **Bundled with Hermes Agent.** Originally authored by [@PCinkusz](https://github.com/PCinkusz) at https://github.com/PCinkusz/hermes-achievements — vendored into `plugins/hermes-achievements/` so it ships with the dashboard out-of-the-box and stays in lockstep with Hermes feature changes. Upstream repo remains the staging ground for new badges and UI iteration.
|
||
>
|
||
> When Hermes is installed via `pip install hermes-agent` or cloned from source, this plugin auto-registers as a dashboard tab on first `hermes dashboard` launch. No separate install step. See [Built-in Plugins → hermes-achievements](../../website/docs/user-guide/features/built-in-plugins.md) in the main docs.
|
||
|
||
Achievement system for the Hermes Dashboard: collectible, tiered badges generated from real local Hermes session history.
|
||
|
||
|
||
|
||
The screenshots use temporary demo tier data to show the full visual range. The plugin itself reads real local Hermes session history by default.
|
||
|
||
> **Update notice (2026-04-29):** If you installed this plugin before today, update to the latest version. The achievements scan path was refactored for much faster warm loads (snapshot cache + incremental checkpoint scan).
|
||
>
|
||
> **Share cards (2026-05-04, vendored in hermes-agent v0.4.0):** Unlocked achievement cards now have a "Share" button that renders a 1200×630 PNG share card (client-side canvas, no backend, no network) with Download + Copy-to-clipboard actions. Fits X/Twitter, Discord, LinkedIn, Bluesky link-preview dimensions.
|
||
|
||
## What it does
|
||
|
||
Hermes Achievements scans local Hermes sessions and unlocks badges based on real agent behavior:
|
||
|
||
- autonomous tool chains
|
||
- debugging and recovery patterns
|
||
- vibe-coding file edits
|
||
- Hermes-native skills, memory, cron, and plugin usage
|
||
- web research and browser automation
|
||
- model/provider workflows
|
||
- lifestyle patterns such as weekend or night sessions
|
||
|
||
Achievements have three visible states:
|
||
|
||
- **Unlocked** — earned at least one tier
|
||
- **Discovered** — known achievement, progress visible, not earned yet
|
||
- **Secret** — hidden until Hermes detects the first related signal
|
||
|
||
Most achievements level through:
|
||
|
||
```text
|
||
Copper → Silver → Gold → Diamond → Olympian
|
||
```
|
||
|
||
Each card has a collapsible **What counts** section showing the exact tracked metric or requirement once the user wants details.
|
||
|
||
Version `0.2.x` expands the catalog to 60+ achievements, including model/provider badges such as **Five-Model Flight**, **Provider Polyglot**, **Claude Confidant**, **Gemini Cartographer**, and **Open Weights Pilgrim**.
|
||
|
||
## Examples
|
||
|
||
- Let Him Cook
|
||
- Toolchain Maxxer
|
||
- Red Text Connoisseur
|
||
- Port 3000 Is Taken
|
||
- This Was Supposed To Be Quick
|
||
- One More Small Change
|
||
- Skillsmith
|
||
- Memory Keeper
|
||
- Context Dragon
|
||
- Plugin Goblin
|
||
- Rabbit Hole Certified
|
||
|
||
## Install
|
||
|
||
Clone into your Hermes plugins directory:
|
||
|
||
```bash
|
||
git clone https://github.com/PCinkusz/hermes-achievements ~/.hermes/plugins/hermes-achievements
|
||
```
|
||
|
||
For local development, keep the repo elsewhere and symlink it:
|
||
|
||
```bash
|
||
git clone https://github.com/PCinkusz/hermes-achievements ~/hermes-achievements
|
||
ln -s ~/hermes-achievements ~/.hermes/plugins/hermes-achievements
|
||
```
|
||
|
||
Then rescan dashboard plugins:
|
||
|
||
```bash
|
||
curl http://127.0.0.1:9119/api/dashboard/plugins/rescan
|
||
```
|
||
|
||
If backend API routes 404, restart `hermes dashboard`; plugin APIs are mounted at dashboard startup.
|
||
|
||
## Updating
|
||
|
||
If you installed with git:
|
||
|
||
```bash
|
||
cd ~/.hermes/plugins/hermes-achievements
|
||
git pull --ff-only
|
||
curl http://127.0.0.1:9119/api/dashboard/plugins/rescan
|
||
```
|
||
|
||
If the update changes backend routes or `plugin_api.py`, restart `hermes dashboard` after pulling.
|
||
|
||
As of 2026-04-29, updating is strongly recommended because scan performance changed significantly:
|
||
- removed duplicate `/overview` scan path
|
||
- added cached `/achievements` snapshot
|
||
- added incremental checkpoint reuse for unchanged sessions
|
||
|
||
Achievement unlock state is stored locally in `state.json` and is not overwritten by git updates. New achievements are evaluated from your existing Hermes session history. Achievement IDs are stable and should not be renamed casually because they are the unlock-state keys.
|
||
|
||
Releases are tagged in git, for example:
|
||
|
||
```bash
|
||
git fetch --tags
|
||
git checkout v0.2.0
|
||
```
|
||
|
||
## Files
|
||
|
||
```text
|
||
dashboard/
|
||
├── manifest.json
|
||
├── plugin_api.py
|
||
└── dist/
|
||
├── index.js
|
||
└── style.css
|
||
```
|
||
|
||
## API
|
||
|
||
Routes are mounted under:
|
||
|
||
```text
|
||
/api/plugins/hermes-achievements/
|
||
```
|
||
|
||
Endpoints:
|
||
|
||
```text
|
||
GET /achievements
|
||
GET /scan-status
|
||
GET /recent-unlocks
|
||
GET /sessions/{session_id}/badges
|
||
POST /rescan
|
||
POST /reset-state
|
||
```
|
||
|
||
## Development
|
||
|
||
Run checks:
|
||
|
||
```bash
|
||
node --check dashboard/dist/index.js
|
||
python3 -m py_compile dashboard/plugin_api.py
|
||
python3 -m unittest tests/test_achievement_engine.py -v
|
||
```
|
||
|
||
## License
|
||
|
||
MIT
|