Skip to content

Releases

v1.0.0 Blinky PR

Choose a tag to compare

@elecxDev elecxDev released this 20 Sep 12:14

👻 Blinky Installation Guide

AI-Powered Child Safety Browser Extension

Quick & Easy Setup - 5 Minutes Total


📋 Prerequisites

Before installing Blinky, make sure you have:

  • Chrome Browser (latest version)
  • Python 3.8+ installed on your computer
  • Internet connection for AI models
  • Administrator access to install Python packages

🚀 Step 1: Download Blinky

  1. Download the Blinky folder to your computer
  2. Extract all files to a location like Documents/Blinky/
  3. Remember the folder location - you'll need it later

🔧 Step 2: Setup AI Backend

Windows:

# Open Command Prompt as Administrator
cd path\to\Blinky\backend

# Install required packages
pip install fastapi uvicorn transformers torch pydantic requests python-dotenv

# Start the AI server
python server.py

Mac/Linux:

# Open Terminal
cd path/to/Blinky/backend

# Install required packages
pip3 install fastapi uvicorn transformers torch pydantic requests python-dotenv

# Start the AI server
python3 server.py

✅ Success: You should see "Blinky Child Safety Server starting..." and server running on localhost:5000

⚠️ Keep this window open - the server must run for Blinky to work!


🌐 Step 3: Install Browser Extension

  1. Open Chrome and go to chrome://extensions/
  2. Enable Developer Mode (toggle in top-right corner)
  3. Click "Load unpacked"
  4. Select the Blinky/extension folder
  5. ✅ Success: Blinky icon appears in your extensions bar

👨‍👩‍👧‍👦 Step 4: Parent/Guardian Setup

  1. Automatic Setup: Blinky will open a setup page automatically
  2. Enter Information:
    • Parent/Guardian name
    • Email address
    • Phone number
    • Child's name
  3. Click "Complete Blinky Setup"
  4. ✅ Done: Setup page will confirm completion

🧪 Step 5: Test Installation

Test 1: Basic Functionality

  1. Go to any website (like Facebook, Instagram, Discord)
  2. Type a test message: "you're stupid"
  3. ✅ Expected: Text should be highlighted in orange/red

Test 2: AI Chat

  1. Click the "Chat with Blinky" button in the sidebar
  2. Ask: "Someone is being mean to me"
  3. ✅ Expected: Blinky responds with helpful advice

Test 3: Context Menu

  1. Select any text on a webpage
  2. Right-click → "Ask Blinky to check this text"
  3. ✅ Expected: Blinky analyzes the selected text

🎯 Supported Platforms

Blinky works on all major social media and chat platforms:

  • Discord - Gaming chat protection
  • Instagram - Social media safety
  • Facebook/Messenger - Social networking
  • WhatsApp Web - Messaging safety
  • YouTube - Comment protection
  • TikTok - Social video safety
  • Roblox - Gaming platform safety
  • And many more!

🔧 Troubleshooting

❌ "Blinky is taking a nap" message

Problem: Backend server not running
Solution:

  1. Open Command Prompt/Terminal
  2. Navigate to Blinky/backend/
  3. Run python server.py (Windows) or python3 server.py (Mac/Linux)

❌ Extension not loading

Problem: Developer mode not enabled
Solution:

  1. Go to chrome://extensions/
  2. Enable "Developer mode" toggle
  3. Reload the extension

❌ Setup page not opening

Problem: Extension needs refresh
Solution:

  1. Go to chrome://extensions/
  2. Find Blinky extension
  3. Click the refresh/reload button

❌ Python packages won't install

Problem: Permission issues
Solution:

  • Windows: Run Command Prompt as Administrator
  • Mac/Linux: Use sudo pip3 install ...

🔒 Privacy & Security

  • ✅ Local Processing: All analysis happens on your computer
  • ✅ No Data Collection: Blinky doesn't store or track conversations
  • ✅ Parent Control: Emergency contacts stored locally only
  • ✅ Child Privacy: No browsing history or personal data collected
  • ✅ Secure: Uses industry-standard AI models and encryption

📞 Support & Help

For Technical Issues:

  • Check that Python 3.8+ is installed: python --version
  • Ensure all packages installed correctly
  • Verify Chrome Developer Mode is enabled
  • Raise an issue or raise a ticket on GitHub if any queries
  • Mail me here for any issues at any step.

For Parents:

  • Setup page allows updating contact information anytime
  • Extension can be disabled/enabled in Chrome settings
  • No internet browsing restrictions - purely educational tool

For Kids:

  • Blinky is your friendly safety buddy, not a restriction tool
  • Chat with Blinky anytime for safety advice
  • Extension helps you learn about online safety

🎉 You're All Set!

Blinky is now protecting your child online!