qai-sdk 0.1.1

Universal Rust SDK for AI Providers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

//! # Embedding Example
//!
//! Demonstrates text embedding generation using the `EmbeddingModel` trait
//! across OpenAI, Google, and OpenAI-Compatible providers.

use qai_sdk::types::{EmbeddingOptions, ProviderSettings};
use qai_sdk::EmbeddingModel;

use qai_sdk::LanguageModel;
#[tokio::main]
async fn main() -> qai_sdk::Result<()> {
    dotenvy::dotenv().ok();

    let texts = vec![
        "Rust is a systems programming language.".to_string(),
        "Python is great for data science.".to_string(),
        "TypeScript adds types to JavaScript.".to_string(),
    ];

    // ===================================================================
    // 1. OpenAI Embeddings
    // ===================================================================
    println!("=== OpenAI Embeddings ===");
    let provider = qai_sdk::openai::create_openai(ProviderSettings {
        api_key: Some(std::env::var("OPENAI_API_KEY").unwrap_or_default()),
        ..Default::default()
    });
    let model = provider.embedding("text-embedding-3-small");

    let options = EmbeddingOptions {
        model_id: "text-embedding-3-small".to_string(),
        dimensions: Some(256), // Reduce dimensions for cost savings
    };

    let result = model.embed(texts.clone(), options).await?;
    println!("Generated {} embeddings", result.embeddings.len());
    for (i, embedding) in result.embeddings.iter().enumerate() {
        println!(
            "  Text {}: {} dimensions, first 5 values: {:?}",
            i,
            embedding.len(),
            &embedding[..5.min(embedding.len())]
        );
    }
    if let Some(usage) = &result.usage {
        println!("  Usage: {} prompt tokens", usage.prompt_tokens);
    }

    // ===================================================================
    // 2. Google Embeddings
    // ===================================================================
    println!("\n=== Google Embeddings ===");
    let provider = qai_sdk::google::create_google(ProviderSettings {
        api_key: Some(std::env::var("GOOGLE_GENERATIVE_AI_API_KEY").unwrap_or_default()),
        ..Default::default()
    });
    let model = provider.embedding("text-embedding-004");

    let options = EmbeddingOptions {
        model_id: "text-embedding-004".to_string(),
        dimensions: None,
    };

    let result = model.embed(texts.clone(), options).await?;
    println!("Generated {} embeddings", result.embeddings.len());
    for (i, embedding) in result.embeddings.iter().enumerate() {
        println!("  Text {}: {} dimensions", i, embedding.len());
    }

    // ===================================================================
    // 3. OpenAI-Compatible Embeddings (e.g., Together AI)
    // ===================================================================
    println!("\n=== OpenAI-Compatible Embeddings ===");
    use qai_sdk::openai_compatible::OpenAICompatibleProviderSettings;

    let provider =
        qai_sdk::openai_compatible::create_openai_compatible(OpenAICompatibleProviderSettings {
            base_url: "https://api.together.xyz/v1".to_string(),
            name: "together".to_string(),
            api_key: Some(std::env::var("TOGETHER_API_KEY").unwrap_or_default()),
            headers: None,
        });
    let model = provider.embedding("togethercomputer/m2-bert-80M-8k-retrieval");

    let options = EmbeddingOptions {
        model_id: "togethercomputer/m2-bert-80M-8k-retrieval".to_string(),
        dimensions: None,
    };

    let result = model.embed(texts.clone(), options).await?;
    println!("Generated {} embeddings", result.embeddings.len());
    for (i, embedding) in result.embeddings.iter().enumerate() {
        println!("  Text {}: {} dimensions", i, embedding.len());
    }

    // ===================================================================
    // 4. Cosine Similarity between embeddings
    // ===================================================================
    println!("\n=== Cosine Similarity Demo ===");
    let provider = qai_sdk::openai::create_openai(ProviderSettings {
        api_key: Some(std::env::var("OPENAI_API_KEY").unwrap_or_default()),
        ..Default::default()
    });
    let model = provider.embedding("text-embedding-3-small");

    let similarity_texts = vec![
        "I love programming in Rust".to_string(),
        "Rust is my favorite programming language".to_string(),
        "The weather is beautiful today".to_string(),
    ];

    let result = model
        .embed(
            similarity_texts.clone(),
            EmbeddingOptions {
                model_id: "text-embedding-3-small".to_string(),
                dimensions: Some(256),
            },
        )
        .await?;

    println!("Similarity between related texts (should be high):");
    println!(
        "  '{}' vs '{}': {:.4}",
        similarity_texts[0],
        similarity_texts[1],
        cosine_similarity(&result.embeddings[0], &result.embeddings[1])
    );
    println!("Similarity between unrelated texts (should be low):");
    println!(
        "  '{}' vs '{}': {:.4}",
        similarity_texts[0],
        similarity_texts[2],
        cosine_similarity(&result.embeddings[0], &result.embeddings[2])
    );

    Ok(())
}

fn cosine_similarity(a: &[f32], b: &[f32]) -> f32 {
    let dot: f32 = a.iter().zip(b.iter()).map(|(x, y)| x * y).sum();
    let norm_a: f32 = a.iter().map(|x| x * x).sum::<f32>().sqrt();
    let norm_b: f32 = b.iter().map(|x| x * x).sum::<f32>().sqrt();
    if norm_a == 0.0 || norm_b == 0.0 {
        return 0.0;
    }
    dot / (norm_a * norm_b)
}