Examples¶
Runnable, step-by-step examples for every major russo feature. Each example is also available as a standalone Python file in the examples/ directory.
Quick Reference¶
| Example | What it shows |
|---|---|
| Basic Pipeline | Minimal russo.run() end-to-end pipeline |
| Custom Agent | Wrap any async function with @russo.agent |
| Custom Evaluator | Build a custom evaluator via structural subtyping |
| Custom Synthesizer | Build a file-based or silence synthesizer for offline testing |
| Gemini Adapters | GeminiAgent, GeminiLiveAgent, and Vertex AI |
| OpenAI Adapters | OpenAIAgent and OpenAIRealtimeAgent |
| HTTP Agent | Test HTTP endpoints with HttpAgent |
| WebSocket Agent | Test WebSocket endpoints with custom hooks |
| Custom Response Parser | Parse arbitrary JSON response structures with JsonResponseParser |
| Caching | CachedSynthesizer and AudioCache |
| Concurrent Runs | russo.run_concurrent() — multi-prompt and multi-run testing |
| pytest Integration | Markers, fixtures, and CLI options |
| WebSocket Testing (E2E) | End-to-end WebSocket server + Gemini, tested with real TTS |
| Config-Driven Pipeline | YAML-driven pipeline via CLI or programmatic loader |