zeroed-some/loosecannon / ee1a26c

Browse files

sanitize this a bit

Authored by espadonne
SHA
ee1a26cf50bb095ccf2ca89317fa76a89ace2709
Parents
e8b5f80
Tree
853a54d

1 changed file

StatusFile+-
M README.md 92 80
README.mdmodified
@@ -1,124 +1,136 @@
1
-# LooseCannon 🤖
1
+# LooseCannon
22
3
-Automated scambaiting assistant that integrates with messaging platforms to waste scammers' time using local LLMs.
3
+Automated scambaiting for the terminally online. Weaponizes local LLMs against the forces of digital darkness.
44
5
-## ⚠️ Legal Disclaimer
5
+## Legal Notice
66
7
-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.
7
+This tool exists for educational purposes and defensive security research. Using it will probably violate some Terms of Service. Your accounts may get banned. You've been warned.
88
9
-## Features
9
+## What It Does
1010
11
-- 🦊 Firefox browser extension
12
-- 💬 WhatsApp Web integration (more platforms coming)
13
-- 🤖 Local LLM support via Ollama
14
-- 🎭 Multiple scambaiter personalities
15
-- 🛑 Emergency stop functionality
16
-- 📊 Conversation logging
11
+Turns your messaging apps into honeypots for scammers. When they message, an AI responds with maximum confusion and minimal coherence. Think of it as a Turing test in reverse.
1712
18
-## Project Structure
13
+## Current Victims
14
+
15
+- WhatsApp Web (primary target)
16
+- Telegram Web (all variants)
17
+- Facebook Messenger (surprisingly easy)
18
+
19
+## Architecture
1920
2021
 ```
2122
 LooseCannon/
22
-├── extension/          # Firefox browser extension
23
-│   ├── manifest.json
24
-│   ├── content-scripts/
25
-│   ├── background/
26
-│   └── popup/
27
-├── server/            # Local server for LLM integration
28
-│   ├── src/
29
-│   └── personalities/
30
-└── package.json
23
+├── extension/          # Browser hijacking code
24
+├── server/            # LLM wrangling service
25
+└── personalities/     # Digital personas of varying coherence
3126
 ```
3227
33
-## Quick Start
34
-
35
-### Prerequisites
28
+## Prerequisites
3629
37
-1. **Ollama** - Install from https://ollama.ai
38
-2. **Node.js** - Version 18+ recommended
39
-3. **Firefox Developer Edition** (recommended for extension development)
30
+- Ollama (for the AI brain)
31
+- Node.js 18+ (for the plumbing)
32
+- Firefox (Chrome users can wait)
33
+- A healthy disregard for platform guidelines
4034
41
-### Installation
35
+## Installation
4236
43
-1. Clone the repository:
4437
 ```bash
38
+# Get the code
4539
 cd ~/Documents/GithubOrgs/zeroed-some/LooseCannon
46
-```
4740
48
-2. Install dependencies:
49
-```bash
41
+# Install dependencies
5042
 npm install
51
-```
5243
53
-3. Start Ollama with a model:
54
-```bash
44
+# Start the AI
5545
 ollama pull llama2
5646
 ollama serve
57
-```
5847
59
-4. Start the local server:
60
-```bash
61
-npm run dev:server
62
-```
48
+# Run the server
49
+npm start
6350
64
-5. Load the extension in Firefox:
65
-```bash
51
+# Load extension
6652
 npm run dev:extension
6753
 ```
6854
69
-Or manually:
70
-- Open Firefox and navigate to `about:debugging`
71
-- Click "This Firefox"
72
-- Click "Load Temporary Add-on"
73
-- Select `extension/manifest.json`
55
+Or if you prefer the manual approach: `about:debugging` > Load Temporary Add-on > Select manifest.json
7456
75
-## Usage
57
+## Operation
7658
77
-1. Navigate to WhatsApp Web (https://web.whatsapp.com)
78
-2. Click the LooseCannon button in the bottom right
79
-3. Select a personality from the popup
80
-4. Toggle "LC: ON" to activate
81
-5. The bot will automatically respond to incoming messages in the current chat
59
+1. Open your chosen messaging platform
60
+2. Find the LC button (you can't miss it)
61
+3. Pick a personality (Confused Elder is a classic)
62
+4. Toggle to ON
63
+5. Watch the magic unfold
8264
83
-## Development Roadmap
65
+## Available Personalities
8466
85
-### Phase 1: Foundation ✅
86
-- Firefox extension skeleton
87
-- Basic WhatsApp Web integration
67
+- **Confused Elder**: Can't find the any key
68
+- **Tech Support Nightmare**: Knows everything, understands nothing
69
+- **Conspiracy Theorist**: It's all connected, man
8870
89
-### Phase 2: Message Interception (Current)
90
-- DOM manipulation for reading messages
91
-- Message injection system
71
+## Safety Mechanisms
9272
93
-### Phase 3: LLM Integration
94
-- Ollama server connection
95
-- Response generation
73
+- Manual activation only (no rogue AI here)
74
+- Big red emergency stop button
75
+- Conversation logs (for posterity)
76
+- Rate limiting (to maintain plausible humanity)
77
+
78
+## Phases of Development
79
+
80
+**Phase 1**: Basic infrastructure [COMPLETE]
81
+**Phase 2**: Multi-platform chaos [COMPLETE]
82
+**Phase 3**: Chrome support (eventually)
83
+**Phase 4**: World domination (pending)
84
+
85
+## Technical Highlights
86
+
87
+- Real-time scammer detection (70%+ confidence triggers alerts)
88
+- Human-like typing delays (150ms per word, plus random jitter)
89
+- Context-aware response strategies
90
+- Conversation state management
91
+- Platform-agnostic message handling
92
+
93
+## Performance Notes
94
+
95
+- Conversations auto-purge after 24 hours
96
+- Message history capped at 50 (memory is expensive)
97
+- Response queue prevents flooding
98
+- Automatic reconnection on server hiccups
99
+
100
+## Testing Your Setup
101
+
102
+```javascript
103
+// Browser console commands for the curious
104
+
105
+// Check load status
106
+console.log(window.LooseCannonLoaded);
107
+
108
+// Trigger scammer alert
109
+browser.runtime.sendMessage({
110
+  type: 'SCAMMER_DETECTED',
111
+  data: { score: 0.95 }
112
+});
113
+```
96114
97
-### Phase 4: Scambaiter Logic
98
-- Personality system
99
-- Conversation strategies
115
+## Known Issues
100116
101
-### Phase 5: Polish
102
-- Chrome support
103
-- Additional platforms
104
-- Advanced features
117
+- Platform DOM changes will break everything
118
+- Too many responses = rate limiting
119
+- Some assembly required
120
+- Batteries not included
105121
106
-## Safety Features
122
+## Disclaimer
107123
108
-- Manual activation per chat (no automatic activation)
109
-- Visual indicators when active
110
-- Emergency stop button
111
-- Conversation logging for review
112
-- Rate limiting to avoid detection
124
+This software is provided "as is" without warranty of any kind. If you lose your WhatsApp account while trolling Nigerian princes, that's on you. The authors assume no responsibility for banned accounts, angry scammers, or existential crises caused by talking to AI-powered grandparents.
113125
114126
 ## Contributing
115127
116
-This project is in active development. Issues and PRs welcome!
128
+PRs welcome. Breaking changes preferred. Documentation optional.
117129
118130
 ## License
119131
120
-MIT - See LICENSE file for details
132
+MIT - Do whatever you want, just don't blame us.
121133
122
-## Acknowledgments
134
+## Credits
123135
124
-Inspired by the scambaiting community and projects like Kitboga's work.
136
+Standing on the shoulders of giants in the scambaiting community. You know who you are.