Inspiration
Everyone’s digital life is a mess — folders full of screenshots, duplicate PDFs, and files named “final_final_v3_reallythisone.pdf”. We wanted to build an AI that actually helps people clean up digital clutter instead of adding to it. KeepOrNuke was inspired by that feeling of opening your downloads folder and thinking, “I should really do something about this.”
What it does
KeepOrNuke is an AI-powered decluttering assistant that automatically analyzes your files and decides whether to keep or delete them — with reasoning. Users upload a folder, and the AI reviews filenames, extensions, sizes, and metadata, then gives smart, explainable recommendations like:
“keep: tax_return_2024.pdf — important financial document” “delete: cat_meme_copy(5).png — redundant duplicate”
It’s fast, a little funny, and actually helps you organize your digital workspace.
How we built it
Frontend: React + TypeScript with a clean light theme UI built in Google AI Studio.
Backend / AI logic: Gemini for reasoning about files and generating explanations.
Storage: Mocked file input (no real deletions, safe for demos).
Design: Tailwind CSS for modern, minimalist styling.
Challenges we ran into
Getting consistent reasoning from AI models (“Why delete this meme but not that one?”).
Handling large file lists efficiently within the demo time frame.
Making the UI intuitive yet fun — balancing “productivity” with “personality.”
Ensuring safe mock deletion logic for the hackathon environment.
Accomplishments that we're proud of
Built a fully functional prototype in just a few hours.
Made AI explain its choices — turning a boring utility into a conversational experience.
Clean, light-themed design that feels professional and approachable.
Got people laughing and thinking about digital clutter — a surprisingly relatable problem.
What we learned
How to leverage reasoning models (like Gemini) for decision-making beyond chat.
Prompt engineering for concise, explainable AI outputs.
The importance of UX in trust-based AI tools — users need to understand why AI makes each choice.
Integrating multiple APIs quickly under tight hackathon constraints.
What's next for KeepOrNuke
Real filesystem integration: actually connect to Google Drive or local files safely.
Learning personalization: adapt to your habits (e.g., “always keep photos, delete zips”).
Multi-agent expansion: have specialized agents for documents, media, and codebases.
Log in or sign up for Devpost to join the conversation.