Secr-AI-tary

Secr-AI-tary is an experimental AI-powered personal secretary that orchestrates multiple agents to help with tasks like calendar management, travel planning, and data visualization. It integrates with Google Calendar API for calendar management, and with Amadeus API for travelling related tasks.

System design

How to run

Prerequisites

• Python 3.12 or newer
• Install dependencies from pyproject.toml
• Required environment variables (also available in .env.template):
  • MISTRAL_API_KEY or GEMINI_API_KEY or CEREBRAS_API_KEY — API key for the chosen LLM provider
  • GOOGLE_SERVICE_ACCOUNT_JSON — JSON string of a Google service account (used by calendar init)
  • GOOGLE_CALENDAR_ID — the Calendar ID to use for creating demo events

Run the project with UV

Install dependencies:

uv sync

Run the project (with Mistral):

uv run main.py --mistral

Initialize the calendar with model events:

uv run main.py --mistral --init

Alternatively, use Makefile:

make run-mistral