ADHD Assistant

ADHD Assistant is a smart productivity tool designed to help individuals with Attention-Deficit/Hyperactivity Disorder (ADHD) stay organized, manage time effectively, and improve daily productivity through a natural conversational interface.

By using natural language processing, the assistant can create calendar events, notes, and reminders directly from everyday conversations—making organization effortless and accessible.

---

Features

• Conversational Interface

  • Interact naturally to create tasks, events, or notes without rigid command structures.
  • Seamless integration with a user-friendly language model.

• Note Management

  • Create, edit, categorize, and update notes via natural language input or manually.
  • Tag notes as to-do or done for effective task tracking.
  • Access all notes in a dedicated dashboard.

• Event Management

  • Create calendar events from casual conversations (e.g., “Schedule soccer game on July 1st at 4 PM”).
  • Edit event details: title, date, description, reminders, and associated to-do lists.
  • Track event status: Attended, Cancelled, or Missed.
  • Assign priority levels to events.

• Smart Notifications

  • Get proactive alerts for upcoming events and due tasks.
  • Take quick actions directly from notifications (reschedule, update status, dismiss).

• Contact Management

  • Save and manage contacts for collaborative event planning.

• Calendar View

  • Centralized view of all scheduled events.
  • Edit or review past and upcoming events interactively.

• Performance Dashboard

  • Track number of attended events, completed tasks, and missed/cancelled events.
  • Visualize personal progress to encourage self-awareness and improvement.

---

Configuration

Prerequisites

• Node.js (v22 or higher recommended)
• npm or yarn package manager

---

Setup Instructions

Run Locally

1. Clone the repository

   git clone https://github.com/MatheusMarinhoLeca/ADHD-Assistant.git
   cd ADHD-Assistant

2. Install dependencies

   npm install
   # or
   yarn install

3. Run the application

   npm start
   # or
   yarn start

   The app will be available at http://localhost:3000.

---

Build for Production

npm run build
# or
yarn build

The optimized production build will be output to the build/ directory.

---

Feedback

If you have feedback, ideas, or suggestions, please reach out via email: matheus.demoraisleca@ucalgary.ca

---

Authors

• @MatheusMarinhoLeca

---

License

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

---

⚠ Disclaimer: This application is designed as a productivity aid and should not be considered medical advice or a substitute for professional ADHD treatment.