CatsuCatsu Docs

Installation

Install Catsu and configure API keys

Python

Install with pip:

pip install catsu

Requirements

  • Python 3.10 or higher
  • API keys for the providers you want to use

Rust

Add to your Cargo.toml:

[dependencies]
catsu = "0.1"
tokio = { version = "1", features = ["full"] }

API Key Configuration

Catsu automatically picks up API keys from environment variables. Configure the providers you need:

Core Providers

export OPENAI_API_KEY="your-openai-key"
export VOYAGE_API_KEY="your-voyage-key"
export COHERE_API_KEY="your-cohere-key"
export GEMINI_API_KEY="your-gemini-key"
export JINA_API_KEY="your-jina-key"
export MISTRAL_API_KEY="your-mistral-key"
export NOMIC_API_KEY="your-nomic-key"

Additional Providers

export CLOUDFLARE_API_TOKEN="your-cloudflare-token"
export CLOUDFLARE_ACCOUNT_ID="your-account-id"
export DEEPINFRA_API_KEY="your-deepinfra-key"
export MIXEDBREAD_API_KEY="your-mixedbread-key"
export TOGETHER_API_KEY="your-together-key"

Verify Installation

Python

from catsu import Client

client = Client()
print("Catsu installed successfully!")

# List available models
models = client.list_models()
print(f"Found {len(models)} models")

Rust

use catsu::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new()?;
    println!("Catsu installed successfully!");

    let models = client.list_models(None);
    println!("Found {} models", models.len());

    Ok(())
}

Next Steps

On this page