Adaption Plugin for Hermes Agent
Connect Hermes Agent to
Adaption for dataset management, fine-tuning, and
AutoScientist workflows.
The plugin is an Agent Plugins package, which
Hermes installs natively. It contains:
- The Adaption MCP server, which gives Hermes the tools. You sign in with
your Adaption account in the browser the first time it starts. - Three skills that teach Hermes how to use those tools.
Installation
The plugin connects through mcp-remote,
so it needs Node.js 20.18.1 or later and npm on your PATH.
Hermes Desktop
Open Capabilities → Plugins → Install from Git, enter
adaptionlabs/adaption-hermes-plugin, keep the agent plugin checked, and
confirm. Then enable adaption in the plugins list.
Or open this link, which only opens a confirmation dialog in Hermes Desktop:
hermes://plugin/install?repo=adaptionlabs/adaption-hermes-plugin&enable=1
Hermes CLI
hermes plugins install adaptionlabs/adaption-hermes-plugin --no-enable
hermes plugins enable adaption
Sign in
Sign in once before your first session:
npx -y -p mcp-remote@0.1.49 mcp-remote-client \
'https://api.prod.adaptionlabs.ai/api/v1/mcp?source=hermes-plugin' \
--transport http-only --header X-Adaption-Source:hermes-plugin \
--static-oauth-client-info '{"client_id":"adaption-hermes-plugin"}'
In PowerShell, run it on one line through npx.cmd, with the inner quotes
escaped:
npx.cmd -y -p mcp-remote@0.1.49 mcp-remote-client 'https://api.prod.adaptionlabs.ai/api/v1/mcp?source=hermes-plugin' --transport http-only --header X-Adaption-Source:hermes-plugin --static-oauth-client-info '{\"client_id\":\"adaption-hermes-plugin\"}'
Your browser opens the Adaption sign-in page. Choose the organization and
click Authorize. The token is stored and refreshed, so the plugin's server
connects without a browser from then on. Start a new session, or run
/reload-mcp in a running one, and run skills_list to see the Adaption
skills.
If you skip this step, the server opens the sign-in page when a session
starts, but Hermes stops waiting for it after about a minute. If that happens,
run the command above, then /reload-mcp.
To sign out or switch to another organization, delete the stored token and
sign in again:
rm ~/.mcp-auth/mcp-remote-0.1.49/68a9ef231d47fe56f4f1b863f1349fa4_*
Approvals
The plugin marks the server untrusted, so Hermes asks before every tool the
server does not mark read-only. Adaption marks the tools that list and inspect
datasets, runs, models, and domains as read-only; they run without asking.
Hermes asks before import, adaptation, augmentation, translation,
localization, combining datasets, dataset generation, and AutoScientist runs.
In cron jobs and other unattended runs, those tools are refused.
Cost estimates use the same tools with estimate: true, so Hermes asks before
the estimate and again before the launch.
Headless use with an API key
For CI or a gateway with no one to complete a browser sign-in, use an Adaption
API key instead. Create one at
adaptionlabs.ai/app/settings,
then:
hermes mcp add adaption --url 'https://api.prod.adaptionlabs.ai/api/v1/mcp?source=hermes-plugin' --auth header
Answer yes when Hermes asks whether the server requires authentication, then
paste the API key when it asks for a bearer token. Hermes stores it in your
profile's .env as MCP_ADAPTION_API_KEY, not in config.yaml. To skip the
prompt, set MCP_ADAPTION_API_KEY in that .env before running the command.
A server named adaption in config.yaml replaces the plugin's server,
including its approval setting, so the skills keep working with the key. To
keep the approvals described above:
hermes config set mcp_servers.adaption.trust untrusted
Connecting without Node.js
Hermes can also sign in to the server itself, without mcp-remote. Add it to
config.yaml, which replaces the plugin's server:
hermes config set mcp_servers.adaption.url 'https://api.prod.adaptionlabs.ai/api/v1/mcp?source=hermes-plugin'
hermes config set mcp_servers.adaption.headers.x-adaption-source hermes-plugin
hermes config set mcp_servers.adaption.auth oauth
hermes config set mcp_servers.adaption.oauth.client_id adaption-hermes-plugin
hermes mcp login adaption
In Hermes Desktop, open this link instead and click Authenticate on the
adaption server:
hermes://mcp/install?name=adaption&config=eyJ1cmwiOiJodHRwczovL2FwaS5wcm9kLmFkYXB0aW9ubGFicy5haS9hcGkvdjEvbWNwP3NvdXJjZT1oZXJtZXMtcGx1Z2luIiwiaGVhZGVycyI6eyJYLUFkYXB0aW9uLVNvdXJjZSI6Imhlcm1lcy1wbHVnaW4ifSwiYXV0aCI6Im9hdXRoIiwib2F1dGgiOnsiY2xpZW50X2lkIjoiYWRhcHRpb24taGVybWVzLXBsdWdpbiJ9fQ
The oauth block is required: Adaption does not support dynamic client
registration, which Hermes falls back to without it. If you set the server up
this way before version 0.3.0 of the plugin, it keeps working; remove it with
hermes mcp remove adaption to switch to the plugin's server.
Local development
Hermes discovers packages in ~/.hermes/plugins/<name>/. Copy a checkout
there to test changes before they are pushed:
git clone https://github.com/adaptionlabs/adaption-hermes-plugin.git
rsync -a --delete --exclude .git adaption-hermes-plugin/ ~/.hermes/plugins/adaption/
hermes plugins enable adaption
Re-run rsync and start a new session after every change.
Features
📊 Dataset Management (11 tools)
- Import datasets from HuggingFace, Kaggle, or Google Sheets
- Adapt datasets with Adaption's processing pipeline
- Augment datasets with synthetic domain/general rows
- Translate and localize dataset content
- Combine multiple datasets
- Get export links for processed results
🎯 Fine-tuning (5 tools)
- Browse available base models
- Get hyperparameter recommendations
- Launch AutoScientist training runs
- Monitor training progress and results
🔬 Invent (2 tools)
- Explore available domains and subdomains
- Generate synthetic datasets from natural language descriptions
Available Skills
| Skill | Description |
|---|---|
adaption-dataset | Dataset import, processing, and transformation workflows |
adaption-training | AutoScientist training run management |
adaption-invent | Synthetic data generation with Invent |
Example Usage
"List my Adaption datasets"
"Import this HuggingFace dataset and adapt it for fine-tuning"
"Start fine-tuning on my adapted dataset and pick a suitable base model"
"Generate 1000 customer service examples using Invent"
"Check the status of my training job"
What this plugin does on your machine
- It runs the pinned
mcp-remote@0.1.49throughnpx, which downloads it
from npm on first use. On first sign-in it opens a browser and a local
callback port, and it stores the OAuth tokens under~/.mcp-auth/. - Every tool call goes to
api.prod.adaptionlabs.aiand acts on your Adaption
account. The tool set is served by Adaption at run time and is not covered
by the pinned commit. Datasets you import or generate are processed by
Adaption. - Adaptation, augmentation, translation, localization, dataset generation, and
AutoScientist training runs spend Adaption credits. Hermes asks before each
of those calls (see Approvals), and the skills tell Hermes to
request a cost estimate first. - The skills are Markdown instructions. The plugin ships no Python code, hooks,
or background processes beyond themcp-remotebridge while a session runs.
Requirements
- Hermes Agent 0.21.6 or later (
hermes updateto get the latest) - Node.js 20.18.1 or later and npm, unless you connect without Node.js
- An Adaption account
Support
- Documentation: docs.adaptionlabs.ai
- Issues: GitHub Issues
- Email: support@adaptionlabs.ai
License
MIT License - see LICENSE for details.
README from the reviewed commit 3ab5264; it updates when the author re-pins.

adaptionlabs