VOICE BOT MANUAL

Offline Voice Bot — Complete Guide

Python 3.11.9 → Dependencies → Voice Bot → Wikipedia RAG → Desktop App

Melbourne AI Hub — May 2026

Table of Contents

1. Installation
2. Dependencies
3. Voice Bot Setup
4. Wikipedia RAG
5. Desktop App
6. Troubleshooting

1. Installation

Install Python 3.11.9 or later. The voice bot runs entirely offline once dependencies are installed.

    $ python3 --version
    Python 3.11.9

    $ git clone 
    $ cd voice-bot
    $ python3 -m venv venv
    $ source venv/bin/activate
    $ pip install -r requirements.txt

2. Dependencies

• speech_recognition — converts microphone input to text
• pyttsx3 — offline text-to-speech engine
• wikipedia — Wikipedia API for RAG queries
• openai — LLM for response generation (local model via Ollama)
• PyAudio — microphone access
• tkinter — desktop GUI (bundled with Python)

3. Voice Bot Setup

The voice bot listens for a wake word, then transcribes speech, queries a local LLM, and speaks the response.

    VOICE BOT FLOW:

    [MICROPHONE] -> [speech_recognition] -> [text query]
         |
         v
    [WAKE WORD DETECTION] -> [TRANSCRIPTION]
         |
         v
    [WIKIPEDIA RAG] + [LOCAL LLM] -> [RESPONSE]
         |
         v
    [pyttsx3 TTS] -> [SPEAKER]

4. Wikipedia RAG

The bot queries Wikipedia for factual information, then uses a local LLM to compose a natural response. This runs entirely offline (Wikipedia data is cached locally).

5. Desktop App

A tkinter GUI wraps the voice bot with a start/stop button, status indicator, and text log of the conversation.

6. Troubleshooting

• No microphone detected: Check PyAudio installation. On Linux, install portaudio19-dev.
• TTS not working: Ensure pyttsx3 can find an available speech engine (espeak on Linux).
• LLM not responding: Verify Ollama is running on localhost:11434.
• Slow responses: The first LLM load takes time. Subsequent queries are faster.

Melbourne AI Hub — 317/480 Collins Street, Melbourne, Victoria, Australia

Last modified: August 1990 · Best viewed in Netscape Navigator 1.0 at 640x480

You are visitor number 00000042 since 01-Jan-1990

[ Home ] · [ Contents ] · [ Email ] · [ Prev ] [ Random ] [ Next ] — Melbourne AI WebRing