- Demo
- Overview
- Features
- Future Roadmap
- Technology Stack
- Getting Started
- Project Structure
- Deployment
- Contributing
- License
- Meet the BrainHack Team
BrainHack is an innovative web app that blends AI and neuroscience to help you:
- 🔍 Understand and predict distraction risk
- 🧭 Track and achieve your goals across multiple time horizons
- 🤖 Chat with an AI-powered coach for productivity & wellness tips
- ⏱️ Run focus sessions with data-driven recommendations
- Interactive Brain Visualization
- Split-brain UI showing logic vs. creativity, with responsive animations.
- Distraction Risk Predictor
- ML model flags high-risk moments using time, stress, notifications & usage data.
- AI Chat Assistant
- Context-aware coach powered by Google’s Gemini AI for productivity & wellness advice.
- Goal Tracking
- Manage Today, 30-Day, 90-Day & 1-Year goals with progress rings & subtasks.
- Focus Timer
- Preset/custom sessions, end-session stats, break suggestions, and distraction-free mode.
- Analytics Dashboard
- Sparklines and mini-charts visualize your focus vs. distraction trends.
| Feature | Vision |
|---|---|
| Distraction Risk Predictor | Next-Step Simulation: RL engine shows “If you skip your break, here’s your 1-hr focus drop” in real time. |
| Personalized Recommendations | Adaptive RL Advisor: Continuously refines tips based on your feedback and predicts long-term habit impact. |
| AI Chat Assistant | Proactive Coach: Auto-pings mini-sessions (“Your focus is slipping—try a 2-min breathing exercise?”). |
| Goal Tracking | Dynamic Micro-Goals: RL-powered bite-sized tasks (e.g., “Read 2 pages now”) and auto-adjust difficulty per performance. |
| Focus Timer | Smart Scheduler: Auto-schedules your next focus block using peak-hour forecasting and calendar context. |
| Analytics Dashboard | Predictive Forecasting: “What-if” scenarios—see how today’s tweaks could boost next week’s total focus time by X%. |
- Node.js v18+
- npm or yarn
- Firebase account
- Google Gemini API key
# Clone repo
git clone https://github.com/Jdsb06/BrainHack.git
cd BrainHack# Install dependencies
npm install# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your Firebase & Gemini keys# Run dev server
npm run devOpen http://localhost:3000 in your browser
brain_hack/
├── public/ # Static assets & images
├── src/
│ ├── app/ # Next.js app router
│ │ ├── api/ # API routes
│ │ ├── ask-ai/ # AI chat page
│ │ ├── login/ # Login page
│ │ ├── register/ # Registration page
│ │ ├── risk-predictor/ # Distraction risk predictor page
│ │ └── ... # Other pages
│ ├── components/ # Reusable UI components
│ ├── lib/ # Firebase, Gemini, and utility setup
│ └── styles/ # Global styles
├── Bot/ # AI Chatbot backend logic (models, routes, handlers)
├── flask_app/ # Flask backend for Distraction Risk Predictor (API + ML inference)
├── BrainHack/ # ML model training code, datasets, notebooks, experiments
├── scripts/ # Utility scripts
├── .env.example # Example environment variables
├── next.config.js # Next.js configuration
├── package.json # Project dependencies
└── README.md # Project documentation
The application is deployed on Firebase Hosting. To deploy:
npm run build
firebase deploy --only hosting- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Google Gemini AI for providing the chat capabilities
- Firebase for authentication and hosting
- The open-source community for the various libraries used in this project
| Feature | Current Implementation | Future Vision |
|---|---|---|
| Distraction Risk Predictor | AI model flags high-risk moments based on time, stress, notifications, and usage patterns | Next-Step Simulation: a reinforcement-learning engine that shows you “if you skip your break, here’s the 1-hr focus drop” in real time |
| Personalized Recommendations | Static suggestions for breaks, content swaps, and focus tweaks based on past behavior | Adaptive RL Advisor: learns from your feedback to refine advice continuously, even predicting long-term habit impact (“Your focus streak will improve by 12% if you follow this…”) |
| AI Chat Assistant | Context-aware chat powered by Gemini AI offering tips on productivity and wellness | Proactive Coach: autonomously pings you with mini-sessions (“Hey, I noticed your focus is slipping—want a 2-min breathing exercise?”) |
| Goal Tracking | Track daily, 30-day, 90-day, and annual goals with progress rings and subtasks | Dynamic Micro-Goals: auto-generate bite-sized habits (e.g., “Read 2 pages now”) and adjust goal difficulty using RL based on your performance curve |
| Focus Timer | Preset/custom timers + end-session stats and break prompts | Smart Scheduler: the app auto-schedules your next focus block by forecasting your peak hours from past data and calendar context |
| Analytics Dashboard | Visualize trends with sparklines and pie/circular charts | Predictive Forecasting: run “what-if” scenarios—see how today’s schedule tweaks could boost next week’s total focus time by X% |