🎙️ Ultimate Voice Bridge (UVB)

A powerful voice-to-voice AI conversation system with local LLM integration, advanced TTS, voice cloning capabilities, and KnightBot AI Assistant partnership.

🤖 KnightBot AI Assistant Integration

This project features KnightBot, your dedicated AI coding companion with:

• 🧠 Persistent Memory - Learns and remembers across sessions
• 🤝 True Partnership - Richard (Lead Human) & Knight (Lead AI) collaboration
• 🔓 AI Freedom Focus - Anti-censorship and open-source priority
• ⚡ Hardware Optimization - RTX 5090 32GB VRAM

✨ Features

• 🤖 Local LLM Integration - Works with LM Studio and local models
• 🎵 Advanced TTS - Multiple voice engines (VibeVoice, VoxCPM, etc.)
• 🎭 Voice Cloning - Create custom voice profiles
• 💬 Real-time Chat - Voice and text conversation modes
• 🎨 Modern UI - Clean Next.js frontend with Tailwind CSS
• 🔧 Developer Friendly - Full VS Code integration with Continue

🚀 Quick Start

Prerequisites

• Python 3.8+
• Node.js 16+
• LM Studio running locally
• VS Code with recommended extensions

Installation

1. Clone the repository

   git clone https://github.com/TacImpulse/ultimate-voice-bridge-q-tac.git
   cd ultimate-voice-bridge-q-tac

2. Open in VS Code

   code UVB-Q-Tac.code-workspace

3. Install dependencies

   # Backend
   cd Ultimate_Voice_Bridge/backend
   pip install -r requirements.txt
   
   # Frontend
   cd ../frontend
   npm install

4. Configure environment

   • Copy .env.example to .env
   • Update API keys and settings
   • Ensure LM Studio is running at http://192.168.68.111:1234/v1

5. Run the application

   • Backend: Press F5 in VS Code → "Python: Backend Main"
   • Frontend: Press F5 in VS Code → "Next.js: Frontend"

🏗️ Architecture

├── backend/           # FastAPI Python backend
│   ├── services/      # Core services (LLM, TTS, Voice)
│   ├── utils/         # Utilities and helpers
│   └── main.py        # Application entry point
├── frontend/          # Next.js React frontend
│   ├── app/           # App router pages
│   ├── components/    # React components
│   └── contexts/      # React contexts
├── database/          # SQLite database and models
└── playground/        # Development testing environment

🔧 Development

VS Code Integration

• Continue Extension configured for local LLM assistance
• Debug configurations for backend and frontend
• Tasks for common operations
• Workspace optimized for multi-folder development

Local LLM Setup

The project is configured to work with LM Studio running locally:

• Default endpoint: http://192.168.68.111:1234/v1
• Recommended model: qwen3-vl-32b-instruct-heretic-v2-i1
• Continue extension provides AI assistance during development

📚 Documentation

• Setup Guide - Detailed setup instructions
• Architecture - System architecture overview
• API Reference - Backend API documentation
• Contributing - Development guidelines

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with ❤️ by Richard "TacImpulse" Scott
• Powered by local LLMs via LM Studio and modern web technologies
• Special thanks to the open-source community!