By Anna Susan Cherian & Pavithra Rajan
Welcome! This repository is created as part of ODSC AI Hackathon 2025.
We’ve all been there. Packed with ambition, yet stuck wondering how to plan the day. Parkinson’s Law says that work expands to fill the time we give it. If you give yourself a week to write a paper, it magically takes a week. But shrink that window to just two days? Suddenly, you get it done in two.
Even high-performers like Elon Musk use this to their advantage, setting ultra-tight deadlines to rocket their progress forward.
But let’s be honest, manually planning your calendar can eat up 30 precious minutes every morning. That’s where Zone steps in.
With Zone, you simply type your to-dos in natural language, add constraints if needed, and let the magic happen. Zone reads your Google Calendar, understands your existing events, intelligently estimates how long your tasks should take, and auto-creates optimized time blocks around your schedule.
That’s 28 minutes saved, ready to spend on actually doing the work or, you know, grabbing a coffee.
- All code in
src/runs without errors -
ARCHITECTURE.mdcontains a clear diagram sketch and explanation -
EXPLANATION.mdcovers planning, tool use, memory, and limitations -
DEMO.mdlinks to a 3–5 min video with timestamped highlights
- Clone the repository
- Start the frontend:
cd src/frontend
npm i
npm run dev
- Start the backend FastAPI server
# create a virtual environment
python3 -m venv venv
# install the python packages
pip install -r requirements.txt
# start the server
python -m uvicorn executor:app --reload --port 8000
tree -I "node_modules|__pycache__|venv"
.
├── ARCHITECTURE.md
├── DEMO.md
├── EXPLANATION.md
├── images
│ └── folder-githb.png
├── LICENSE
├── logs
├── README.md
└── src
├── client_secret_588465002822-qd2mph5ci7utptfs4073p9vc0sldihqm.apps.googleusercontent.com.json
├── executor.log
├── executor.py
├── frontend
│ ├── bun.lockb
│ ├── components.json
│ ├── eslint.config.js
│ ├── index.html
│ ├── package.json
│ ├── package-lock.json
│ ├── postcss.config.js
│ ├── public
│ │ ├── favicon.ico
│ │ ├── placeholder.svg
│ │ └── robots.txt
│ ├── README.md
│ ├── src
│ │ ├── App.css
│ │ ├── App.tsx
│ │ ├── components
│ │ │ ├── chronos
│ │ │ │ ├── ActionBar.tsx
│ │ │ │ ├── AgentStatus.tsx
│ │ │ │ ├── BrainDumpInput.tsx
│ │ │ │ ├── Header.tsx
│ │ │ │ ├── TaskCard.tsx
│ │ │ │ ├── TaskList.tsx
│ │ │ │ └── Timeline.tsx
│ │ │ ├── NavLink.tsx
│ │ │ └── ui
│ │ │ ├── accordion.tsx
│ │ │ ├── alert-dialog.tsx
│ │ │ ├── alert.tsx
│ │ │ ├── aspect-ratio.tsx
│ │ │ ├── avatar.tsx
│ │ │ ├── badge.tsx
│ │ │ ├── breadcrumb.tsx
│ │ │ ├── button.tsx
│ │ │ ├── calendar.tsx
│ │ │ ├── card.tsx
│ │ │ ├── carousel.tsx
│ │ │ ├── chart.tsx
│ │ │ ├── checkbox.tsx
│ │ │ ├── collapsible.tsx
│ │ │ ├── command.tsx
│ │ │ ├── context-menu.tsx
│ │ │ ├── dialog.tsx
│ │ │ ├── drawer.tsx
│ │ │ ├── dropdown-menu.tsx
│ │ │ ├── form.tsx
│ │ │ ├── hover-card.tsx
│ │ │ ├── input-otp.tsx
│ │ │ ├── input.tsx
│ │ │ ├── label.tsx
│ │ │ ├── menubar.tsx
│ │ │ ├── navigation-menu.tsx
│ │ │ ├── pagination.tsx
│ │ │ ├── popover.tsx
│ │ │ ├── progress.tsx
│ │ │ ├── radio-group.tsx
│ │ │ ├── resizable.tsx
│ │ │ ├── scroll-area.tsx
│ │ │ ├── select.tsx
│ │ │ ├── separator.tsx
│ │ │ ├── sheet.tsx
│ │ │ ├── sidebar.tsx
│ │ │ ├── skeleton.tsx
│ │ │ ├── slider.tsx
│ │ │ ├── sonner.tsx
│ │ │ ├── switch.tsx
│ │ │ ├── table.tsx
│ │ │ ├── tabs.tsx
│ │ │ ├── textarea.tsx
│ │ │ ├── toaster.tsx
│ │ │ ├── toast.tsx
│ │ │ ├── toggle-group.tsx
│ │ │ ├── toggle.tsx
│ │ │ ├── tooltip.tsx
│ │ │ └── use-toast.ts
│ │ ├── hooks
│ │ │ ├── use-mobile.tsx
│ │ │ └── use-toast.ts
│ │ ├── index.css
│ │ ├── lib
│ │ │ └── utils.ts
│ │ ├── main.tsx
│ │ ├── pages
│ │ │ ├── Index.tsx
│ │ │ └── NotFound.tsx
│ │ └── vite-env.d.ts
│ ├── tailwind.config.ts
│ ├── tsconfig.app.json
│ ├── tsconfig.json
│ ├── tsconfig.node.json
│ └── vite.config.ts
├── google_calendar_api.py
├── llm.py
├── memories.jsonl
├── memory.py
├── planner.py
├── requirements.txt
└── token.json
-
Technical Excellence
This criterion evaluates the robustness, functionality, and overall quality of the technical implementation. Judges will assess the code's efficiency, the absence of critical bugs, and the successful execution of the project's core features. -
Solution Architecture & Documentation
This focuses on the clarity, maintainability, and thoughtful design of the project's architecture. This includes assessing the organization and readability of the codebase, as well as the comprehensiveness and conciseness of documentation (e.g., GitHub README, inline comments) that enables others to understand and potentially reproduce or extend the solution. -
Innovative Gemini Integration
This criterion specifically assesses how effectively and creatively the Google Gemini API has been incorporated into the solution. Judges will look for novel applications, efficient use of Gemini's capabilities, and the impact it has on the project's functionality or user experience. You are welcome to use additional Google products. -
Societal Impact & Novelty
This evaluates the project's potential to address a meaningful problem, contribute positively to society, or offer a genuinely innovative and unique solution. Judges will consider the originality of the idea, its potential real‑world applicability, and its ability to solve a challenge in a new or impactful way.