Repository navigation
👻 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
- Download the Blinky folder to your computer
- Extract all files to a location like
Documents/Blinky/ - 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.pyMac/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
🌐 Step 3: Install Browser Extension
- Open Chrome and go to
chrome://extensions/ - Enable Developer Mode (toggle in top-right corner)
- Click "Load unpacked"
- Select the
Blinky/extensionfolder - ✅ Success: Blinky icon appears in your extensions bar
👨👩👧👦 Step 4: Parent/Guardian Setup
- Automatic Setup: Blinky will open a setup page automatically
- Enter Information:
- Parent/Guardian name
- Email address
- Phone number
- Child's name
- Click "Complete Blinky Setup"
- ✅ Done: Setup page will confirm completion
🧪 Step 5: Test Installation
Test 1: Basic Functionality
- Go to any website (like Facebook, Instagram, Discord)
- Type a test message: "you're stupid"
- ✅ Expected: Text should be highlighted in orange/red
Test 2: AI Chat
- Click the "Chat with Blinky" button in the sidebar
- Ask: "Someone is being mean to me"
- ✅ Expected: Blinky responds with helpful advice
Test 3: Context Menu
- Select any text on a webpage
- Right-click → "Ask Blinky to check this text"
- ✅ 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:
- Open Command Prompt/Terminal
- Navigate to
Blinky/backend/ - Run
python server.py(Windows) orpython3 server.py(Mac/Linux)
❌ Extension not loading
Problem: Developer mode not enabled
Solution:
- Go to
chrome://extensions/ - Enable "Developer mode" toggle
- Reload the extension
❌ Setup page not opening
Problem: Extension needs refresh
Solution:
- Go to
chrome://extensions/ - Find Blinky extension
- 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!