Inicio rápido

Inicio rápido

Elija su tiempo de ejecución y comience a realizar llamadas de IA en minutos.

Requisitos previos

• Una clave API de cualquier proveedor compatible (por ejemplo, OPENAI_API_KEY, ANTHROPIC_API_KEY, DEEPSEEK_API_KEY)
• El repositorio AI-Protocol (se obtiene automáticamente de GitHub si no es local)

Rust

1. Agregue la dependencia

[dependencies]
ai-lib = "0.7"
tokio = { version = "1", features = ["full"] }

2. Configure su clave API

export ANTHROPIC_API_KEY="your-key-here"

3. Escriba su primer programa

use ai_lib::{AiClient, StreamingEvent};
use futures::StreamExt;

#[tokio::main]
async fn main() -> ai_lib::Result<()> {
    // Create client — protocol manifest is loaded automatically
    let client = AiClient::new("anthropic/claude-3-5-sonnet").await?;

    // Streaming chat
    let mut stream = client.chat()
        .user("What is AI-Protocol?")
        .temperature(0.7)
        .max_tokens(500)
        .stream()
        .execute_stream()
        .await?;

    while let Some(event) = stream.next().await {
        match event? {
            StreamingEvent::ContentDelta { text, .. } => print!("{text}"),
            StreamingEvent::StreamEnd { .. } => println!(),
            _ => {}
        }
    }
    Ok(())
}

4. Ejecute

cargo run

Python

1. Instale el paquete

pip install ai-lib-python>=0.6.0

2. Configure su clave API

export ANTHROPIC_API_KEY="your-key-here"

3. Escriba su primer script

import asyncio
from ai_lib_python import AiClient

async def main():
    # Create client — protocol manifest loaded automatically
    client = await AiClient.create("anthropic/claude-3-5-sonnet")

    # Streaming chat
    async for event in client.chat() \
        .user("What is AI-Protocol?") \
        .temperature(0.7) \
        .max_tokens(500) \
        .stream():
        if event.is_content_delta:
            print(event.as_content_delta.text, end="")
    print()

asyncio.run(main())

4. Ejecute

python main.py

Cambio de proveedores

La magia de AI-Lib: cambie una cadena para cambiar de proveedor.

// Rust — just change the model ID
let client = AiClient::new("openai/gpt-4o").await?;
let client = AiClient::new("deepseek/deepseek-chat").await?;
let client = AiClient::new("gemini/gemini-2.0-flash").await?;

# Python — same thing
client = await AiClient.create("openai/gpt-4o")
client = await AiClient.create("deepseek/deepseek-chat")
client = await AiClient.create("gemini/gemini-2.0-flash")

No se necesitan cambios de código. El manifiesto del protocolo maneja endpoint, autenticación, mapeo de parámetros y formato de streaming para cada proveedor.

Próximos pasos

• Arquitectura del ecosistema — Cómo encajan las piezas
• Guía de Chat Completions — Uso detallado de la API de chat
• Llamadas a funciones — Uso de herramientas y llamadas a funciones
• Detalles del SDK Rust — Profundice en Rust
• Detalles del SDK Python — Profundice en Python