Search packages, repositories and app categories

GitHub repositoryminhph091/amoura-final-project

amoura-final-project

Amoura is a modern, full-stack dating platform that leverages Artificial Intelligence to foster deep and meaningful connections. Built on a pragmatic microservices architecture, it features an intelligent ML-powered matching system using Logistic Regression, AI-assisted message editing with Google Gemini, and real-time communication via WebSocket.

amoura-final-project project cover
Stars
2
Forks
1
Last push (UTC)
Aug 15, 2025
Project status
Active

Original README

English project snapshot. Visit GitHub for the latest content.

🌟 Amoura - AI-Powered Dating Platform

Amoura is a modern, full-stack dating application that leverages artificial intelligence to enhance user connections and communication. The platform provides intelligent matchmaking and AI-assisted messaging features to create meaningful relationships.

✨ Key Features

  • 🤖 AI-Powered Matching: Intelligent algorithm to find compatible matches based on user preferences and behavior
  • 💬 AI Message Enhancement: Smart message editing and optimization to improve communication
  • 📱 Mobile Application: Cross-platform mobile app for seamless user experience
  • 🎯 Admin Dashboard: Comprehensive admin panel for platform management
  • 🌐 Landing Page: Attractive web presence to showcase the platform
  • 🔒 Secure Backend: Robust Spring Boot backend with comprehensive error handling

🏗️ Architecture

This project follows a microservices architecture with the following components:

  • Backend (/backend): Spring Boot REST API with Java
  • AI Service (/ai_service): Dedicated AI/ML service for matching and message processing
  • Mobile App (/mobile_app): Cross-platform mobile application
  • Admin Dashboard (/admin_dashboard): Web-based administrative interface
  • Landing Page (/landing_page): Marketing and information website
  • Data Management (/insert_data): Database seeding and data management tools

🛠️ Technology Stack

  • Backend: Java, Spring Boot, Maven
  • AI/ML: Custom AI service for intelligent matching and message enhancement
  • Database: PostgresSQL
  • Mobile: Flutter
  • Frontend: React, TypeScript
  • DevOps: GitHub Actions CI/CD

🛠️ Development Requirements

  • Java: Version 17 or higher
  • Database: PostgreSQL 17.5
    • Username: postgres
    • Password: 123456789

🚀 Core Functionality

AI Matching System
  • Intelligent user compatibility analysis
  • Personalized match recommendations
  • Adaptive learning from user interactions
Smart Messaging
  • AI-powered message editing and enhancement
  • Communication optimization suggestions
  • Fallback mechanisms for service reliability

📋 Getting Started

To set up the project locally, follow these steps:

# Clone the repository
git clone https://github.com/minhph091/amoura-final-project.git
cd amoura-final-project

# Start the backend service
cd backend
./mvnw spring-boot:run

Mei GitHub avatar
GitHub author

Mei ↗

Vietnam
LanguagesDartTypeScriptJavaHTMLPythonC++CSSCMakePLpgSQLSwiftCJavaScriptObjective-C

Categories

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗