- Inspiration (The "Why")
We’ve all been there: a desktop littered with Screenshot_2026_02_15.png, Final_Final_v2.pdf, and random receipts. Manually sorting these is a chore, and most AI tools want to own your data. We wanted to build a "Digital Janitor"—an AI that cleans your room without looking at your secrets. GetZippo was born from the need for a keyboard-driven, privacy-first utility that turns a mess into a structured .zip in seconds.
- What it does
GetZippo is an AI-powered file architect.
Drop & Go: Drag a mess of files into the "Void."
Multimodal Analysis: It uses Gemini 2.0 Flash to "see" images and "read" PDFs.
Semantic Organization: It doesn't just sort by file type; it sorts by context (e.g., "University/SDA/Quizzes" or "Finance/Receipts/Kuwait_Trip").
Smart Renaming: It gives every file a human-readable name based on its actual content.
Instant ZIP: One click (or keystroke) to download your newly structured life.
How we built it
Frontend: A sleek, minimal Next.js application styled with Tailwind CSS.
AI Core: Integrated Gemini 2.0 Flash via OpenRouter for high-speed, multimodal inference.
Processing Pipeline: * Client-Side Pre-processing: We implemented local image compression (max 1024px) and PDF extraction (first 2 pages) to minimize latency and token costs.
The "Architect" Prompt: A complex system prompt that forces the LLM to output a valid JSON directory structure.Deployment: Hosted on Vercel for 100% uptime and fast global delivery.
Challenges we ran into
Context Consistency: Ensuring the AI remembers the folder structure it created for the first 5 files when it processes the next 5. We solved this by using Multimodal Batching.
Latency vs. Accuracy: Balancing the speed of Gemini 2.0 Flash with the need for deep document understanding. We optimized this by using a Hybrid OCR-First approach.
Mouse-less UX: Designing a web interface that feels like a Linux terminal—efficient, fast, and completely controllable via keyboard.
Accomplishments that we're proud of
Privacy by Design: Building a tool that handles sensitive data without a persistent backend database.
The "Magic" Moment: The first time we dropped 20 random files and saw them perfectly categorized into a nested folder structure in under 10 seconds.
Zero Friction: Creating a utility that requires zero signup. You land, you drop, you zip.
What's next for GetZippo
Deep OS Integration: Moving beyond the browser to a CLI tool for power users.
Local LLM Support: Optional integration for running models like Llama 3 locally for 100% offline privacy.
Custom Architectures: Allowing users to provide a "Template" (e.g., "Organize this like a FAST-NUCES semester folder").
Built With
- gemini-api-sdk
- nextjs
- openrouter
- pdfjs
- typescript

Log in or sign up for Devpost to join the conversation.