Struct ModelProviderParser 

pub struct ModelProviderParser { /* private fields */ }

Parses "provider:model" strings into live StreamingModelProvider instances.

This is the primary entry point for creating providers from user-supplied model specifications at runtime. It handles provider lookup, credential loading, and model configuration in one step.

Format

• Single provider – "anthropic:claude-sonnet-4-5-20250929" or "ollama:llama3.2"
• Multiple providers – "anthropic:claude-sonnet-4-5-20250929,openai:gpt-4o" creates an AlloyedModelProvider that cycles between them.

Built-in providers

Default::default() registers all built-in providers: anthropic, openai, openrouter, gemini, ollama, llamacpp, deepseek, moonshot, zai, and (with feature flags) bedrock and codex.

Custom providers

Register additional providers with with_provider (for types implementing ProviderFactory) or with_openai_provider (for OpenAI-compatible APIs).

Example

use llm::parser::ModelProviderParser;
use llm::StreamingModelProvider;

let parser = ModelProviderParser::default();
let (provider, model) = parser.parse("ollama:llama3.2").await.unwrap();
println!("Provider: {}", provider.display_name());
println!("Model: {model}");

Implementations

impl ModelProviderParser

pub fn new(factories: HashMap<String, CreateProviderFn>) -> Self

Create a new parser with custom provider factories

impl ModelProviderParser

pub fn with_provider<P: ProviderFactory + StreamingModelProvider + 'static>( self, name: impl Into<String>, ) -> Self

pub fn with_openai_provider( self, name: impl Into<String>, config: &'static ProviderConfig, ) -> Self

pub async fn create_provider( &self, model: &LlmModel, ) -> Result<Box<dyn StreamingModelProvider>>

Create a provider from a typed LlmModel

pub async fn parse( &self, models_str: &str, ) -> Result<(Box<dyn StreamingModelProvider>, LlmModel)>

Parse a model specification string and create a provider instance.

Returns both the provider and an LlmModel describing the identity of the first (or only) provider in the spec.

Format

• "provider:model" - Single provider (e.g., “anthropic:claude-3.5-sonnet”)
• "provider1:model1,provider2:model2" - Multiple providers create an AlloyedModelProvider

Trait Implementations

impl Default for ModelProviderParser

fn default() -> Self

Create a parser with all built-in providers registered