TokenLab Provider for Hermes Agent
Use TokenLab models from Hermes Agent through TokenLab's OpenAI-compatible API. The plugin registers TokenLab in the Hermes provider picker, discovers models from the live TokenLab catalog, and keeps a curated agent-capable fallback list for offline setup.
Install
pip install tokenlab-hermes-provider
export TOKENLAB_API_KEY="your-tokenlab-api-key"
hermes plugins enable tokenlab-provider
hermes model
Choose TokenLab, then select a model returned by https://api.tokenlab.sh/v1/models.
For a custom gateway URL, set the OpenAI-compatible /v1 base:
export TOKENLAB_BASE_URL="https://api.tokenlab.sh/v1"
Hermes uses TokenLab's OpenAI-compatible Chat Completions surface for agent execution. TokenLab also exposes native OpenAI Responses, Anthropic Messages, and Gemini generateContent APIs for applications that need those request contracts.
Verify
hermes plugins list
hermes model
The plugin appears as tokenlab-provider, and the provider picker shows TokenLab. Hermes keeps third-party plugins opt-in, so the plugins enable step is required once after installation.
Development
python -m venv .venv
. .venv/bin/activate
python -m pip install -e '.[test]'
pytest
Links
- Website: https://tokenlab.sh
- API compatibility guide: https://docs.tokenlab.sh/zh/guides/ide-sdk-compatibility
- Hermes Agent provider plugin guide: https://github.com/NousResearch/hermes-agent/blob/main/website/docs/developer-guide/model-provider-plugin.md
1 maintainer
Metadata
1 maintainer
Release files for tokenlab-hermes-provider 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tokenlab_hermes_provider-0.1.0.tar.gz | 3.7 kB | Without provenance | Details for tokenlab_hermes_provider-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tokenlab_hermes_provider-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for tokenlab_hermes_provider-0.1.0-py3-none-any.whl |
Total release size: 7.7 kB
Release files / tokenlab_hermes_provider-0.1.0.tar.gz
| Download URL | tokenlab_hermes_provider-0.1.0.tar.gz |
|---|---|
| Size | 3.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5ddd8812e7e5ba7495b14efc078a6e4d7bb6390ca0ec5dd3dd012dbfce0aeb53
|
|
BLAKE2b-256 checksum How to use checksums |
872e93e88da53053e0b597915128de9ff2b0696a68eb1253aad3e311714976cf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
Release files / tokenlab_hermes_provider-0.1.0-py3-none-any.whl
| Download URL | tokenlab_hermes_provider-0.1.0-py3-none-any.whl |
|---|---|
| Size | 4.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
884d77790d1f077928072da007259c1f780dd234f4704a4b7ac12947fd26a788
|
|
BLAKE2b-256 checksum How to use checksums |
583a8f5232d619f65648adac29173da5d4bf85bdaf226758433e8713d27e514e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
Security for tokenlab-hermes-provider 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
