Skip to content

indicaindependent/humandefender

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HumanDefender Logo

HumanDefender

5-signal behavioral AI that Ghost Scores every comment — automatically.

Version Platform Hackathon License GitHub

Mods decide. HumanDefender informs.


The Problem

Reddit's mod queues are overwhelmed. Bot networks and coordinated inauthentic behavior (CIB) campaigns operate at machine speed — spinning up accounts, farming karma, and flooding subreddits with astroturfed content before human mods can react.

HumanDefender catches them on the first comment.


How It Works

Every comment triggers an automatic analysis using 5 behavioral signals, producing a Ghost Score (0–100). High-scoring accounts receive automatic mod notes. Ghost-tier accounts (81+) are auto-reported to the mod queue with zero mod intervention.

The 5 Signals

Signal Points What It Catches
🔴 Karma Ratio 25 pts 95%+ comment-only karma — the bot fingerprint
🟠 Velocity Index 20 pts Metronomic posting rhythm — bots don't sleep
🔴 Linguistic Entropy 25 pts Template language & low vocab diversity
🟠 Cross-Sub Scatter 15 pts Carpet-bombing unrelated subs — astroturfing signature
🔴 Reply-Only Flag 15 pts Never starts threads — pure amplification behavior

Ghost Score Verdicts

Score Verdict Automatic Action
0–30 ✅ CLEAN No action
31–60 ⚠️ SUSPICIOUS Logged
61–80 🤖 LIKELY BOT Mod note added
81–100 👻 GHOST Mod note + auto-report to queue

Screenshots

Ghost Score Card Detection Log
Ghost Score card — 89/100, auto-reported Detection log — last flagged accounts
Smoke Tests Stats Dashboard
Smoke test suite — 10/10 passing Stats dashboard — full detection breakdown

Architecture

Reddit Comment
  └─→ Devvit CommentSubmit Trigger
        ├─→ Local signals (Karma Ratio + Velocity + Reply-Only)
        └─→ CF Edge Worker (Linguistic Entropy + Cross-Sub Scatter)
              └─→ Composite Ghost Score
                    ├─→ Mod Note (61+)
                    ├─→ Auto-Report (81+)
                    └─→ Detection Log (all)

Devvit App (TypeScript)

  • CommentSubmit event trigger — zero setup, fires on every comment
  • Redis-backed rolling detection log (500 entries per subreddit)
  • Full structured logging: level, event type, timing, signal breakdown
  • 10-test smoke test suite accessible from the mod menu

Cloudflare Edge Worker (ghosthunter.osintnet.uk)

  • Handles compute-intensive signals: Linguistic Entropy + Cross-Sub Scatter
  • Shannon entropy analysis on token distributions
  • Cross-subreddit burst window detection
  • Sub-100ms global response time with graceful degradation

Mod Tools Menu

Access via the subreddit mod menu:

Menu Item What It Does
🔍 Score this account Manually score any commenter
📋 Detection Log Last 500 flagged accounts
📊 Stats Total / Ghost / Bot / Suspicious / Clean counts
🔴 Error Log Full observability — every event
🧪 Run Smoke Tests 10 automated tests verify the full system

Installation

  1. Go to developers.reddit.com/apps/humandefender
  2. Click Install
  3. Select your subreddit
  4. Done — HumanDefender starts scoring immediately, zero configuration required

Privacy & Safety

  • Only reads publicly available Reddit data
  • Never stores comment content — behavioral analysis only
  • No personal data, no content classification
  • Mods always make the final call — no auto-bans, no auto-removals

Changelog

v0.0.4 — May 9, 2026

  • App icon and portal description added
  • README with full documentation and screenshots

v0.0.3 — May 9, 2026

  • 5-signal Ghost Score engine complete
  • Edge worker (Linguistic Entropy + Cross-Sub Scatter)
  • 10-test smoke suite
  • Stats dashboard + detection log + error log

v0.0.2 — May 9, 2026

  • CommentSubmit trigger live
  • Karma Ratio, Velocity Index, Reply-Only signals
  • Mod note + auto-report at Ghost tier

v0.0.1 — May 9, 2026

  • Initial scaffold

Built By

Indica Independent Media / VPDLNY
Vulnerable Persons Defense League of New York

We build open-source information tools for vulnerable communities and internet safety. All tools are free at point of use.

"Information as the weapon. Knowledge as the shield."

🔗 GitHub | App Portal | r/humandefender_dev

About

Reddit Mod Tool: 5-signal behavioral bot & CIB detector — Ghost Score 0-100 — Devpost Reddit Mod Tools Hackathon 2026

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors