Skip to main content
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

Call Control

10 min · End calls and transfer to human agents.SDKAgentEndCallEvent · SDKAgentTransferConversationEvent · Cold/warm transfers · Hold music

Inbound IVR

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

Campaigns

20 min · Run outbound calling campaigns at scale.AtomsClient · Audience management · Campaign creation · Batch calling

​
Analytics

Call Analytics

10 min · Retrieve call metrics, transcripts, and post-call analysis.Call details · Transcript export · Post-call configuration · Metrics API

​
End-to-End Projects

Bank CSR Agent

30 min · Production-grade voice banking agent with real database queries, identity verification, and compliance logging.BackgroundAgentNode · SQL execution · Multi-round tool chaining · Deterministic computation · KBA verification · Audit logging · Call transfers

​
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