model-gateway-rs 0.2.2

A Rust library for model gateway services, providing traits and SDKs for various AI models.
Documentation
# model-gateway-rs

**model-gateway-rs** is a Rust library that provides a minimal, LLM-centric interface with a chat completions implementation, while keeping vision model data structures for future use.

## Features
- Minimal `Llm` trait with `chat_once` and `chat_stream`
- `ChatCompletionsLlm` implementation using `v1/chat/completions`
- Vision model request/response types (no client implementation yet)
- Async-friendly, built with `async-trait`

## Directory structure
```
src/
├── llm/          # LLM trait + chat completions implementation
├── model/        # Shared request/response data structures (includes vision types)
└── lib.rs        # Library entry point
```

## Usage
Add to your `Cargo.toml`:
```toml
model-gateway-rs = { git = "https://github.com/code-serenade/model-gateway-rs" }
```

Example (`chat_completions`):
```rust
use model_gateway_rs::{
    llm::{chat_completions::ChatCompletionsLlm, Llm},
    model::llm::{ChatMessage, LlmInput},
};

async fn run_inference() -> Result<(), Box<dyn std::error::Error>> {
    let llm = ChatCompletionsLlm::new("http://127.0.0.1:11434", "gpt-oss", None)?
        .with_temperature(Some(0.7))
        .with_max_tokens(Some(20_000));

    let input = LlmInput {
        messages: vec![
            ChatMessage::system("You are a helpful assistant."),
            ChatMessage::user("hi"),
        ],
    };

    let result = llm.chat_once(input).await?;
    println!("{}", result.get_content());
    Ok(())
}
```

## License
MIT