adk-realtime 0.6.0

Real-time bidirectional audio/video streaming for Rust Agent Development Kit (ADK-Rust) agents
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

//! Gemini Live API provider.
//!
//! This module provides the Gemini implementation of the realtime traits,
//! connecting to Google's WebSocket-based Live API.
//!
//! # Status
//!
//! This provider is currently a work in progress. The Gemini Live API has
//! some differences from OpenAI's Realtime API:
//!
//! - Input audio: 16kHz mono PCM
//! - Output audio: 24kHz mono PCM
//! - Different VAD settings
//! - Different tool calling format
//!
//! # Example
//!
//! ```rust,ignore
//! use adk_realtime::gemini::{GeminiRealtimeModel, GeminiLiveBackend};
//! use adk_realtime::{RealtimeModel, RealtimeConfig};
//!
//! #[tokio::main]
//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
//!     let backend = GeminiLiveBackend::Studio {
//!         api_key: std::env::var("GOOGLE_API_KEY")?
//!     };
//!
//!     let model = GeminiRealtimeModel::new(
//!         backend,
//!         "models/gemini-live-2.5-flash-native-audio",
//!     );
//!
//!     let config = RealtimeConfig::default()
//!         .with_instruction("You are a helpful assistant.");
//!
//!     let session = model.connect(config).await?;
//!
//!     // Use the session...
//!     session.close().await?;
//!     Ok(())
//! }
//! ```

mod model;
mod session;

pub use model::GeminiRealtimeModel;
pub use session::{GeminiLiveBackend, GeminiRealtimeSession};

#[cfg(feature = "vertex-live")]
pub use session::build_vertex_live_url;

/// Gemini Live API WebSocket URL template.
pub const GEMINI_LIVE_URL: &str = "wss://generativelanguage.googleapis.com/ws/google.ai.generativelanguage.v1beta.GenerativeService.BidiGenerateContent";

/// URL template for Vertex AI Live WebSocket endpoint.
/// Use `build_vertex_live_url()` to construct the full URL with region and project ID.
#[cfg(feature = "vertex-live")]
pub const VERTEX_LIVE_URL_TEMPLATE: &str = "wss://{region}-aiplatform.googleapis.com/ws/google.cloud.aiplatform.v1beta1.LlmBidiService/BidiGenerateContent?project_id={project_id}";

/// Default model for Gemini Live.
pub const DEFAULT_MODEL: &str = "models/gemini-live-2.5-flash-native-audio";

/// Available voices for Gemini Live (varies by model).
pub const GEMINI_VOICES: &[&str] = &["Puck", "Charon", "Kore", "Fenrir", "Aoede"];