LooseCannon 🤖

Automated scambaiting assistant that integrates with messaging platforms to waste scammers' time using local LLMs.

⚠️ Legal Disclaimer

This tool is for educational and defensive security purposes only. Use responsibly and be aware that automation may violate platform Terms of Service. Your account could be banned.

Features

🦊 Firefox browser extension
💬 WhatsApp Web integration (more platforms coming)
🤖 Local LLM support via Ollama
🎭 Multiple scambaiter personalities
🛑 Emergency stop functionality
📊 Conversation logging

Project Structure

LooseCannon/
├── extension/          # Firefox browser extension
│   ├── manifest.json
│   ├── content-scripts/
│   ├── background/
│   └── popup/
├── server/            # Local server for LLM integration
│   ├── src/
│   └── personalities/
└── package.json

Quick Start

Prerequisites

Ollama - Install from https://ollama.ai
Node.js - Version 18+ recommended
Firefox Developer Edition (recommended for extension development)

Installation

Clone the repository:

cd ~/Documents/GithubOrgs/zeroed-some/LooseCannon

Install dependencies:

npm install

Start Ollama with a model:

ollama pull llama2
ollama serve

Start the local server:

npm run dev:server

Load the extension in Firefox:

npm run dev:extension

Or manually:

Open Firefox and navigate to about:debugging
Click "This Firefox"
Click "Load Temporary Add-on"
Select extension/manifest.json

Usage

Navigate to WhatsApp Web (https://web.whatsapp.com)
Click the LooseCannon button in the bottom right
Select a personality from the popup
Toggle "LC: ON" to activate
The bot will automatically respond to incoming messages in the current chat

Development Roadmap

Phase 1: Foundation ✅

Firefox extension skeleton
Basic WhatsApp Web integration

Phase 2: Message Interception (Current)

DOM manipulation for reading messages
Message injection system

Phase 3: LLM Integration

Ollama server connection
Response generation

Phase 4: Scambaiter Logic

Personality system
Conversation strategies

Phase 5: Polish

Chrome support
Additional platforms
Advanced features

Safety Features

Manual activation per chat (no automatic activation)
Visual indicators when active
Emergency stop button
Conversation logging for review
Rate limiting to avoid detection

Contributing

This project is in active development. Issues and PRs welcome!

License

MIT - See LICENSE file for details

Acknowledgments

Inspired by the scambaiting community and projects like Kitboga's work.

	extension
	server
	.env.example
	.gitignore
	README.md
	package.json
	setup.sh