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)

🚀 Features

🎯 Advanced Azure AI Voice Recognition

Azure Speech Recognition: Real-time speech-to-text with high accuracy
Wake Word Detection: Hands-free activation with "HordVoice"
Continuous Recognition: Seamless voice interaction
Phrase Hints System: Context-aware recognition optimization
Multi-language Support: French (fr-FR) with extensible language system
Noise Cancellation: Advanced audio processing for clear recognition

🧠 Intelligent Natural Language Processing

Azure OpenAI Integration: GPT-powered conversation understanding
Context-Aware Responses: Smart interpretation of voice commands
Intent Recognition: Accurate command classification and execution
Multi-turn Conversations: Maintain context across interactions
Smart Fallbacks: Graceful handling of unrecognized commands

🔊 Premium Text-to-Speech

Azure Neural Voices: High-quality, natural-sounding speech synthesis
Voice Customization: Multiple voice options and styles
Emotional Expression: Context-appropriate voice modulation
Speed & Pitch Control: Personalized speech parameters
Flutter TTS Fallback: Reliable offline voice synthesis

🎵 Inter-App Control & Automation

Spotify Integration: Voice control for music playbook
Calendar Management: Voice-activated calendar operations
Location Services: GPS-based contextual responses
App Launcher: Voice-controlled app navigation
Smart Home Integration: IoT device control capabilities

📊 Real-Time Audio Analytics

Voice Waveform Visualization: Live audio feedback
Volume Level Monitoring: Automatic gain control
Audio Quality Metrics: Real-time recognition confidence
Background Processing: Continuous voice monitoring
Audio Session Management: Optimized audio pipeline

🔐 Enterprise-Grade Security

Secure Configuration: Environment-based API key management
Local Data Storage: Privacy-first approach with local caching
Encrypted Storage: Secure user preferences and voice profiles
Permission Management: Granular access control
Azure Security: Enterprise-level cloud security standards

🎨 Modern & Intuitive Interface

Material Design 3: Contemporary Android design language
Dark/Light Themes: Adaptive UI based on system preferences
Smooth Animations: Fluid transitions and micro-interactions
Voice Activity Indicators: Visual feedback for voice interactions
Accessibility Support: Screen reader and accessibility features

⚙️ Advanced Configuration

Environment Management: Multiple deployment configurations
API Key Management: Secure credential handling
Service Toggles: Enable/disable specific features
Performance Tuning: Adjustable recognition parameters
Debug & Testing: Comprehensive development tools

📂 Project Structure

lib/
├── main.dart                              : Application entry point
│
├── core/                                  : Reusable base code
│   ├── constants/
│   │   └── constants.dart                 : Global constants and configurations
│   └── config/
│       └── app_initializer.dart           : App initialization and dependency injection
│
├── features/                              : Features by domain
│   ├── voice/                             : Voice interaction core
│   │   ├── pages/
│   │   │   ├── voice_home_page.dart       : Main voice interface
│   │   │   └── voice_settings_page.dart   : Voice configuration
│   │   └── widgets/
│   │       ├── voice_waveform.dart        : Audio visualization
│   │       └── voice_controls.dart        : Voice control buttons
│   │
│   ├── apps/                              : Inter-app integration
│   │   ├── services/
│   │   │   ├── spotify_service.dart       : Spotify API integration
│   │   │   └── calendar_service.dart      : Calendar management
│   │   └── pages/
│   │       └── app_control_page.dart      : App control interface
│   │
│   ├── settings/                          : Settings and configuration
│   │   └── pages/
│   │       ├── settings_page.dart         : Main settings
│   │       ├── voice_profile_page.dart    : Voice personalization
│   │       └── privacy_policy_page.dart   : Privacy policy
│   │
│   └── onboarding/                        : First-time user experience
│       └── pages/
│           ├── welcome_page.dart          : App introduction
│           ├── voice_setup_page.dart      : Voice calibration
│           └── permissions_page.dart      : Permission requests
│
└── shared/                                : Shared resources
    ├── models/
    │   ├── voice_models.dart              : Voice interaction data models
    │   ├── app_models.dart                : App integration models
    │   └── user_models.dart               : User profile models
    │
    ├── services/                          : Business services
    │   ├── azure_speech_service.dart      : Azure Speech Recognition
    │   ├── azure_openai_service.dart      : Azure OpenAI integration
    │   ├── audio_pipeline_service.dart    : Audio processing pipeline
    │   ├── wake_word_service.dart         : Wake word detection
    │   ├── voice_management_service.dart  : Voice profile management
    │   ├── environment_config.dart        : Configuration management
    │   ├── permission_manager_service.dart: Permissions handling
    │   └── integration_test_service.dart  : Service testing suite
    │
    └── widgets/                           : Shared UI components
        ├── voice_indicator.dart           : Voice activity indicator
        ├── audio_visualizer.dart          : Audio waveform display
        └── permission_dialog.dart         : Permission request dialogs

android/
├── app/
│   ├── src/main/kotlin/                   : Native Android integration
│   │   └── MainActivity.kt                : Azure Speech SDK native bridge
│   ├── build.gradle                       : Android build configuration
│   └── src/main/                          : Android resources and manifests
└── gradle/                                : Gradle configuration

assets/
├── audio/                                 : Audio samples and sounds
├── images/                                : App icons and illustrations
└── sounds/                                : System sounds and notifications

🏗️ 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

🛠️ 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

Comprehensive Test Suite

HordVoice includes a comprehensive test suite with >80% coverage target, specifically designed for Azure AI services integration.

Test Structure

test/
├── unit/                     # Unit tests for individual components
│   └── services/            # Azure AI services unit tests
├── integration/             # End-to-end integration tests
│   └── voice_pipeline_integration_test.dart
├── mocks/                   # Mock implementations
│   └── azure_services_mocks.dart
└── README.md               # Testing documentation

Run All Tests (Cross-Platform)

# Unix/Linux/macOS
./run_tests.sh

# Windows
run_tests.bat

# Manual execution
flutter test --coverage

Unit Tests

# Run all unit tests
flutter test test/unit/

# Run specific service tests
flutter test test/unit/services/azure_speech_service_test.dart
flutter test test/unit/services/azure_openai_service_test.dart

# Run with coverage
flutter test test/unit/ --coverage

Integration Tests

# Run complete voice pipeline tests
flutter test test/integration/

# Run specific integration test
flutter test test/integration/voice_pipeline_integration_test.dart

Test Coverage

# Generate coverage report
flutter test --coverage
genhtml coverage/lcov.info -o coverage/html
open coverage/html/index.html  # View coverage report

Mock Generation

# Generate mocks for testing
flutter packages pub run build_runner build --delete-conflicting-outputs

Code Analysis

flutter analyze

Azure Service Testing

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

# Test with different configurations
flutter run --dart-define=ENVIRONMENT=development
flutter run --dart-define=AZURE_SPEECH_MOCK=true

Test Features

🎯 Azure AI Services Unit Tests

Speech Recognition Service: Initialization, recognition, error handling, stream management
OpenAI Service: Intent analysis, response generation, emotion analysis, speech optimization
Environment Configuration: Credential management, fallback scenarios
Circuit Breaker: Resilience patterns, failure recovery

🔄 Integration Tests

Complete Voice Pipeline: Speech recognition → Intent analysis → Response generation → TTS
Error Recovery: Graceful handling of service failures
Performance Testing: Concurrent requests, memory management
Stream Processing: Real-time audio stream handling

🎭 Mock Services

Azure Speech Responses: Realistic test scenarios
OpenAI API Responses: Various intent types and error conditions
Environment Configurations: Different deployment scenarios
Error Scenarios: Network failures, authentication errors

📊 Coverage Targets

Overall Coverage: ≥80% line coverage
Azure Speech Service: ≥85% coverage
Azure OpenAI Service: ≥85% coverage
Critical Services: ≥80% coverage

Continuous Integration

All tests run automatically on:

🔄 Pull Request creation
🚀 Push to main branch
📅 Scheduled nightly builds
🎃 Hacktoberfest contributions

Environment Configuration

# Development environment
flutter run --dart-define=ENVIRONMENT=development

# Testing environment
flutter run --dart-define=ENVIRONMENT=test

# Production environment
flutter run --dart-define=ENVIRONMENT=production

📚 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 39 Commits
.github		.github
android		android
assets		assets
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
VOICE_OPTIMIZATION_SUMMARY.md		VOICE_OPTIMIZATION_SUMMARY.md
analysis_options.yaml		analysis_options.yaml
coverage_config.yaml		coverage_config.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml
run_tests.bat		run_tests.bat
run_tests.sh		run_tests.sh

License

enabasal/HordVoice

Folders and files

Latest commit

History

Repository files navigation