DeepSeek Harness (DSH) is a commonly used framework for building AI agents. During development, finding available free model APIs and configuring providers one by one usually requires browsing multiple websites and manually editing configuration files. Below is an introduction to a community plugin that displays a free model leaderboard directly on the right side of the DSH Web UI and supports one-click setup.

Plugin Positioning

It is a DeepSeek Harness community plugin maintained by yu-wenchao, named dsh-free-models-hub. Its core value is:
* Provides a paginated free model leaderboard drawer panel on the right side of the DSH interface.
* Supports one-click setup or bulk setup for custom providers; users only need to paste the API key in Settings.
* Provides a local multi-key rotation proxy that automatically handles switching when a key becomes invalid.

Installation and Activation

The installation is completed through DSH’s official plugin management command.

  1. Open a terminal or command line and run the following command to install the plugin (using the npm registry is recommended):
    dsh plugin --profile web add dsh-free-models-hub
  1. After running the installation command, restart the DSH application to activate the plugin.

Core Features

  • Right-edge drawer panel: After DSH starts, a circular 🎁 button appears on the right edge of the window. Click it to expand the panel.
  • One-click setup / bulk setup: Click a model row in the panel to expand information such as the API endpoint and model name. Click “One-Click Setup to DSH” to write that provider into Settings → Models; you can also click “Configure All on This Page” to bulk-write them.
  • Multi-key rotation proxy: Click “🔄 Multi-Key Rotation”, paste multiple free API keys one per line, and save. The local proxy (default port 8787) automatically polls these keys and switches to the next one when the current key becomes invalid.
  • Security features: The plugin never accesses the user’s key at any time; keys are transmitted only through DSH’s official credential channel. The plugin does not directly modify settings.yaml, avoiding configuration corruption.

Usage Steps

After installing and restarting DSH, follow these steps to use it:

  1. Open the panel: Click the 🎁 button on the right edge of the DSH window to expand the “Free Model Leaderboard” drawer panel.
  2. Request and configure: Click a model row in the list to expand the details. If needed, click “🔑 Request Free API Key” to go to a third-party platform, register, and obtain a key. Click “⚡ One-Click Setup to DSH” to write the provider into settings.
  3. Enter the key: Go to DSH’s Settings → Models, find the provider that starts with freehub-*, paste the requested API key into the corresponding field, and save.
  4. Start the conversation: In the model selector at the top of the chat page, switch to a model under that provider to begin chatting.
  5. Configure rotation (optional): If you have multiple keys, click “🔄 Multi-Key Rotation” in the model row to configure it. The plugin will automatically rotate through the keys via the local proxy.

Notes

  • Data source: The leaderboard data is provided by a backend operated by the plugin author and is not included in the repository distribution files.
  • Dependency requirement: The environment must have Node.js >= 18 installed to run this plugin.
  • File safety: The plugin does not overwrite or modify settings.yaml, so existing configuration will not be corrupted by installing it.
  • License: Use of this plugin is subject to the MIT License.

Summary

This plugin integrates the free model leaderboard into the DSH sidebar, simplifying the process from discovering models to configuring a Provider. Developers no longer need to manually maintain configuration files; with a few clicks in the UI, they can quickly connect to free model services.

Plugin Catalog Page | GitHub Repository