A curated collection of practical AI projects implementing OCR systems, RAG, AI agents, and other AI use cases.
audit: fix cal_scheduling_agent - add env comments, rewrite em dashes, add docstring, add uv setup steps
Tiioluwani0c5e11917472
diff --git a/ai_agents/cal_scheduling_agent/.env.example b/ai_agents/cal_scheduling_agent/.env.exampleindex 7d9e270..9e2c6dc 100644--- a/ai_agents/cal_scheduling_agent/.env.example+++ b/ai_agents/cal_scheduling_agent/.env.example@@ -1,3 +1,8 @@+# Google API key used to authenticate Gemini 3 Flash requests. Get one free at https://aistudio.google.comGOOGLE_API_KEY=your_google_api_key_here++# Cal.com API key for reading and managing calendar data. Generate one at https://app.cal.com/settings/developer/api-keysCALCOM_API_KEY=your_calcom_api_key_here-CALCOM_EVENT_TYPE_ID= # optional — scopes availability to a specific event type++# Optional. Scopes availability checks to a specific event type. Find the ID in the URL when editing an event type on your Cal.com dashboard.+CALCOM_EVENT_TYPE_ID=diff --git a/ai_agents/cal_scheduling_agent/README.md b/ai_agents/cal_scheduling_agent/README.mdindex c52fdaa..8810e99 100644--- a/ai_agents/cal_scheduling_agent/README.md+++ b/ai_agents/cal_scheduling_agent/README.md@@ -1,6 +1,6 @@# Cal Scheduling Agent-> A conversational scheduling assistant that manages Cal.com appointments through natural language — check availability, book, reschedule, and cancel, with automatic timezone handling. Powered by Gemini 3 Flash and Streamlit.+> A conversational scheduling assistant that manages Cal.com appointments through natural language. Check availability, book, reschedule, and cancel with automatic timezone handling. Powered by Gemini 3 Flash and Streamlit.## Demo@@ -8,7 +8,7 @@## Overview-Instead of logging into Cal.com and manually navigating availability calendars, this agent lets you ask in plain English — "what slots are free next week?", "book a meeting with Sarah for Tuesday at 3pm GMT", "cancel my appointment on Friday" — and handles everything through a conversational interface.+Instead of logging into Cal.com and manually navigating availability calendars, this agent lets you ask in plain English: "what slots are free next week?", "book a meeting with Sarah for Tuesday at 3pm GMT", "cancel my appointment on Friday". It handles everything through a conversational interface.The agent connects to the [Cal.com REST API](https://cal.com/docs/api-reference) to read availability, create bookings, and manage existing appointments in real time.@@ -33,7 +33,8 @@ The agent connects to the [Cal.com REST API](https://cal.com/docs/api-reference)## Prerequisites- Python 3.10 or later-- A Google API key — get one free at [aistudio.google.com](https://aistudio.google.com)+- [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python package manager)+- A Google API key. Get one free at [aistudio.google.com](https://aistudio.google.com)- A Cal.com account with API access- A Cal.com Event Type ID@@ -54,6 +55,12 @@ cp .env.example .envOpen `.env` and add your credentials.+**Install dependencies**++```bash+uv sync+```+## Usage```bash@@ -81,7 +88,7 @@ What's open next Monday morning?|---|---|| Google API Key | [aistudio.google.com](https://aistudio.google.com) || Cal.com API Key | [cal.com/settings/developer/api-keys](https://app.cal.com/settings/developer/api-keys) |-| Event Type ID | Your Cal.com dashboard — visible in the URL when editing an event type |+| Event Type ID | Your Cal.com dashboard (visible in the URL when editing an event type) |## Environment Variablesdiff --git a/ai_agents/cal_scheduling_agent/app.py b/ai_agents/cal_scheduling_agent/app.pyindex 6f11866..8d9c26e 100644--- a/ai_agents/cal_scheduling_agent/app.py+++ b/ai_agents/cal_scheduling_agent/app.py@@ -1,5 +1,5 @@"""-Cal Scheduling Agent — Streamlit UI+Cal Scheduling Agent: Streamlit UI for managing Cal.com appointments through natural language."""import os@@ -30,6 +30,7 @@ EXAMPLE_QUERIES = [def build_instructions(timezone: str = "UTC") -> str:+ """Return the system instruction string for the agent, injecting today's date and the user's timezone."""today = datetime.now().strftime("%A, %B %d, %Y")return f"""\You are a friendly and efficient calendar scheduling assistant with access to \diff --git a/ai_agents/cal_scheduling_agent/cal_scheduling_agent/agent.py b/ai_agents/cal_scheduling_agent/cal_scheduling_agent/agent.pyindex 3a4ed33..ae08e11 100644--- a/ai_agents/cal_scheduling_agent/cal_scheduling_agent/agent.py+++ b/ai_agents/cal_scheduling_agent/cal_scheduling_agent/agent.py@@ -1,5 +1,5 @@"""-Cal Scheduling Agent — Agno agent definition.+Cal Scheduling Agent: Agno agent definition for managing Cal.com appointments."""import os