Skip to content

Junronggg/WithoutBattery

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ WithoutBattery

WithoutBattery is a playful, AI-powered productivity and learning tool designed to help students:

  • ask better questions
  • stay focused while working
  • and build healthy study habits — the fun (and slightly chaotic) way.

Think of it as an educational assistant that refuses to tolerate bad questions and procrastination.


🎯 Why WithoutBattery?

Students today have access to powerful AI tools — but:

  • they often ask vague or poorly-structured questions
  • they get distracted easily
  • they rely on motivation instead of discipline

WithoutBattery solves this by combining AI guidance, focus detection, and gamified pressure.

No motivation?
No problem.
We don’t need batteries.


🏁 Getting Started

  1. Open the web app: https://web-production-94b6.up.railway.app/
  2. Allow webcam access
  3. Start studying
  4. Ask better questions
  5. Try not to blink 😄
  6. Change the theme by clicking "DARK" or "LIGHT"; try out the hidden crazy mode by clicking on the monster button

🚀 Core Features

1️⃣ Ask-Correct-Question AI (Prompt Coach)

  • Connected to the OpenAI API
  • When a student asks a question:
    • Good question (specific, targeted) → AI answers normally
    • Bad question (vague, lazy, unclear) →
      AI refuses to answer directly and instead:
      • explains why the question is weak
      • guides the user to improve it
      • teaches prompt engineering implicitly

🎓 Educational goal:
Help students learn how to think and ask, not just copy answers.


2️⃣ Focus Detection & Study Timer

WithoutBattery detects whether the user is actually working:

  • ⏱️ Tracks active working time
  • 🏆 Displays a leaderboard to encourage consistency
  • 👀 Eye closed
    • alert sound plays
    • photo is taken as a warning
  • 😮 Mouth open
    • interpreted as “awake & active”
    • study timer resumes

🎯 Goal: Encourage alertness and active engagement, not passive screen time.


3️⃣ 😈 Crazy Mode (Annoying Mode)

An optional mode for users who really need discipline.

When enabled:

  • Typing becomes intentionally difficult
  • Random annoying sounds play
  • UI becomes chaotic
  • Chat still works, but patience is tested

To exit:

  • Press ESC 5 times

💡 Design philosophy:
If procrastination is uncomfortable, focus becomes the easier choice.


🎮 Educational + Fun by Design

Aspect How it Helps
AI Prompt Feedback Builds critical thinking
Refusal to answer bad questions Teaches clarity
Leaderboard Encourages consistency
Crazy Mode Creates memorable learning
Alerts & Sounds Interrupts mindless drifting

🛠️ Tech Stack

  • Frontend: HTML / CSS / JavaScript
  • Backend: Flask (Python)
  • AI: OpenAI API
  • Computer Vision: Webcam-based eye & mouth detection
  • Hosting: Railway

🧪 Use Cases

  • Students learning how to use AI effectively
  • Hackathons & demos
  • Study sessions & productivity challenges
  • Teaching prompt engineering informally
  • Fun-but-serious productivity experiments

⚠️ Disclaimer

WithoutBattery is intentionally annoying by design.
All disruptive features are:

  • transparent
  • reversible
  • optional

This project is meant for education, experimentation, and fun.


🧠 Tagline Ideas

Ask better. Focus harder. Escape chaos by working.

An AI that helps you learn — even when you don’t want to.

WithoutBattery: powered by pressure.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 55.8%
  • CSS 37.5%
  • HTML 4.2%
  • Python 1.8%
  • Other 0.7%