Skip to main content
Pick an example, clone it, and run. Each one is a self-contained project you can deploy or use as a starting point.
All examples are available in the cookbook repository. See the Showcase for live demos.

​
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 · 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

Form Filler

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

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

​
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