Skip to content
WassbdrPublic

About

100% local voice assistant: faster-whisper, Ollama, Edge TTS and OpenVoice cloning. Zero data leaves your machine

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

voicecall: 100% Local Voice Assistant

A fully local, privacy-first voice assistant: speech-to-text, LLM reasoning, text-to-speech, and real-time voice cloning. Zero data leaves your machine.

Mic → faster-whisper (STT) → Ollama/Llama3 (LLM) → Edge TTS (TTS) → Speaker
                                                   ↕
                                           OpenVoice (voice clone)

Why local?

Most voice assistants send your audio to remote servers. This project runs the entire pipeline on your hardware:

  • faster-whisper for transcription (local)
  • Ollama with any open model (local)
  • Edge TTS for synthesis (minimal network, no data retention)
  • OpenVoice for voice cloning (local checkpoint)

Features

  • Wake word: activates on "Hey Agent"
  • Real-time voice cloning: adapts to your voice from a reference file or live samples
  • Smart audio quality filter: only high-quality samples (SNR + clarity score) used for cloning
  • Personality modes: assistant / ami / expert / humour (switchable by voice command)
  • Gradio web interface: visual feedback, conversation history, mic level indicator
  • Conversation export: save transcripts to file
  • Auto-reconnect: recovers from Ollama crashes

Prerequisites

  • Python 3.10+
  • Ollama installed and running
  • FFmpeg
  • GPU recommended (faster-whisper + OpenVoice benefit from CUDA)

Installation

# 1. Install Ollama and pull a model
ollama pull llama3.2:3b      # or llama3.2:1b for CPU

# 2. Clone and install
git clone https://github.com/Wassbdr/voicecall
cd voicecall
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# 3. Place OpenVoice checkpoints
#    openvoice_model/checkpoints/  ← download from OpenVoice repo

# 4. Run
ollama serve &
python agent.py
# → open http://localhost:7860

Configuration

Edit agent.py to tune:

Variable Default Description
OLLAMA_MODEL llama3.2:1b Ollama model to use
WHISPER_MODEL tiny faster-whisper model size
WAKE_WORD "hey agent" Wake word phrase
SILENCE_THRESHOLD 500 Mic amplitude threshold
MIN_SAMPLES 2 Min voice samples for cloning

Tech Stack

Component Library
STT faster-whisper
LLM ollama (Llama 3, Mistral, …)
TTS edge-tts
Voice cloning OpenVoice
Web UI gradio

License

MIT

About

100% local voice assistant: faster-whisper, Ollama, Edge TTS and OpenVoice cloning. Zero data leaves your machine

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages