add-model-provider

Integrates a new AI model provider into LobeHub with runtime, model cards, branding, and documentation.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/SmallAi-API/smaihub --skill add-model-provider-smallai-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-model-provider
Source: https://github.com/SmallAi-API/smaihub/tree/main/.agents/skills/add-model-provider
Command: npx skills add https://github.com/SmallAi-API/smaihub --skill add-model-provider-smallai-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Adding a new AI model provider to LobeHub touches many disconnected layers—runtime adapters, model banks, environment configuration, icons, translations, and bilingual docs—and missing any one of them produces broken or misleading integrations. This Skill provides a complete, evidence-driven checklist so the provider works end to end for users. ## Core Features & Use Cases - Full Integration Contract: Guides registration of provider IDs, provider cards, model cards, runtime factories, RouterRuntime adapters, and authentication plumbing (API key or OAuth). - Branding and Ordering: Covers icon matching in @lobehub/icons, deliberate placement in DEFAULT_MODEL_PROVIDER_LIST, and localized provider descriptions in English and Chinese. - Documentation Workflow: Produces bilingual usage guides, environment variable references, and Docker configuration derived from implemented behavior. - Validation Harness: Uses providerTestUtils and focused package tests to verify streaming, structured generation, error localization, and settings UI behavior. - Use Case: When asked to add a new provider like a local inference server or a Responses-only API, follow the integration map and local-providers references to implement, brand, document, and validate the provider without inventing unsupported capabilities. ## Quick Start Ask the AI to add a new model provider to LobeHub by name, for example requesting it to integrate a specific provider with its models, icons, and documentation.

Frequently Asked Questions about add-model-provider

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new model provider to LobeHub?

Register the provider ID and card in the model-bank package, add model cards with evidence-backed metadata, wire the runtime factory in model-runtime, configure authentication, place the provider in DEFAULT_MODEL_PROVIDER_LIST, and add bilingual documentation. The integration map reference lists every file in the registration chain.

How do I add models to an existing LobeHub provider?

Adding models to an existing provider does not require a new provider integration. Follow the model-bank-metadata skill for knowledgeCutoff, family, and generation fields, and update capabilities, pricing, and context limits from verified sources without touching provider registration.

Does LobeHub support OAuth providers instead of API keys?

Yes, OAuth providers use the device authorization flow in the server with token exchange, refresh, disconnect, and account metadata paths. They do not acquire API-key environment variables; the ChatGPT subscription provider PR is the reference implementation.

How are local model servers like Ollama or Unsloth integrated?

Local providers require separate verification of launch modes, CORS and browser-request settings, model discovery, and capability detection. The local-providers reference covers reading server metadata endpoints and avoiding capability guesses from model-name substrings.

Why does a new provider show the wrong icon in LobeHub?

Icon mismatches happen when the model-ID matcher in @lobehub/icons collides with another provider's rule or the provider-ID mapping is missing from ProviderIcon. Verify the installed icon release and rendered model row rather than assuming an exported brand component is registered.

What tests are required for a new provider integration?

Use the providerTestUtils harness and focused package tests covering provider lookup, streaming and non-streaming requests, structured generation, credential errors with localized messages, and the settings UI in both languages. Live inference checks require authorized credentials; otherwise report the unverified paths explicitly.