Metadata-Version: 2.4
Name: tokenlab-hermes-provider
Version: 0.1.0
Summary: TokenLab model provider plugin for Hermes Agent
Project-URL: Homepage, https://tokenlab.sh
Project-URL: Documentation, https://docs.tokenlab.sh/zh/guides/ide-sdk-compatibility
Project-URL: Repository, https://github.com/hedging8563/tokenlab-hermes-provider
Project-URL: Issues, https://github.com/hedging8563/tokenlab-hermes-provider/issues
Author-email: TokenLab <cryptoninja2008@gmail.com>
License: MIT
License-File: LICENSE
Keywords: hermes-agent,llm,model-provider,openai-compatible,tokenlab
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <3.14,>=3.11
Requires-Dist: hermes-agent<0.19,>=0.18.2
Provides-Extra: test
Requires-Dist: pytest<9,>=8; extra == 'test'
Description-Content-Type: text/markdown

# TokenLab Provider for Hermes Agent

Use TokenLab models from [Hermes Agent](https://github.com/NousResearch/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

```bash
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:

```bash
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

```bash
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

```bash
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>
