🧠 Memory Lane - Helping Alzheimer’s Patients Remember

📄 Publication

This work was published in the Proceedings of the 9th International Conference on Soft Computing: Theories and Applications (SoCTA 2024), organized at Malaviya National Institute of Technology (MNIT), Jaipur, Rajasthan, India, held from December 27 to 29, 2024.

Citation Details:
Zishan Ahmad, Vengadeswaran Shanmugasundaram
Department of Computer Science and Engineering
Indian Institute of Information Technology, Kottayam, Kerala, India
[email protected]

The proceedings of SoCTA 2024 will be published in the Lecture Notes in Networks and Systems (LNNS) series by Springer Nature, which is indexed in Scopus.

🎥 Demo Videos

Watch these videos to see Memory Lane in action:

• Memory Lane Feature Walkthrough
• Memory Lane Edge Cases

⚙️ Installation

1. Clone the repository to your local machine:

   git clone https://github.com/Spiral-Memory/MemoryLane.git

2. Navigate to the project directory:

   cd MemoryLane

3. Ensure Python 3.10.0 is installed to avoid dependency errors.

4. Create a virtual environment:

   python3 -m venv .venv

5. Activate the virtual environment:

   • On Windows:

     .venv\Scripts\activate

6. Install dependencies:

   pip install -r requirements.txt

📥 Installing Models

1. Download intent_cf_model, extract it, and place it in the root folder: Download intent_cf_model

2. Download vosk-model-small-en-in-0.4 for speech-to-text and place it in the root folder: Download vosk-model-small-en-in-0.4

🧪 Creating Models for Testing

To generate the intent_cf_model manually:

cd dev_test/intent_train
python train.py

🗄️ Setting Up the Database

1. Create a .env file and add your MongoDB connection string:

   DB_URL=mongodb+srv://username:password@cluster_url/?retryWrites=true&w=majority&appName=appName
   

🚀 Usage

1. Head to main.py

2. Run the main script:

   python main.py

The script launches an Assistance Bot for user interaction.

Options Menu

3. Choose an action by entering the corresponding number:

   • 1: Add a new relative
   • 2: Start recognition
   • 3: Exit the program

Adding a New Relative

• Enter name, address, relationship, and gender
• Upload relative’s images
• The system generates facial embeddings and updates the detector

Starting Recognition

• Choose between:

  • Voice Mode (Option 1)
  • Text Mode (Option 2)

The bot will assist accordingly.

Exiting the Program

• Select option 3 to exit gracefully

Invalid Input Handling

• On invalid input, you’ll see: "Invalid Choice"
• The bot will prompt you again

Just follow the terminal prompts, and the bot will walk you through everything smoothly.