AICalendar

AICalendar is a cross-platform AI-powered calendar application built with .NET MAUI and Blazor. It provides an AI Scheduling Assistant that can suggest optimal meeting times and event slots based on your availability, preferences, and past scheduling patterns. The app offers a familiar calendar interface via a Blazor Web UI, while also delivering native performance and UI consistency across Android, iOS, Windows, and Mac devices. You can create, edit, and delete events, set reminders, toggle dark/light themes, and leverage cloud sync for data across devices. Authentication is included to securely access your calendar data, and localization/RTL support ensures usability for a global audience.

To use the server, run the AICalendar MCP server locally and access the Blazor interface or API endpoints as configured by your environment. The tooling around AICalendar (as indicated in the README) focuses on .NET tooling for database evaluations and migrations, which can be useful during development and testing of the calendar data model and AI evaluation components.

Prerequisites:

• Install the .NET SDK (recommended: .NET 7.x or newer) and ensure it is available on your PATH.
• (Optional for MAUI development) Install MAUI workloads per your platform guidance if you plan to build or debug MAUI apps locally.
• Have a supported IDE or editor (Visual Studio 2022/2023 with MAUI workloads, or VS Code with C# extension).

Installation steps:

1. Clone the repository:

git clone https://github.com/your-org/AICalendar.git
cd AICalendar

2. Restore and build the project (from the repository root or the MAUI project path):

dotnet restore
dotnet build --configuration Release

3. Run the application (server) locally:

dotnet run --project AICalendar/AICalendar.csproj

4. If you need to perform database migrations or AI evaluation tooling (as suggested by the README hooks):

dotnet tool update --global dotnet-ef
dotnet tool install --local Microsoft.Extensions.AI.Evaluation.Console
dotnet tool run aieval report --path C:/TestReports --output report.html --open

5. Access the Blazor UI or API endpoints as exposed by the app once it starts (typically at http://localhost:5083 or the configured port).

Tips and notes:

• Ensure the .NET MAUI workloads are installed if you intend to run the native mobile versions locally; otherwise, you can rely on the Blazor Web UI for browser access.
• If you encounter port conflicts, change the server port by configuring environment or app settings (the README snippet mentions port 5083 as an example).
• For AI features, ensure you have any required AI model weights or services configured as per the project documentation (e.g., remote AI services or embedded models).
• The tooling commands in the README (dotnet-ef, Microsoft.Extensions.AI.Evaluation.Console) are useful for migrations and AI evaluation reporting during development.
• Localization and RTL support may require proper locale configuration on the host OS for full testing in non-Latin scripts.