Skip to content

shabnam311/PixelPal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

199 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

👾 PIXELPAL 👾

The Ultimate Cyberpunk Productivity Companion

Python FastAPI Webview Local AI

Your personal Ghibli-inspired digital pet that uses local AI to fix your posture, save your eyes, and crush your distractions.

Download .EXE Release | Features | How it Works


🚀 WHY PIXELPAL?

Most productivity apps just give you a timer. PixelPal gives you a companion.

Built with a dark-neon cyberpunk pixel-art aesthetic, PixelPal watches your physical habits in real-time. If you slouch, look at your phone, or take off your computer glasses, your PixelPal reacts, sweats, and loses health. Keep focused, and you both level up.

🔥 100% OFFLINE. 0% CLOUD STORAGE. CAMERA FOOTAGE IS NEVER SAVED.
Highly memory-efficient and battery-friendly architecture.


🌟 CORE FEATURES

🎮 The Ultimate Retro Interface

  • Dynamic Themes: Switch instantly between Neon Green, Synthwave Purple, Cyberpunk Yellow, and Arcade Red.
  • The PixelPal Pet: A responsive pixel-art companion that breathes, bobs, dances, and panics based on your behavior.
  • Classic HUD: Zelda-style heart containers, chunky JRPG experience bars, and a CRT scanline toggle.
  • Pixel Terminal: A fully functional, color-coded ANSI terminal log that tracks your session milestones in real-time.

🧠 On-Device AI Monitors

No footage saved. No data collected. Processing happens in milliseconds.

Monitor Technology What it Does
👀 Gaze MediaPipe Face Mesh Detects if you're staring off into space.
🧍 Posture MediaPipe Pose Calibrates to your body and warns if you slouch.
👓 Specs LLaVA Vision Model Ensures you wear your blue-light blockers.
📱 Phone LLaVA Vision Model Instantly detects if you pick up your phone.

⚡ Gamified Productivity

  • Pomodoro & Deep Focus: Custom session durations.
  • Level Up!: Hit your goals to trigger confetti celebrations and chiptune level-up sounds.
  • Toast Notifications: Non-intrusive, cyberpunk-styled slide-in alerts.
  • Quiet Mode: Slide-out settings drawer to mute alarms and pause monitors on the fly.

🛠️ INSTALLATION & RUNNING

No command prompt required. No "npm install". Just run the app!

Option 1: The .EXE (Recommended)

  1. Download PixelPal.exe from the latest release.
  2. Double click it. That's it. (No Python required, fully portable).

Option 2: Running from Source

If you want to tweak the neon CSS or add features:

# Clone the repo
git clone https://github.com/shabnam311/PixelPal.git

# Install dependencies (only needed once)
pip install -r requirements.txt

# Run the app
python main.py

🏗️ ARCHITECTURE (For Nerds)

PixelPal is designed to be lightweight and memory-efficient.

  • Backend: FastAPI handles the local WebSocket server and asynchronous AI processing.
  • Frontend: Vanilla HTML/CSS/JS (No heavy React/Electron bloat here!) powered by PyWebView for a native Windows borderless feel.
  • AI Engine: Frames are captured by OpenCV, downscaled for memory efficiency, fed directly into RAM for MediaPipe/Ollama, and immediately discarded.

Stay focused, protect your eyes, and keep your PixelPal happy.
👾 👾 👾

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors