Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chiragagg5k/cal-buddy

smart calendar ai buddy that lets you schedule, manage and remind dates and tasks
https://github.com/chiragagg5k/cal-buddy

appwrite hacktoberfest nextjs typescript

Last synced: 2 months ago
JSON representation

smart calendar ai buddy that lets you schedule, manage and remind dates and tasks

Awesome Lists containing this project

README

        

# Cal Buddy

![GitHub stars](https://img.shields.io/github/stars/ChiragAgg5k/cal-buddy?style=social)
![GitHub forks](https://img.shields.io/github/forks/ChiragAgg5k/cal-buddy?style=social)
![GitHub issues](https://img.shields.io/github/issues/ChiragAgg5k/cal-buddy)
![GitHub license](https://img.shields.io/github/license/ChiragAgg5k/cal-buddy)
![GitHub last commit](https://img.shields.io/github/last-commit/ChiragAgg5k/cal-buddy)

![Thumbnail](/assets/thumbnail.png)

[Cal Buddy](https://cal-buddy.vercel.app/) is a smart calendar assistant that helps you schedule, manage, and chat with your calendar. Boost your productivity with AI-powered task management.

## Table of Contents

- [Cal Buddy](#cal-buddy)
- [Table of Contents](#table-of-contents)
- [Demo](#demo)
- [Features](#features)
- [Installation](#installation)
- [Technologies Used](#technologies-used)
- [Contributing](#contributing)
- [License](#license)

## Demo

https://github.com/user-attachments/assets/2978235f-36f3-475f-84bd-1da041dd9c34

You can also find the YouTube video demonstration [here](https://www.youtube.com/watch?v=qSlW9Z22YvM).

## Features

- 📅 Smart calendar management
- 🤖 AI-powered task scheduling
- 💬 Chat interface for easy interaction
- 📊 Productivity tracking and insights
- 🔗 Integration with popular calendar services

## Installation

1. Ensure you have [Node.js](https://nodejs.org/) and npm installed on your machine.
2. Clone the repository:

```bash
git clone https://github.com/ChiragAgg5k/cal-buddy.git
```

3. Navigate to the project directory:

```bash
cd cal-buddy
```

4. Create a `.env.local` file in the root directory and add the following content:

```
GROQ_API_KEY=
NEXT_PUBLIC_GOOGLE_CALENDAR_API_KEY=
NEXT_PUBLIC_APPWRITE_PROJECT_ID=
NEXT_PUBLIC_SITE_URL=
```

Replace ``, ``, ``, and `` with your actual values.

1. Install dependencies:

```bash
pnpm install
```

The project uses [pnpm](https://pnpm.io/) as the package manager. But you can use any other package manager of your choice like `npm` or `yarn`.

6. Start the development server:

```bash
pnpm dev
```

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

## Technologies Used

- [![Next.js](https://img.shields.io/badge/Next.js-000000?style=for-the-badge&logo=next.js&logoColor=white)](https://nextjs.org/)
- [![CopilotKit](https://img.shields.io/badge/CopilotKit-007ACC?style=for-the-badge&logo=github&logoColor=white)](https://github.com/features/copilot)
- [![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge&logo=tailwind-css&logoColor=white)](https://tailwindcss.com/)
- [![ShadCN](https://img.shields.io/badge/ShadCN-000000?style=for-the-badge&logo=shadcn&logoColor=white)](https://ui.shadcn.com/)
- [![Appwrite](https://img.shields.io/badge/Appwrite-F02E65?style=for-the-badge&logo=appwrite&logoColor=white)](https://appwrite.io/)

## Contributing

We welcome contributions to Cal Buddy! If you'd like to contribute, please follow these steps:

1. Fork the repository
2. Create a new branch (`git checkout -b feature/amazing-feature`)
3. Make your changes
4. Commit your changes (`git commit -m 'Add some amazing feature'`)
5. Push to the branch (`git push origin feature/amazing-feature`)
6. Open a Pull Request

Please read our [Contributing Guidelines](CONTRIBUTING.md) for more details.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.

---

Made with ❤️ by [Chirag Aggarwal](https://github.com/ChiragAgg5k)