Examples

Complete, runnable examples you can deploy in minutes. Each example includes full source code, setup instructions, and deployment guide.

All examples are available in the cookbook repository.

Getting Started

Your First Agent

5 min · Build and deploy a basic conversational agent.

OutputAgentNode · OpenAIClient · AtomsApp · CLI deployment

Agent Development

Agent with Tools

10 min · Give your agent actions it can perform.

@function_tool · ToolRegistry · Tool execution · LLM function calling

Background Agent

15 min · Real-time sentiment analysis alongside your main agent.

BackgroundAgentNode · Multi-node architecture · Shared state · Silent processing

Interrupt Control

10 min · Configure how your agent handles user interruptions.

is_interruptible · Dynamic settings · Barge-in handling

Language Switching

15 min · Multilingual agent with language detection.

Language detection · Dynamic prompts · Multi-language support

Calling

10 min · End calls and transfer to human agents.

SDKAgentEndCallEvent · SDKAgentTransferConversationEvent · Cold/warm transfers · Hold music

15 min · Build an interactive voice response menu.

Menu navigation · DTMF handling · Department routing

Platform Features

Knowledge Base RAG

15 min · Connect your agent to a knowledge base for accurate answers.

Knowledge base setup · RAG retrieval · Document upload

20 min · Run outbound calling campaigns at scale.

AtomsClient · Audience management · Campaign creation · Batch calling

Analytics

10 min · Retrieve call metrics, transcripts, and post-call analysis.

Call details · Transcript export · Post-call configuration · Metrics API

End-to-End Projects

30 min · Production-grade voice banking agent with real database queries, identity verification, and compliance logging.

BackgroundAgentNode · SQL execution · Multi-round tool chaining · KBA verification · Audit logging · Call transfers

Appointment Scheduler

20 min · Voice-based clinic receptionist that checks real Cal.com availability, negotiates time slots, and books appointments.

Cal.com API · Slot negotiation · @function_tool · Real calendar booking

20 min · State-machine-driven voice data collection with typed validation, backtracking, and native Jotform submission.

FormEngine · Step-by-step collection · Field validation · Jotform integration

Observability & Integrations

Langfuse Integration

15 min · Real-time voice agent observability with Langfuse via a BackgroundAgentNode — tool calls, LLM generations, and transcripts stream to your dashboard with zero latency impact.

BackgroundAgentNode · Langfuse traces · LLM generation tracking · Tool call spans

Mobile Apps

Hearthside — React Native voice agent app

20 min · Minimal React Native (Expo) app that opens a realtime voice session over the plain WebSocket endpoint. Mic capture, gapless PCM playback, mute toggle, in-app settings sheet that reconfigures voice, speed, and language via the REST draft-publish-activate flow. iOS and Android.

wss://.../atoms/v1/agent/connect · react-native-audio-api · input_audio_buffer.append · draft-publish-activate REST flow

Running Examples

Each example follows the same pattern:

$ # Clone the cookbook
$ git clone https://github.com/smallest-inc/cookbook
$ cd cookbook/voice-agents/<example>
$ 
$ # Install dependencies
$ pip install -e .
$ 
$ # Set environment variables
$ export OPENAI_API_KEY="your-key"
$ 
$ # Run locally
$ python app.py
$ 
$ # Test with CLI (in another terminal)
$ smallestai agent chat

Deploying Examples

$ # Login to Smallest AI
$ smallestai auth login
$ 
$ # Link to your agent
$ smallestai agent init
$ 
$ # Deploy
$ smallestai agent deploy --entry-point app.py
$ 
$ # Make live
$ smallestai agent builds