Zero Calendar offers an open-source, AI-native calendar solution designed to intelligently manage user schedules. It targets users seeking a privacy-first, self-hostable alternative to conventional, data-hungry calendar services, promising enhanced time management through AI agents.

How It Works

The platform leverages AI agents and LLMs to automate and optimize scheduling tasks, integrating seamlessly with external providers like Google Calendar. Its architecture utilizes a modern stack: Next.js, React, TypeScript, TailwindCSS, and Shadcn UI for the frontend; Next.js API Routes and Server Actions for the backend; Vercel KV (Redis) for database operations; and NextAuth.js with Google OAuth for authentication. This approach prioritizes transparency, data privacy, and extensibility.

Quick Start & Requirements

Installation involves cloning the repository (git clone https://github.com/Zero-Calendar/zero-calendar.git), installing dependencies (npm install or pnpm install), and running the development server (npm run dev or pnpm dev). Prerequisites include Node.js (v18+) and npm (v9+) or pnpm (v8+). Essential environment variables require configuration for NextAuth, Google OAuth (client ID/secret), Vercel KV (connection details), and Groq API key for AI features. A detailed setup for Google Cloud APIs (Calendar, People, OAuth 2.0) and Vercel KV is necessary, with specific redirect URIs to configure.

Highlighted Details

• AI Assistant for natural language schedule interaction.
• Direct synchronization with Google Calendar.
• Customizable User Interface with dark mode support.
• Robust handling of recurring events, including exceptions.
• Comprehensive timezone management for global scheduling.
• Data import/export capabilities via ICS and CSV formats.
• Extensive keyboard shortcuts for efficient navigation and operation.

Maintenance & Community

The provided README does not detail specific community channels (e.g., Discord, Slack), active contributors, or sponsorship information.

Licensing & Compatibility

Zero Calendar is licensed under the GNU General Public License v3.0 (GPLv3). This copyleft license mandates that any derivative works distributed must also be made available under the GPLv3, potentially impacting integration with proprietary or closed-source projects.

Limitations & Caveats

The README does not explicitly state project limitations or known issues. However, the setup process requires significant configuration of external services (Google Cloud, Vercel KV, Groq API), presenting a potential barrier to entry for less technically experienced users.