Simple Chatbot

This repository demonstrates a simple AI chatbot with real-time audio/video interaction, implemented using different client and server options. The bot server supports multiple AI backends, and you can connect to it using five different client approaches.

Two Bot Options

1. OpenAI Bot

   • Uses gpt-4o for conversation
   • Requires OpenAI API key

2. Gemini Bot

   • Uses Google's Gemini Live model
   • Requires Gemini API key

Six Client Options

1. Daily Prebuilt (Simplest)

   • Direct connection through a Daily Prebuilt room
   • For demo purposes only; handy for quick testing

2. JavaScript

   • Basic implementation using Pipecat JavaScript SDK
   • No framework dependencies
   • Good for learning the fundamentals

3. React

   • Basic impelmentation using Pipecat React SDK
   • Demonstrates the basic client principles with Pipecat React

4. React Native

   • Basic impelmentation using Pipecat React Native SDK
   • Demonstrates the basic client principles with Pipecat React Native

5. Android

   • Basic implementation using Pipecat Android SDK
   • Demonstrates the basic client principles with Pipecat Android

6. iOS

   • Basic implementation using Pipecat iOS SDK
   • Demonstrates the basic client principles with Pipecat iOS

Quick Start

First, start the bot server:

Follow the instructions in the server directory.

Next, connect using your preferred client app:

• Android Guide
• iOS Guide
• Daily Prebuilt
• JavaScript Guide
• React Guide

Important Note

The bot server must be running for any of the client implementations to work. Start the server first before trying any of the client apps.

Requirements

• Python 3.10+
• Node.js 16+ (for JavaScript and React implementations)
• Daily API key
• OpenAI API key (for OpenAI bot)
• Gemini API key (for Gemini bot)
• ElevenLabs API key
• Modern web browser with WebRTC support

Project Structure

simple-chatbot/
├── server/              # Bot server implementation
│   ├── assets           # Directory of sprite images
│   ├── bot-openai.py    # OpenAI bot implementation
│   ├── bot-gemini.py    # Gemini bot implementation
│   ├── env.example      # Env variable example
│   ├── Dockerfile       # Dockerfile for building your image
│   ├── pcc-deploy.toml  # Pipecat Cloud: Deployment specification
│   ├── pyproject.toml   # Project specification
│   ├── README.md        # More specific server setup instructions
│   └── requirements.txt
└── client/              # Client implementations
    ├── android/         # Daily Android connection
    ├── ios/             # Daily iOS connection
    ├── javascript/      # Daily JavaScript connection
    ├── prebuilt/        # Pipecat Prebuilt client
    ├── react/           # Pipecat React client
    └── react-native/    # Pipecat React Native client