Skip to content

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.example
index 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.com
GOOGLE_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-keys
CALCOM_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.md
index 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 .env
Open `.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 Variables
diff --git a/ai_agents/cal_scheduling_agent/app.py b/ai_agents/cal_scheduling_agent/app.py
index 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.py
index 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