Skip to content

ardhigagan/KaaryaAI

Repository files navigation

KaaryaAI

AI Chief of Staff

Your inbox knows what you'll miss. Now you do too.

Built with Google AI Studio Powered by Groq Vibe2Ship Hackathon License


What is KaaryaAI?

KaaryaAI (Kaarya = Task/Work in Hindi) is an AI-powered productivity companion that acts as your personal Chief of Staff.

It connects to your Gmail, Google Calendar, and Google Drive — extracts every commitment and deadline, scores each one by risk, and takes autonomous action before you miss anything.

Built for the Vibe2Ship Hackathon 2026 (Coding Ninjas × Google for Developers) Problem Statement: The Last-Minute Life Saver


The Problem

Students, professionals, and entrepreneurs constantly miss deadlines, meetings, and important commitments. Existing productivity tools:

  • Send passive reminders that are easy to ignore
  • Don't connect across Gmail, Calendar, and Drive
  • Tell you what's due — but not whether you'll actually make it
  • Never take autonomous action on your behalf

The gap: No existing tool predicts which deadlines you're going to miss — before you miss them — and then does something about it.


The Solution

KaaryaAI bridges this gap with a multi-agent AI pipeline:

   Gmail + Calendar + Drive
        ↓
   Extraction Agent      →  Finds tasks, deadlines, commitments
        ↓
   Risk Scoring Agent    →  Scores each task 0–100 by urgency
        ↓
   Procrastination Detector → Escalates ignored tasks automatically
        ↓
   Planning Agent        →  Builds daily plan + focus blocks
        ↓
   Action Agent          →  Drafts emails, blocks calendar, sends briefing
        ↓
   Deadline Negotiator   →  Autonomously sends extension requests
        ↓
   Smart Meeting Prep    →  Generates talking points from emails

Features

Core Features

Feature Description
📧 Gmail Extraction Scans unread and important emails, extracts tasks and deadlines automatically
📅 Calendar Sync Reads upcoming events and combines with Gmail data for full picture
AI Risk Scoring Every task gets a 0–100 risk score based on deadline proximity and workload
📋 Daily Briefing AI-generated morning briefing with top priorities and quick wins
🗓 Auto-Scheduler Creates focus time blocks on your Google Calendar automatically
✉️ Smart Email Drafting Context-aware email drafts — follow-ups, extension requests, confirmations
📨 Briefing Email Sends a rich HTML risk report directly to your Gmail inbox

Advanced Agent Features

Feature Description
🤖 Deadline Negotiator Autonomously drafts and sends deadline extension requests for critical tasks — no manual intervention
⚠️ Procrastination Detector Tracks tasks you keep ignoring across sessions and escalates their risk score by +20
🎯 Smart Meeting Prep Before any calendar meeting, scans related emails and generates talking points, questions, and context
📊 Risk Scorer View Visual risk distribution dashboard showing task breakdown by risk level

Risk Scoring Logic

Deadline within 24 hours  →  85–100  (🔴 Critical)
Deadline within 3 days    →  65–85   (🟠 High)
Deadline within 7 days    →  45–65   (🟡 Medium)
Deadline within 14 days   →  25–45   (🟢 Low)
No deadline, action needed →  30–50  (🟡 Medium)

Modifiers:
+10 if competing tasks > 2
+10 if priority is high
-10 if priority is low
+20 if procrastination detected (seen 3+ times)

Tech Stack

Frontend

  • React 19 + TypeScript
  • Tailwind CSS + Framer Motion animations
  • Lucide React icons
  • Vite build tool

Backend

  • Express.js + TypeScript
  • Groq SDK (LLaMA 3.3 70B) with 5-model fallback chain
  • Google APIs — Gmail, Calendar, Drive
  • Google OAuth 2.0 for authentication

Google Technologies

  • Google AI Studio (built and deployed)
  • Gmail API (read + send)
  • Google Calendar API (read + write)
  • Google Drive API (read)
  • Google Cloud Run (deployment)
  • Google OAuth 2.0

Groq Model Fallback Chain

KaaryaAI uses a 5-model fallback to ensure 100% uptime even during rate limits:

llama-3.3-70b-versatile  →  llama-3.1-8b-instant  →  llama-3.2-3b-preview
→  llama-3.2-1b-preview  →  qwen-2.5-coder-32b

Project Structure

KaaryaAI/
├── server.ts              # Express backend + all API endpoints
├── src/
│   ├── App.tsx            # Main React application
│   ├── main.tsx           # React entry point
│   ├── index.css          # Global styles
│   └── components/
│       └── RiskScorerView.tsx  # Risk scorer dashboard component
├── index.html             # HTML entry point
├── package.json           # Dependencies
├── vite.config.ts         # Vite configuration
├── tsconfig.json          # TypeScript configuration
├── .env.example           # Environment variables template
└── .gitignore

API Endpoints

Method Endpoint Description
GET / Health check
GET /auth/login Initiate Google OAuth
GET /auth/callback OAuth callback
GET /auth/status Check auth status
GET /auth/me Get user profile
GET /auth/signout Sign out
GET /extract Scan Gmail + Calendar
GET /risk Score tasks by risk
GET /plan Generate briefing + focus blocks
GET /draft-email/:index Draft email for task
POST /send-reply/:index Send email via Gmail
GET /send-briefing Send HTML briefing to Gmail
GET /autoblock Create Calendar focus blocks
GET /negotiate/:index Autonomously send extension request
GET /meeting-prep/:index Generate meeting prep
GET /events Get calendar events
GET /procrastination Get procrastination report

Setup & Installation

Prerequisites

  • Node.js 18+
  • Google Cloud Project with Gmail, Calendar, Drive APIs enabled
  • Google OAuth 2.0 Web Application credentials
  • Groq API key (free at console.groq.com)

Local Setup

# Clone the repository
git clone https://github.com/ardhigagan/KaaryaAI.git
cd KaaryaAI

# Install dependencies
npm install

# Create environment file
cp .env.example .env

Edit .env with your credentials:

GROQ_API_KEY=your_groq_api_key
APP_URL=http://localhost:3000
CLIENT_ID=your_google_oauth_client_id
CLIENT_SECRET=your_google_oauth_client_secret

Add redirect URI in Google Cloud Console:

http://localhost:3000/auth/callback
# Run development server
npm run dev

Open http://localhost:3000 in your browser.


Hackathon Evaluation Alignment

Criterion Weight How KaaryaAI Addresses It
Problem Solving & Impact 20% Directly solves deadline missing with measurable 0-100 risk scores
Agentic Depth 20% 4 specialized agents + autonomous deadline negotiation without user input
Innovation & Creativity 20% Risk scoring + procrastination detection are genuinely novel
Usage of Google Technologies 15% Gmail, Calendar, Drive, OAuth, Cloud Run, AI Studio
Product Experience & Design 10% Premium dark UI, Google Workspace aesthetic, smooth animations
Technical Implementation 10% Clean TypeScript architecture, 5-model Groq fallback, proper OAuth
Completeness & Usability 5% Fully deployed, end-to-end working application

🚀 Live Demo

Deployed Application: https://kaaryaai-563013532047.us-west1.run.app

Want to try it? KaaryaAI is currently in testing mode and requires Google account authorization. To get access, reach out at agagan2005@gmail.com with your Gmail address and I'll add you as an authorized user within 24 hours.

Demo Video: Watch full demo → (link coming soon)


Author

Ardhi Gagan

GitHub Email


Built with ❤️ using Google AI Studio · Groq LLaMA 3.3 70B · Gmail API · Google Calendar API

About

KaaryaAI is an AI Chief of Staff that scans Gmail, Calendar & Drive — scores every deadline by risk (0-100), detects procrastination, negotiates deadlines autonomously, and preps you for meetings. Built with Groq, Google APIs & React. Vibe2Ship Hackathon 2026.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors