HordVoice 🎤

Your intelligent voice assistant with inter-app control and Azure AI integration!

HordVoice is a cutting-edge voice assistant built with Flutter, powered by Azure AI services for advanced speech recognition, natural language processing, and text-to-speech capabilities. Control your apps, manage your tasks, and interact naturally with your device through voice commands.

🎃 Hacktoberfest 2025 Participant 🎃

Join us in making voice AI more accessible! We welcome contributions from developers of all skill levels.

📖 Contributing Guide • 🐛 Report Issues • 💬 Discussions

📱 Download

✨ Preview

(Screenshots coming soon)

🚀 Advanced AI Features

HordVoice delivers cutting-edge capabilities through 54 specialized services powering a revolutionary voice experience.

🎤 Azure AI Voice Engine

Azure Speech Recognition: Enterprise-grade speech-to-text with 95%+ accuracy
Azure OpenAI Integration: GPT-4 powered conversational AI with persistent memory
Smart Wake Word Detection: Hands-free activation with "HordVoice" trigger
Phrase Hints Optimization: Dynamic vocabulary adaptation for context-aware recognition
Multi-Language Intelligence: Seamless language detection and switching

🎭 Emotion Intelligence & Avatar System

Real-Time Facial Emotion Analysis: Camera-based emotion detection using Google ML Kit
Voice Emotion Recognition: Advanced sentiment analysis from speech patterns
Animated AI Avatar: 3D responsive avatar with emotional expressions (Rive animations)
Spatial Avatar Interface: Revolutionary AR-like 3D voice interaction paradigm
Emotional Context Memory: AI remembers and adapts to user emotional patterns

🌌 Spatial Computing Interface

Spatial Overlay System: Breakthrough 3D voice interaction layer overlaying reality
Immersive Voice Onboarding: Spatial setup experience with progressive permissions
Transition Animations: Fluid 3D transitions between interface states
Spatial Audio Visualization: Professional waveform rendering in 3D space

🎵 Professional Audio Intelligence

Advanced Audio Pipeline: Multi-stage processing with real-time compression optimization
Voice Calibration System: Personalized voice training and acoustic optimization
Karaoke-Grade Voice Tuning: Professional voice enhancement with pitch correction
Real-Time Voice Effects: Dynamic audio processing and voice modulation
Audio Buffer Management: Optimized streaming for ultra-low latency interaction

📱 Deep System Integration

Phone Health Monitoring: Comprehensive device performance and diagnostics tracking
Battery-Aware AI: Dynamic feature adaptation based on power levels and usage patterns
Native Telephony Bridge: Direct integration with Android telephony stack
Quick Settings Control: Voice-activated system settings and configuration management
Background Service Optimization: Persistent AI operation with minimal battery impact

🔐 Progressive Security & Permissions

Advanced Permission Manager: Context-aware, intelligent permission request system
Progressive Permission Flow: Gradual access escalation based on user trust and usage
Secure Authentication: Multi-factor authentication with voice biometric verification
Privacy-First Architecture: Local-first processing with optional cloud enhancement

🌐 Rich Ecosystem Integration

Spotify Deep Integration: Complete music control with natural voice commands
Weather Intelligence: Context-aware weather responses with location-based alerts
News Aggregation: AI-curated news delivery with voice summaries and categorization
Calendar AI: Intelligent meeting management, scheduling, and reminder system
Location Context: GPS-aware responses and location-based command triggers

⚡ Enterprise Performance & Reliability

Crash Prevention System: Proactive error detection with automatic recovery mechanisms
Circuit Breaker Pattern: Service resilience with intelligent failover and retry logic
Health Monitoring: Real-time system diagnostics and performance metrics tracking
Memory Optimization: Advanced memory management for continuous 24/7 operation
Voice Memory Persistence: Cross-session conversation context and learning retention

🎪 Hidden Power Features

Secret Commands System: Advanced power-user voice commands and shortcuts
Multilingual Service: Seamless multi-language conversation and content processing
Voice Session Management: Advanced conversation state and context management
Integration Testing Suite: Comprehensive automated service validation and testing

Supabase Voice Catalogue Setup

Open the Supabase SQL Editor for your production project and run database/supabase_migration_voices.sql to provision the available_voices table, indexes, and RLS policies.
Execute database/insert_fallback_data.sql in the same editor to seed the minimum voice set; you can rerun the script safely, it performs an upsert on the primary key.
Review the execution results. A successful migration should report CREATE TABLE, CREATE INDEX, CREATE POLICY, and INSERT/UPSERT statements without errors.
Launch the app and watch the debug console for the DatabaseInitializationService health summary (DB Health). If the table is missing or empty you will see actionable log messages pointing back to these SQL scripts.

📂 Real Project Architecture

HordVoice follows a service-oriented architecture with 50+ specialized AI services powering advanced capabilities.

lib/
├── main.dart                             # Application entry point and Riverpod initialization
│
├── services/ (54 services)               # 🧠 AI-powered service ecosystem
│   ├── 🎤 AZURE AI SERVICES
│   │   ├── azure_speech_service.dart        # Speech-to-Text with high accuracy
│   │   ├── azure_openai_service.dart        # GPT-powered conversations
│   │   ├── azure_wake_word_service.dart     # Hands-free activation
│   │   └── azure_speech_phrase_hints_service.dart # Context optimization
│   │
│   ├── 🎭 EMOTION & AVATAR SERVICES  
│   │   ├── camera_emotion_analysis_service.dart # Facial emotion detection
│   │   ├── voice_emotion_detection_service.dart # Voice sentiment analysis
│   │   ├── emotional_avatar_service.dart    # Emotion-responsive avatar
│   │   └── realtime_avatar_service.dart     # Live avatar animations
│   │
│   ├── 🌌 SPATIAL & OVERLAY SERVICES
│   │   ├── spatial_overlay_service.dart     # AR-like spatial interface
│   │   └── transition_animation_service.dart # Smooth UI transitions
│   │
│   ├── 🎵 AUDIO & VOICE SERVICES
│   │   ├── audio_pipeline_service.dart      # Core audio processing
│   │   ├── voice_calibration_service.dart   # Voice training system
│   │   ├── karaoke_calibration_service.dart # Advanced voice tuning
│   │   ├── voice_effects_service.dart       # Real-time voice effects
│   │   ├── voice_selection_service.dart     # Voice profile management
│   │   └── audio_compression_service.dart   # Audio optimization
│   │
│   ├── 📱 SYSTEM INTEGRATION SERVICES
│   │   ├── phone_monitoring_service.dart    # Device health tracking
│   │   ├── battery_monitoring_service.dart  # Power-aware optimization
│   │   ├── native_telephony_service.dart    # Native call integration
│   │   ├── phone_settings_service.dart      # System settings control
│   │   └── quick_settings_service.dart      # Fast access controls
│   │
│   ├── 🔐 SECURITY & PERMISSIONS
│   │   ├── advanced_permission_manager.dart # Smart permission handling
│   │   ├── progressive_permission_service.dart # Gradual permission flow
│   │   └── auth_service.dart                # User authentication
│   │
│   ├── 🌐 EXTERNAL API SERVICES
│   │   ├── spotify_service.dart             # Music streaming control
│   │   ├── weather_service.dart             # Weather information
│   │   ├── news_service.dart                # News aggregation
│   │   └── calendar_service.dart            # Calendar management
│   │
│   └── ⚡ PERFORMANCE & RELIABILITY
│       ├── crash_prevention_system.dart    # Error recovery
│       ├── circuit_breaker.dart            # Service resilience
│       ├── health_monitoring_service.dart  # System health checks
│       └── voice_memory_optimization_service.dart # Memory management
│
├── controllers/ (2 controllers)          # 🎮 Lightweight state orchestration
│   ├── voice_controller.dart               # Main voice interaction logic
│   └── persistent_ai_controller.dart       # Cross-session AI memory
│
├── views/ (8 views)                      # 🎨 Modern spatial UI
│   ├── main_spatial_view.dart              # Primary 3D voice interface
│   ├── spatial_voice_onboarding_view.dart  # Interactive setup experience
│   ├── home_view.dart                      # Traditional dashboard
│   ├── settings_view.dart                  # Configuration panel
│   ├── permissions_view.dart               # Permission management
│   ├── login_view.dart & register_view.dart # Authentication flows
│   └── quick_setting_widget.dart           # Quick access controls
│
├── widgets/ (8 widgets)                  # 🎭 Specialized UI components
│   ├── spacial_avatar_view.dart            # 3D AI avatar rendering
│   ├── animated_avatar.dart                # Avatar animation system
│   ├── audio_waveform.dart                 # Real-time audio visualization
│   ├── audio_waveform_optimized.dart       # Performance-optimized waveforms
│   ├── voice_selector.dart                 # Voice profile chooser
│   └── animated_splash_screen.dart         # App launch animation
│
├── models/ (3 models)                    # 📊 Type-safe data structures
│   ├── voice_models.dart                   # Voice recognition & TTS models
│   ├── ai_models.dart                      # AI conversation & memory models
│   └── user_profile.dart                   # User preferences & settings
│
├── theme/                                # 🎨 Design system & styling
├── painters/                             # 🖌️ Custom UI painters
├── l10n/                                 # 🌍 Multi-language support
└── generated/                            # 🔧 Auto-generated code

android/ (Native integration)
├── app/build.gradle.kts                  # Android build configuration
├── app/proguard-rules.pro                # Code shrinking rules
└── app/src/main/kotlin/                  # Native Azure Speech SDK bridge

assets/
├── images/                               # App icons & illustrations
├── audio/                                # Audio samples & sounds
└── sounds/                               # System notification sounds

🏗️ Architecture

HordVoice follows the Feature-First Clean Architecture with Azure AI integration:

core/: Application configuration and dependency injection
features/: Feature modules organized by business domain
shared/: Reusable services, models, and UI components
Native Integration: Kotlin-based Azure Speech SDK bridge

This architecture enables:

📦 Scalable feature development
🔌 Seamless Azure AI service integration
🧪 Comprehensive testing capabilities
👥 Efficient team collaboration
🚀 Easy deployment and maintenance

🛠️ Tech Stack

🏗️ Core Framework

Flutter 3.22.x: Cross-platform mobile development framework
Dart 3.8.0+: Modern programming language with null safety
Riverpod 2.6.1: Reactive state management and dependency injection

🤖 AI & Machine Learning

Azure Speech Recognition 1.0.2: Enterprise speech-to-text with 95%+ accuracy
Azure OpenAI: GPT-4 integration for conversational AI
Google ML Kit 0.10.0: On-device facial emotion detection
TensorFlow Lite 0.10.4: Local machine learning model execution
Flutter Azure TTS 1.0.0: Premium neural voice synthesis

🎵 Audio Processing

Just Audio 0.9.40: Professional audio playback and streaming
Audio Session 0.1.21: System-level audio session management
Flutter Sound 9.16.3: Advanced audio recording and processing
Audio Waveforms 1.1.6: Real-time audio visualization
Mic Stream Recorder 1.1.2: Continuous audio stream processing

📊 Data & Storage

Supabase Flutter 2.9.1: Backend-as-a-Service with PostgreSQL
Hive 2.2.3: Lightning-fast local NoSQL database
Flutter Secure Storage 9.2.2: Encrypted credential storage
Shared Preferences 2.5.3: User preference persistence

🎨 UI & Animation

Google Fonts 6.3.0: Beautiful typography system
Rive 0.13.15: Advanced 2D/3D animations for AI avatar
Lottie 3.1.3: Smooth motion graphics and micro-interactions
Flutter Animate 4.5.0: Powerful animation framework
Avatar Glow 2.0.2: Voice activity visualization effects

📱 System Integration

Permission Handler 11.3.1: Advanced permission management
Device Info Plus 11.0.0: Comprehensive device information
Battery Plus 6.2.2: Battery status and optimization
App Usage 4.0.1: Application usage analytics
Flutter Background Service 5.1.0: Persistent background operation

🌍 Location & External APIs

Geolocator 10.1.0: High-accuracy GPS positioning
Device Calendar 4.3.3: Native calendar integration
Google Sign-In 6.2.1: Authentication and user management
Flutter WebRTC 1.0.0: Real-time communication capabilities

🔧 Development & Testing

Logger 2.6.1: Advanced logging and debugging
Mockito 5.4.4: Comprehensive testing framework
HTTP Mock Adapter 0.6.1: API testing and mocking
Flutter Lints 5.0.0: Code quality and style enforcement

🛠️ Installation and Build

Prerequisites

Flutter 3.32.8 or higher
Dart 3.8.0 or higher
Android SDK 34 or higher
Azure Cognitive Services account
Azure OpenAI access (optional)

📥 Installation

1. Clone the Repository

git clone https://github.com/HordRicJr/HordVoice.git
cd HordVoice

2. Install Dependencies

flutter pub get

3. Configure Azure Services

Create a .env file from the template:

cp .env.example .env

Fill in your Azure credentials:

# Azure Speech Services
AZURE_SPEECH_KEY=your_azure_speech_key_here
AZURE_SPEECH_REGION=eastus
AZURE_SPEECH_ENDPOINT=https://eastus.api.cognitive.microsoft.com/

# Azure OpenAI (optional)
AZURE_OPENAI_ENDPOINT=https://your-instance.openai.azure.com/
AZURE_OPENAI_KEY=your_azure_openai_key_here
AZURE_OPENAI_DEPLOYMENT=chat

# Additional services...

4. Configure Android Permissions

Ensure your android/app/src/main/AndroidManifest.xml includes:

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

5. Run the Application

Debug Mode

flutter run

Release Mode (APK)

flutter build apk --release

Release Mode (AAB for Play Store)

flutter build appbundle --release

📦 Main Dependencies

dependencies:
  # Core Framework
  flutter_riverpod: 2.6.1                   # State management
  provider: ^6.1.2                          # Dependency injection
  
  # Azure AI Services
  azure_speech_recognition_flutter: ^1.0.0  # Azure Speech Recognition
  http: 1.5.0                               # HTTP client for Azure APIs
  
  # Audio Processing
  flutter_tts: 3.8.5                        # Text-to-speech synthesis
  just_audio: ^0.9.40                       # Advanced audio playback
  audio_session: ^0.1.21                    # Audio session management
  avatar_glow: 2.0.2                        # Microphone animation
  
  # Data & Storage
  shared_preferences: 2.5.3                 # Local preferences
  flutter_secure_storage: ^9.2.2            # Secure credential storage
  hive: 2.2.3                               # Local database
  supabase_flutter: 2.9.1                   # Backend integration
  
  # System Integration
  permission_handler: ^11.3.1               # Permissions management
  device_info_plus: ^11.0.0                 # Device information
  location: ^8.0.1                          # GPS services
  device_calendar: 4.3.3                    # Calendar integration
  
  # UI & UX
  google_fonts: 6.3.0                       # Typography
  url_launcher: 6.2.6                       # External app launching

🌐 Azure Services Integration

Azure Speech Services

Speech-to-Text: Real-time voice recognition with custom phrase hints
Text-to-Speech: Neural voice synthesis with multiple voice options
Wake Word Detection: Continuous listening for activation phrases

Azure OpenAI (Optional)

Natural Language Understanding: Advanced intent recognition
Conversational AI: Smart responses and context management
Content Generation: Dynamic response generation

Azure Translator (Optional)

Multi-language Support: Real-time translation capabilities
Language Detection: Automatic language identification

🔐 Android Permissions

<!-- Core Voice Functionality -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<!-- Network & Cloud Services -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- Location Services -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<!-- Calendar Integration -->
<uses-permission android:name="android.permission.READ_CALENDAR" />
<uses-permission android:name="android.permission.WRITE_CALENDAR" />

<!-- Background Processing -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

🏗️ Architecture Details

Voice Processing Pipeline

Audio Capture: Continuous microphone monitoring
Wake Word Detection: Azure Speech-based activation
Speech Recognition: Real-time STT with phrase hints
Natural Language Processing: Intent extraction and command routing
Response Generation: Dynamic response creation
Text-to-Speech: Natural voice synthesis and playback

Azure Integration

Native Bridge: Kotlin-based Azure Speech SDK integration
Platform Channels: Flutter-Android communication
Secure Configuration: Environment-based credential management
Fallback Systems: Graceful degradation for offline scenarios

State Management

Riverpod: Reactive state management for voice interactions
Audio Pipeline State: Real-time audio processing status
User Preferences: Persistent configuration storage
Service Health: Continuous service monitoring

🧪 Testing & Development

Run Unit Tests

flutter test

Integration Testing

flutter test integration_test/

Code Analysis

flutter analyze

Azure Service Testing

# Test Azure Speech connection
flutter run --debug -d android
# Check logs for Azure service initialization

Environment Configuration

# Validate configuration
flutter run --dart-define=ENVIRONMENT=development

📚 Documentation

👨‍💻 Author

HordRicJr

GitHub: https://github.com/HordRicJr
Email: [email protected]

📄 License

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

🎃 Hacktoberfest 2025

HordVoice is proudly participating in Hacktoberfest 2025!

We're looking for meaningful contributions that help improve our AI-powered voice assistant. Whether you're a seasoned developer or just starting out, there's a place for you in our community.

🎯 How to Contribute

🔍 Find an Issue
- Browse our Hacktoberfest issues
- Look for Good First Issues if you're new
- Comment on an issue to claim it

🍴 Fork & Clone

git clone https://github.com/YourUsername/HordVoice.git
cd HordVoice

🌟 Create Your Feature

git checkout -b feature/your-amazing-feature
# Make your changes
git commit -m 'feat: add amazing voice feature'

📤 Submit Your Contribution

git push origin feature/your-amazing-feature
# Open a Pull Request using our template

🏷️ Contribution Areas

🎯 Area	🔰 Difficulty	📝 Examples
🐛 Bug Fixes	Beginner	Voice recognition errors, UI glitches
✨ Features	Intermediate	New voice commands, UI improvements
🤖 Azure AI	Advanced	Speech recognition, NLP enhancements
📚 Documentation	Beginner	README updates, code comments
🧪 Testing	Intermediate	Unit tests, integration tests
🌐 Localization	Beginner	Translations, cultural adaptations
♿ Accessibility	Intermediate	Screen reader support, voice feedback
🔐 Security	Advanced	API security, data encryption

🏆 Hacktoberfest Rewards

🎁 Official Hacktoberfest swag for 4+ quality PRs
🌟 Recognition in our contributors list
🏅 Special badges for outstanding contributions
📧 Direct invitation to join our development team

🤝 Contributing

We love contributions from the community! Here's how you can help:

🚀 Quick Start

⭐ Star this repository to show your support
📖 Read our Contributing Guidelines
🍴 Fork the project and create your feature branch
💻 Make your changes following our coding standards
🧪 Test your changes thoroughly
📤 Submit a Pull Request with a clear description

📋 Before You Contribute

Read the Contributing Guidelines
Check existing issues and PRs
Set up your development environment
Test your changes on a real Android device
Follow our Code of Conduct

🌟 Open Source Community

HordVoice is built with ❤️ by the open source community. We believe in:

🔓 Open Development: All development happens in the open
🤝 Inclusive Community: Everyone is welcome to contribute
📚 Knowledge Sharing: We document everything for future contributors
🚀 Innovation: Pushing the boundaries of voice AI technology
🌍 Global Impact: Making voice AI accessible worldwide

📊 Project Stats

🏗️ Architecture: Clean, modular, and extensible
🧪 Testing: Comprehensive test coverage
📈 Performance: Optimized for real-time voice processing
🔒 Security: Enterprise-grade security practices
📱 Mobile-First: Built for Android with Flutter

💬 Community & Support

Join our growing community of voice AI enthusiasts!

🆘 Get Help

💬 GitHub Discussions - Ask questions, share ideas
🐛 Report Issues - Bug reports and feature requests
📧 Email Support - Direct contact for urgent matters
📖 Documentation - Comprehensive guides and API docs

🔗 Stay Connected

🌟 Star this repository to stay updated
👀 Watch for notifications on new releases
🍴 Fork to create your own version
📢 Share with your network

💡 Help Us Improve

Your feedback matters! Help us make HordVoice better:

⭐ Rate the project on GitHub
📝 Write reviews and blog posts
🐦 Share on social media
🎤 Present at conferences and meetups

👥 Contributors ✨

Thanks to these wonderful people who contributed to this project (emoji key):

_{ASSOUN Rodrigue}
💻 🎨 📖 🚧

_Dependabot
🚧 🛡️

_{GitHub Copilot}
💻 🤔 🔧

Ce projet suit la spécification all-contributors. Les contributions de toute nature sont les bienvenues !

🙏 Acknowledgments

Microsoft Azure: For the powerful AI services and Speech SDK
Flutter Team: For the incredible cross-platform framework
Azure Cognitive Services: For advanced speech and language capabilities
Flutter Community: For the amazing open-source packages
Hacktoberfest: For encouraging open-source contributions
GitHub Actions: For seamless CI/CD automation

� Roadmap

🎯 Current Focus (Q4 2025)

🎃 Hacktoberfest 2025 participation
📱 Google Play Store release
🌍 Multi-language support expansion
🔊 Advanced voice customization
🤖 Enhanced AI personality system

🔮 Upcoming Features

🍎 iOS support with SwiftUI
🌐 Web app version
🏠 Smart home integration (Google Home, Alexa)
👥 Multi-user voice profiles
🔗 Third-party app integrations
📊 Voice analytics dashboard
🎨 Custom wake word training

💡 Long-term Vision

🌟 Become the leading open-source voice assistant
🤖 Advanced conversational AI capabilities
🌍 Support for 50+ languages
🔓 Fully decentralized voice processing
🎓 Educational platform for voice AI development

📈 Project Metrics

�📝 Changelog

Version 1.0.0 (October 11, 2025) 🎉

✨ First public release with full Azure AI integration
🎤 Advanced Azure Speech Recognition with wake word detection
🧠 Azure OpenAI integration for intelligent conversation
🔊 Premium text-to-speech with neural voices
🎵 Inter-app control for Spotify and calendar
📊 Real-time audio visualization with waveform display
🔐 Enterprise-grade security with environment configuration
🎨 Modern Material Design 3 interface
🌍 Multi-language support foundation (French + extensible)
🚫 Privacy-first approach with local data storage
🤖 Comprehensive CI/CD with automated testing
🛡️ Security scanning with automated vulnerability detection
🎃 Hacktoberfest 2025 ready with contribution guidelines
📖 Complete documentation and developer guides

🌟 Show Your Support

If HordVoice helps you or your project, please consider:

🤝 Connect With Us

HordVoice - Your intelligent voice companion 🎤

Made with ❤️ by HordRicJr and the open source community

🎃 Hacktoberfest 2025 • 🌟 Open Source • 🤖 Azure AI Powered • 🔓 MIT Licensed

"Empowering voices, enabling futures"

Name		Name	Last commit message	Last commit date
Latest commit History 83 Commits
.github		.github
android		android
assets		assets
database		database
lib		lib
test		test
web		web
windows		windows
.env.example		.env.example
.gitignore		.gitignore
.metadata		.metadata
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
SAFETY.md		SAFETY.md
analysis_options.yaml		analysis_options.yaml
coverage_config.yaml		coverage_config.yaml
gradle.properties		gradle.properties
l10n.yaml		l10n.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml
untranslated_messages.txt		untranslated_messages.txt

Uh oh!

License

HordRicJr/HordVoice

Folders and files

Latest commit

History

Repository files navigation