wehub-resource-sync
b4fbd6fe9f
Deploy Site / deploy-vercel (push) Has been skipped
Deploy Site / deploy-docs (push) Has been skipped
Build Skills Index / build-index (push) Has been skipped
CI / Deny unrelated histories (push) Has been skipped
CI / Detect affected areas (push) Successful in 27m35s
CI / OSV scan (push) Failing after 4s
CI / Build&Test Docker image (push) Successful in 9s
CI / Supply-chain scan (push) Has been skipped
CI / Lint Docker scripts (push) Failing after 5m13s
CI / Check contributors (push) Failing after 12m8s
CI / Docs Site (push) Failing after 12m8s
CI / TypeScript (push) Failing after 12m8s
CI / Python lints (push) Failing after 12m9s
CI / Python tests (push) Failing after 12m9s
CI / Check uv.lock (push) Failing after 23m22s
CI / CI timing report (push) Has been cancelled
Build Skills Index / trigger-deploy (push) Has been cancelled
CI / All required checks pass (push) Has been cancelled
71 lines
2.3 KiB
Markdown
71 lines
2.3 KiB
Markdown
# Model Provider Plugins
|
|
|
|
Each subdirectory is a self-contained provider profile plugin. The
|
|
directory layout mirrors `plugins/platforms/`:
|
|
|
|
```
|
|
plugins/model-providers/
|
|
├── openrouter/
|
|
│ ├── __init__.py # registers the ProviderProfile
|
|
│ └── plugin.yaml # manifest: name, kind, version, description
|
|
├── anthropic/
|
|
│ ├── __init__.py
|
|
│ └── plugin.yaml
|
|
└── ...
|
|
```
|
|
|
|
## How discovery works
|
|
|
|
`providers/__init__.py._discover_providers()` scans this directory (and
|
|
`$HERMES_HOME/plugins/model-providers/`) the first time anything calls
|
|
`get_provider_profile()` or `list_providers()`. Each `__init__.py` is
|
|
imported and expected to call `providers.register_provider(profile)`.
|
|
|
|
User plugins at `$HERMES_HOME/plugins/model-providers/<name>/` override
|
|
bundled plugins of the same name — last-writer-wins in
|
|
`register_provider()`. Drop a file there to replace a built-in.
|
|
|
|
## Adding a new provider
|
|
|
|
1. Create `plugins/model-providers/<your_provider>/__init__.py`:
|
|
|
|
```python
|
|
from providers import register_provider
|
|
from providers.base import ProviderProfile
|
|
|
|
my_provider = ProviderProfile(
|
|
name="your-provider",
|
|
aliases=("alias1", "alias2"),
|
|
display_name="Your Provider",
|
|
description="One-line description shown in the setup picker",
|
|
signup_url="https://your-provider.example.com/keys",
|
|
env_vars=("YOUR_PROVIDER_API_KEY", "YOUR_PROVIDER_BASE_URL"),
|
|
base_url="https://api.your-provider.example.com/v1",
|
|
default_aux_model="your-cheap-model",
|
|
)
|
|
|
|
register_provider(my_provider)
|
|
```
|
|
|
|
2. Create `plugins/model-providers/<your_provider>/plugin.yaml`:
|
|
|
|
```yaml
|
|
name: your-provider-profile
|
|
kind: model-provider
|
|
version: 1.0.0
|
|
description: Short sentence about the provider
|
|
author: Your Name
|
|
```
|
|
|
|
Nothing else needs to change. `auth.py`, `config.py`, `models.py`,
|
|
`doctor.py`, `model_metadata.py`, `runtime_provider.py`, and the
|
|
chat_completions transport all auto-wire from the registry.
|
|
|
|
## Non-trivial profiles
|
|
|
|
Override the `ProviderProfile` hooks in a subclass for per-provider
|
|
quirks — see `plugins/model-providers/openrouter/__init__.py` for
|
|
`build_extra_body` and `build_api_kwargs_extras` examples, and
|
|
`plugins/model-providers/gemini/__init__.py` for `thinking_config`
|
|
translation.
|