{"id":28907859,"url":"https://github.com/ms-rex/nexora-competition","last_synced_at":"2026-05-10T05:34:03.499Z","repository":{"id":298710103,"uuid":"1000833656","full_name":"MS-Rex/nexora-competition","owner":"MS-Rex","description":" AI-powered voice chat application ecosystem designed to revolutionize university communication and support.","archived":false,"fork":false,"pushed_at":"2025-06-12T18:22:59.000Z","size":747,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-21T16:06:20.760Z","etag":null,"topics":["flutter","landing-page","laravel","mobile-app","python","webapp"],"latest_commit_sha":null,"homepage":"https://nexora-chat.vercel.app/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MS-Rex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T11:48:18.000Z","updated_at":"2025-06-13T20:24:14.000Z","dependencies_parsed_at":"2025-06-12T13:40:17.707Z","dependency_job_id":null,"html_url":"https://github.com/MS-Rex/nexora-competition","commit_stats":null,"previous_names":["ms-rex/nexora-competition"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MS-Rex/nexora-competition","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MS-Rex%2Fnexora-competition","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MS-Rex%2Fnexora-competition/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MS-Rex%2Fnexora-competition/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MS-Rex%2Fnexora-competition/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MS-Rex","download_url":"https://codeload.github.com/MS-Rex/nexora-competition/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MS-Rex%2Fnexora-competition/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261153586,"owners_count":23116916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flutter","landing-page","laravel","mobile-app","python","webapp"],"created_at":"2025-06-21T16:06:20.738Z","updated_at":"2026-05-10T05:34:03.493Z","avatar_url":"https://github.com/MS-Rex.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nexora University Copilot\n\n![Nexora Cover Photo](images/cover_photo.png)\n_Nexora - AI-Powered University Communication Ecosystem_\n\n## Project Overview\n\nNexora is an AI-powered voice chat application ecosystem designed to revolutionize university communication and support. Our comprehensive solution combines real-time voice conversations, intelligent AI agents, and modern web interfaces to create an seamless educational technology platform. Built for the Nexora 1.0 Inter-University Datathon 2025, this project demonstrates advanced AI agent orchestration, real-time communication, and intelligent user interaction capabilities.\n\nThe Nexora ecosystem consists of three integrated components working together to provide a complete AI-powered university communication solution.\n\n## System Architecture\n\nOur project is organized into four main repositories, each handling a specific component of the Nexora ecosystem:\n\n### 📱 [Mobile Application](https://github.com/MS-Rex/nexora-app.git)\n\n**Flutter-based AI Voice Chat App**\n\n- Real-time voice conversations with AI agents\n- Beautiful animated UI with voice visualizations\n- WebSocket communication for instant responses\n- Speech recognition and audio processing\n- Cross-platform mobile experience (iOS \u0026 Android)\n\n### 🤖 [AI Agentic System](https://github.com/MS-Rex/nexora-ai.git)\n\n**Backend AI Engine \u0026 Agent Orchestration**\n\n- Intelligent conversation processing\n- Voice-to-text and text-to-voice conversion\n- AI agent management and coordination\n- Machine learning pipeline integration\n\n### 🌐 [Web Application](https://github.com/nilanviduranga/uni-chat-bot.git)\n\n**University Chat Interface**\n\n- University chatbot web interface\n- Web-based chat functionality\n- Real-time messaging system\n\n### 🎨 [Landing Page](https://github.com/MS-Rex/nexora-landing.git)\n\n**Marketing Platform \u0026 Competition Entry**\n\n- Modern Next.js 15 landing page\n- Competition showcase and information\n- Responsive design with dark/light theme\n- Built by Team RexFlow for Nexora 1.0 Datathon\n\n[![Watch the video](https://img.youtube.com/vi/l6LxqBMR7uM/maxresdefault.jpg)](https://www.youtube.com/watch?v=l6LxqBMR7uM)\n_Watch This Demo_\n\n## Features\n\n### Core Features\n\n- **Real-time Voice Chat**: Instant AI-powered voice conversations\n- **Cross-platform Mobile App**: Native experience on iOS and Android\n- **Intelligent AI Agents**: Advanced conversation processing and responses\n- **Web Chat Interface**: Browser-based chatbot for universities\n- **WebSocket Communication**: Real-time bidirectional data exchange\n- **Speech Recognition**: Advanced voice-to-text capabilities\n- **Voice Synthesis**: Natural AI voice responses\n\n### Additional Features\n\n- **Beautiful Animations**: Dynamic voice wave patterns and breathing effects\n- **Multi-platform Support**: Mobile, web, and backend integration\n- **Secure Communication**: Encrypted real-time data transmission\n- **User Authentication**: Secure user management system\n- **Chat History**: Persistent conversation storage\n- **Permission Management**: Granular device permission control\n\n## Tech Stack\n\n### Mobile Frontend (Flutter App)\n\n- **Frontend**: Flutter 3.29.1, Dart, Material Design 3\n- **State Management**: BLoC Pattern, Injectable DI\n- **Navigation**: Auto Route\n- **Audio**: Record Package, AudioPlayers\n- **Communication**: WebSocket, JSON\n\n### Backend (AI Agentic System)\n\n- **Backend**: Laravel (PHP framework)\n- **Real-time Communication**: Pusher (WebSocket service)\n- **Authentication \u0026 Authorization**: Spatie Laravel Permission (Role management)\n- **Database**: MySQL\n- **AI/ML**: OpenAI Whisper (Small model - 244M parameters)\n- **Voice Processing**: OpenAI Whisper for speech recognition and transcription\n- **Communication**: WebSocket Gateway, REST APIs\n\n### Web Application\n\n- **Frontend**: Next.js (React-based framework)\n- **Backend**: Laravel (PHP framework)\n- **Database**: MySQL\n\n## Live Infrastructure\n\nOur complete Nexora ecosystem is deployed and running live on AWS cloud infrastructure:\n\n### AWS Architecture\n\n- **🖥️ EC2 Instance 1**: Laravel backend server\n- **🖥️ EC2 Instance 2**: FastAPI AI processing server\n- **🗄️ Amazon RDS**: Managed relational database service\n- **📊 Sentry**: Real-time error tracking and performance monitoring\n- **🌐 Load Balancing**: Distributed across multiple availability zones\n\n### Monitoring \u0026 Operations\n\n- **Error Tracking**: Sentry integration for real-time error monitoring\n- **Performance Monitoring**: Application performance insights and alerting\n- **Database Management**: Amazon RDS for scalable and reliable data storage\n- **Auto-scaling**: EC2 instances configured for dynamic scaling based on demand\n\n**🚀 Live Demo**: [https://nexora-chat.vercel.app/](https://nexora-chat.vercel.app/)\n\n## Screenshots/Demo\n\n### Mobile Application Demo\n\n![Mobile UI Design](images/mobile-ui.png)\n_Mobile app UI design created in Figma showcasing the voice chat interface and animations_\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cimg src=\"images/app_home_page.png\" alt=\"Mobile Home Page\" /\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eNexora mobile app home screen showing the clean and intuitive user interface\u003c/em\u003e\u003c/p\u003e\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cimg src=\"images/app_voice_mode.png\" alt=\"Voice Chat Mode\" /\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eActive voice chat mode with real-time voice visualization and AI interaction interface\u003c/em\u003e\u003c/p\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n_Additional screenshots and demo videos available in the [mobile app repository](https://github.com/MS-Rex/nexora-app.git)_\n\n### Web Application Demo\n\n![Web Application Home Page](images/web_homepage.jpg)\n_Nexora web application home page featuring the university chatbot interface built with Next.js_\n\n_Additional screenshots and demo videos available in the [web app repository](https://github.com/nilanviduranga/uni-chat-bot.git)_\n\n### Overall System Architecture\n\n![Nexora System Architecture](images/overall_architecture.png)\n_Complete Nexora ecosystem architecture diagram showing all components and their interactions_\n\n\u003cdetails\u003e\n\u003csummary\u003e📊 Interactive Architecture Diagram (Click to expand)\u003c/summary\u003e\n\n```mermaid\nflowchart TD\n    %% Users Layer\n    MobileUser[\"📱 Mobile User\u003cbr/\u003e(Flutter App)\"]\n    WebUser[\"🌐 Web User\u003cbr/\u003e(Next.js)\"]\n\n    %% Frontend Layer\n    subgraph Frontend[\"Frontend Layer\"]\n        Mobile[\"📱 Mobile App\u003cbr/\u003eFlutter 3.29.1\u003cbr/\u003e• BLoC State Management\u003cbr/\u003e• Auto Route Navigation\u003cbr/\u003e• Material Design 3\u003cbr/\u003e• WebSocket Client\u003cbr/\u003e• Audio Recording\"]\n        Web[\"🌐 Web Application\u003cbr/\u003eNext.js\u003cbr/\u003e• React Framework\u003cbr/\u003e• University Chat Interface\u003cbr/\u003e• Landing Pages\u003cbr/\u003e• Responsive Design\"]\n    end\n\n    %% Communication Layer\n    subgraph Communication[\"Communication Layer\"]\n        WebSocket[\"📡 WebSocket\u003cbr/\u003ePusher Service\u003cbr/\u003e• Real-time messaging\u003cbr/\u003e• Voice data streaming\u003cbr/\u003e• Connection management\"]\n        RestAPI[\"🔗 REST APIs\u003cbr/\u003eLaravel Endpoints\u003cbr/\u003e• Authentication\u003cbr/\u003e• Data operations\u003cbr/\u003e• File uploads\"]\n    end\n\n    %% Backend Services\n    subgraph Backend[\"Backend Services Layer\"]\n        Laravel[\"🛠️ Laravel Backend\u003cbr/\u003eEC2 Instance 1\u003cbr/\u003e• User Authentication\u003cbr/\u003e• Spatie Permissions\u003cbr/\u003e• Chat Management\u003cbr/\u003e• API Gateway\"]\n        FastAPI[\"🤖 FastAPI AI Server\u003cbr/\u003eEC2 Instance 2\u003cbr/\u003e• Voice Processing\u003cbr/\u003e• AI Agent Orchestration\u003cbr/\u003e• OpenAI Whisper Integration\u003cbr/\u003e• ML Pipeline\"]\n    end\n\n    %% AI/ML Layer\n    subgraph AI[\"AI/ML Processing\"]\n        Whisper[\"🎤 OpenAI Whisper\u003cbr/\u003eSmall Model (244M)\u003cbr/\u003e• Speech-to-Text\u003cbr/\u003e• Language Detection\u003cbr/\u003e• Audio Transcription\"]\n        AIAgent[\"🧠 AI Agents\u003cbr/\u003e• Conversation Processing\u003cbr/\u003e• Response Generation\u003cbr/\u003e• Context Management\"]\n    end\n\n        %% Data Layer\n    subgraph Data[\"Data Layer\"]\n        MySQL[\"🗄️ MySQL Database\u003cbr/\u003eAmazon RDS\u003cbr/\u003e• User Data\u003cbr/\u003e• Chat History\u003cbr/\u003e• Authentication\u003cbr/\u003e• Analytics\u003cbr/\u003e• Voice Transcriptions\"]\n    end\n\n    %% Infrastructure Layer\n    subgraph Infrastructure[\"AWS Infrastructure\"]\n        LoadBalancer[\"⚖️ Load Balancer\u003cbr/\u003e• Traffic Distribution\u003cbr/\u003e• High Availability\u003cbr/\u003e• Auto-scaling\"]\n    end\n\n    %% External Services\n    subgraph External[\"External Services\"]\n        Sentry[\"📊 Sentry Monitoring\u003cbr/\u003e• Error Tracking\u003cbr/\u003e• Performance Metrics\u003cbr/\u003e• Real-time Alerts\u003cbr/\u003e• Application Monitoring\"]\n    end\n\n    %% User Connections\n    MobileUser --\u003e Mobile\n    WebUser --\u003e Web\n\n    %% Frontend to Communication\n    Mobile --\u003e WebSocket\n    Mobile --\u003e RestAPI\n    Web --\u003e RestAPI\n\n    %% Communication to Backend\n    WebSocket --\u003e Laravel\n    RestAPI --\u003e Laravel\n\n    %% Backend Connections\n    Laravel --\u003e MySQL\n    Laravel --\u003e FastAPI\n    FastAPI --\u003e Whisper\n    FastAPI --\u003e AIAgent\n    FastAPI --\u003e MySQL\n\n        %% Infrastructure Connections\n    LoadBalancer --\u003e Laravel\n    LoadBalancer --\u003e FastAPI\n\n    %% External Service Connections\n    Sentry --\u003e Laravel\n    Sentry --\u003e FastAPI\n\n    %% Styling\n        classDef userLayer fill:#e3f2fd,stroke:#1976d2,stroke-width:2px\n    classDef frontendLayer fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px\n    classDef commLayer fill:#e8f5e8,stroke:#388e3c,stroke-width:2px\n    classDef backendLayer fill:#fff3e0,stroke:#f57c00,stroke-width:2px\n    classDef aiLayer fill:#fce4ec,stroke:#c2185b,stroke-width:2px\n    classDef dataLayer fill:#f1f8e9,stroke:#689f38,stroke-width:2px\n    classDef infraLayer fill:#f5f5f5,stroke:#616161,stroke-width:2px\n    classDef externalLayer fill:#fff8e1,stroke:#ff8f00,stroke-width:2px\n\n    class MobileUser,WebUser userLayer\n    class Mobile,Web frontendLayer\n    class WebSocket,RestAPI commLayer\n    class Laravel,FastAPI backendLayer\n    class Whisper,AIAgent aiLayer\n    class MySQL dataLayer\n    class LoadBalancer infraLayer\n    class Sentry externalLayer\n```\n\n\u003c/details\u003e\n\n_Complete Nexora ecosystem architecture showing the integration of mobile app, web application, AI processing, and AWS infrastructure_\n\n## Setup Instructions\n\nTo run the complete Nexora ecosystem locally, you'll need access to several external services and APIs. Follow the setup instructions for each component:\n\n### Prerequisites \u0026 External Services\n\nBefore setting up the local environment, ensure you have access to the following services:\n\n#### Required API Keys \u0026 Services:\n\n- **🤖 OpenAI API**: Required for AI conversation processing and language models\n- **📊 Logfire API**: Required for advanced logging and monitoring\n- **📈 Sentry API**: Required for error tracking and performance monitoring\n- **☁️ AWS RDS URL**: Required for database connectivity (alternatively, set up local MySQL)\n- **🎤 OpenAI Whisper Model**: Can be run locally (Small model - 244M parameters)\n\n#### Environment Variables:\n\nCreate `.env` files in each repository with the following required variables:\n\n```bash\n# OpenAI Configuration\nOPENAI_API_KEY=your_openai_api_key_here\n\n# Logfire Configuration\nLOGFIRE_API_KEY=your_logfire_api_key_here\n\n# Sentry Configuration\nSENTRY_DSN=your_sentry_dsn_here\n\n# Database Configuration\nAWS_RDS_URL=your_aws_rds_connection_string\n# OR for local development:\nDB_CONNECTION=mysql\nDB_HOST=127.0.0.1\nDB_PORT=3306\nDB_DATABASE=nexora_local\nDB_USERNAME=your_username\nDB_PASSWORD=your_password\n\n# Pusher Configuration (for WebSocket)\nPUSHER_APP_ID=your_pusher_app_id\nPUSHER_KEY=your_pusher_key\nPUSHER_SECRET=your_pusher_secret\n```\n\n### If you Love be Alpha tester on Production Application use below credentials to login (Its not fully functional due limited resources and time but soon will be full update to latest code)\n\nEmail : test-user@nexora.com\nOTP : 123456\n\n### Local Development Setup\n\nTo run the complete Nexora ecosystem locally, follow the setup instructions for each component:\n\n### 1. Mobile Application Setup\n\n```bash\n# Clone the mobile app repository\ngit clone https://github.com/MS-Rex/nexora-app.git\ncd nexora-app\n\n# Install Flutter dependencies\nflutter pub get\n\n# Generate required files\ndart run build_runner build --delete-conflicting-outputs\n\n# Run the mobile application\nflutter run\n```\n\n### 2. AI Agentic System Setup\n\n```bash\n# Clone the AI system repository\ngit clone https://github.com/MS-Rex/nexora-ai.git\ncd nexora-ai\n\n# [Placeholder: Installation instructions]\n# Follow setup instructions in the AI system repository\n```\n\n### 3. Web Application Setup\n\n```bash\n# Clone the web app repository\ngit clone https://github.com/nilanviduranga/uni-chat-bot.git\ncd uni-chat-bot\n\n# [Placeholder: Installation instructions]\n# Follow setup instructions in the web application repository\n```\n\n### Alternative Local Setup (Without External Services)\n\nIf you prefer to run everything locally without external dependencies:\n\n#### Local MySQL Setup:\n\n```bash\n# Install and configure local MySQL\nsudo apt-get install mysql-server  # Ubuntu/Debian\nbrew install mysql                 # macOS\n\n# Create local database\nmysql -u root -p\nCREATE DATABASE nexora_local;\n```\n\n#### Local Whisper Setup:\n\n```bash\n# Install OpenAI Whisper locally\npip install openai-whisper\n\n# Download the small model (244M parameters)\nwhisper --model small --download-root ./models\n```\n\n#### Minimal Environment Configuration:\n\nFor basic local development, you can use minimal configuration:\n\n```bash\n# Minimal .env for local development\nDB_CONNECTION=mysql\nDB_HOST=127.0.0.1\nDB_DATABASE=nexora_local\nWHISPER_MODEL_PATH=./models/small.pt\n```\n\nRefer to the individual repository README files for component-specific configuration details and additional setup options.\n\n## Repository Links\n\n| Component     | Repository                                                         | Description                                    |\n| ------------- | ------------------------------------------------------------------ | ---------------------------------------------- |\n| 📱 Mobile App | [nexora-app](https://github.com/MS-Rex/nexora-app.git)             | Flutter-based AI voice chat mobile application |\n| 🤖 AI System  | [nexora-ai](https://github.com/MS-Rex/nexora-ai.git)               | Backend AI engine and agent orchestration      |\n| 🌐 Web App    | [uni-chat-bot](https://github.com/nilanviduranga/uni-chat-bot.git) | Web interface and landing page                 |\n\n## Team\n\n- **Team Member 1** – AI/ML \u0026 Mobile Developer \u0026 Project Lead\n- **Team Member 2** – AI/ML Engineer \u0026 Backend Developer\n- **Team Member 3** – Web Developer \u0026 Frontend Developer\n- **Team Member 4** – UI/UX Designer \u0026 API Integration Specialist\n\n_Team RexFlow - Where AI meets innovation and data fuels transformation!_\n\n## Documentation\n\n- **Mobile App Documentation**: Available in [nexora-app repository](https://github.com/MS-Rex/nexora-app.git)\n- **AI System Documentation**: Available in [nexora-ai repository](https://github.com/MS-Rex/nexora-ai.git)\n- **Web App Documentation**: Available in [uni-chat-bot repository](https://github.com/nilanviduranga/uni-chat-bot.git)\n\n## Competition Details\n\n**🏆 Nexora 1.0 Inter-University Datathon 2025**\n\nThis project represents a complete AI-powered university communication ecosystem, showcasing:\n\n- Advanced AI agent orchestration\n- Real-time voice and text communication\n- Cross-platform mobile and web applications\n- Intelligent conversation processing\n- Modern UI/UX design principles\n\n**Prizes:** 🥇 LKR 50,000 | 🥈 LKR 30,000 | 🥉 LKR 20,000\n\n## Submission\n\n**Developed for Nexora 1.0 – Round 2**  \n**Submission Date**: 12th June 2025\n\n**Live Demo**: https://nexora-chat.vercel.app/\n**Project Website**: [nexora.msanjana.com](https://nexora.msanjana.com/)\n\n---\n\n## Contact \u0026 Support\n\n- 📧 **Email**: miyurusanjana@gmail.com\n- 🌐 **Website**: https://nexora-chat.vercel.app/\n- 💬 **Issues**: Use the individual repository issue trackers\n\n---\n\n**Made with ❤️ by Team RexFlow**  \n_Transforming university communication through AI-powered innovation_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fms-rex%2Fnexora-competition","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fms-rex%2Fnexora-competition","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fms-rex%2Fnexora-competition/lists"}