Skip to content

Latest commit

 

History

History
133 lines (92 loc) · 4.5 KB

README.md

File metadata and controls

133 lines (92 loc) · 4.5 KB

MayDay - Smart Calendar App

Smart Calendar Logo

Ever feel like adding events to your calendar is just another chore? Whether it's scheduling lectures, study sessions, or practice, it can be a headache trying to fit everything in without conflicts.

The Smart Calendar App fixes that. It automates the process, adding events and intelligently allocating time based on your schedule. No more juggling or guessing—just let the app handle it. It’s like having a personal assistant for your day!

Flowchart Algorithm

Tech Stack

  • Python - Core logic for event handling
  • Flask - Web framework
  • Google Calendar API - For calendar event integration
  • OpenAI API - AI-powered suggestions for event timing

How to Run

  1. Clone the repository:

    git clone https://github.com/BENi-Aditya/Calendar_app.git

  2. Navigate to the project directory:

    cd Calendar_app

  3. Create and activate a virtual environment:

    python3 -m venv venv
source venv/bin/activate  # For Windows use `venv\Scripts\activate`

  4. Install the required libraries:

    pip install -r requirements.txt

  5. Create a .env file in the project root and add your API keys:

    touch .env

  6. Add the following to your .env file:

    OPENAI_API_KEY=your_openai_api_key
GOOGLE_CALENDAR_API_KEY=your_google_calendar_api_key

  7. Run the application:

    python save.py

  8. Follow the prompt to enter the event name and select whether to auto-allocate event time.

Usage

  • Enter the event name when prompted.
  • Select whether to enable automatic time allocation using AI suggestions.
  • The app will suggest the best time for the event based on your calendar availability.
  • Check your Google Calendar to see the event with its correct duration and allocated time.

Features

  • Automated event time suggestions based on calendar availability using OpenAI API.
  • Seamless integration with Google Calendar to create and manage events.
  • Automatic detection of overlapping events to prevent scheduling conflicts.
  • Supports both manual and automatic time allocation modes for flexibility.

Need for the Idea

In today's fast-paced world, managing time efficiently is essential. Our Calendar App is designed to automate the process of finding the perfect event time based on your availability and preferences, reducing the hassle of manually checking for free slots and preventing schedule conflicts. With AI-assisted suggestions, it ensures that your events are intelligently allocated, saving time and effort.

Contributions

We welcome contributions from the community to improve this project! Feel free to fork the repository, make your changes, and submit a pull request. Please ensure your contributions align with the project's goals and adhere to our coding standards.

Here's how you can contribute:

  • Fork the repository: https://github.com/BENi-Aditya/Calendar_app
  • Create a new branch: git checkout -b feature-branch-name
  • Make your changes and commit them: git commit -m 'Description of your changes'
  • Push to the branch: git push origin feature-branch-name
  • Submit a pull request

Built with ❤️ by BENi-Aditya