Enum AnyClient 

pub enum AnyClient {
    OpenAI(OpenAIClient),
    Anthropic(AnthropicClient),
    Grok(GrokClient),
    Gemini(GeminiClient),
}

A provider-agnostic client chosen at runtime.

Because LLMClient has a generic materialize method it is not object-safe, so Box<dyn LLMClient> is impossible. AnyClient is an enum over the concrete clients that itself implements LLMClient, giving you a single, Clone, Send + Sync type that can hold whichever provider you selected at runtime (from a CLI flag, config file, env, etc.).

Construct it with from_env_for, with LLMClient::from_env (which auto-detects from the environment), or with From<ConcreteClient> when you need custom configuration:

use rstructor::{AnyClient, Provider, LLMClient, Instructor};
use serde::{Serialize, Deserialize};

#[derive(Instructor, Serialize, Deserialize, Debug)]
struct Movie {
    title: String,
}

// Provider decided at runtime.
let provider = Provider::Anthropic;
let client = AnyClient::from_env_for(provider)?;

let movie: Movie = client.materialize("Describe Inception").await?;
println!("{}", movie.title);

Wrapping a pre-configured client:

use rstructor::{AnyClient, OpenAIClient, OpenAIModel};

let configured = OpenAIClient::from_env()?.model(OpenAIModel::Gpt55);
let client: AnyClient = configured.into();

Variants

OpenAI(OpenAIClient)

An OpenAI client.

Anthropic(AnthropicClient)

An Anthropic client.

Grok(GrokClient)

A Grok client.

Gemini(GeminiClient)

A Gemini client.

Implementations

impl AnyClient

pub fn from_env_for(provider: Provider) -> Result<Self>

Build a client for provider, reading its API key from the environment.

Errors

Returns an error if the provider’s environment variable is not set.

pub fn provider(&self) -> Provider

Return the Provider backing this client.

Trait Implementations

impl Clone for AnyClient

fn clone(&self) -> AnyClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl From<AnthropicClient> for AnyClient

Available on crate feature anthropic only.

fn from(client: AnthropicClient) -> Self

Converts to this type from the input type.

impl From<GeminiClient> for AnyClient

Available on crate feature gemini only.

fn from(client: GeminiClient) -> Self

Converts to this type from the input type.

impl From<GrokClient> for AnyClient

Available on crate feature grok only.

fn from(client: GrokClient) -> Self

Converts to this type from the input type.

impl From<OpenAIClient> for AnyClient

Available on crate feature openai only.

fn from(client: OpenAIClient) -> Self

Converts to this type from the input type.

impl LLMClient for AnyClient

fn from_env() -> Result<Self>

Auto-detect a provider from the environment.

Enabled providers are tried in order (OpenAI, Anthropic, Grok, Gemini) and the first one whose API-key variable is set is used. For deterministic selection, prefer AnyClient::from_env_for.

Errors

Returns an ApiErrorKind::AuthenticationFailed error if none of the enabled providers’ API-key variables are set.

fn materialize<'life0, 'life1, 'async_trait, T>( &'life0 self, prompt: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<T>> + Send + 'async_trait>>

where T: Instructor + DeserializeOwned + Send + 'static + 'async_trait, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Materialize a structured object of type T from a prompt.

fn materialize_with_media<'life0, 'life1, 'life2, 'async_trait, T>( &'life0 self, prompt: &'life1 str, media: &'life2 [MediaFile], ) -> Pin<Box<dyn Future<Output = Result<T>> + Send + 'async_trait>>

where T: Instructor + DeserializeOwned + Send + 'static + 'async_trait, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Materialize a structured object with media references (if supported).

fn materialize_with_metadata<'life0, 'life1, 'async_trait, T>( &'life0 self, prompt: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<MaterializeResult<T>>> + Send + 'async_trait>>

where T: Instructor + DeserializeOwned + Send + 'static + 'async_trait, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Materialize a structured object with metadata (token usage).

fn generate<'life0, 'life1, 'async_trait>( &'life0 self, prompt: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Raw completion without structure (returns plain text).

fn generate_with_media<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, prompt: &'life1 str, media: &'life2 [MediaFile], ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Raw text completion with media attachments (if supported).

fn generate_with_metadata<'life0, 'life1, 'async_trait>( &'life0 self, prompt: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<GenerateResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Raw completion with metadata (token usage).

fn list_models<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<ModelInfo>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetch available models from the provider’s API.