Open source

On GitHub

This website is mirrored in the repo at docs/web/ and deployed via GitHub Pages. Star the repo, grab a release, or run in simulation in under five minutes.

? Star on GitHub Download v1.1.0 ?

Brand vs URL

The site displays as HackerPlanet (logo, titles, copy). The address bar still shows the free GitHub Pages project path until you buy and wire up a custom domain.

Live now: salvador-Data.github.io/cyberThreatGotchi/ · Target later: hackerplanet.dev or www.hackerplanet.com (requires domain purchase + DNS — see hosting guide ?).

Launch site

GitHub Pages (free hosting)

Site files deploy to gh-pages automatically. Enable the public URL once in GitHub Settings under Build and deployment (branch gh-pages, folder / (root)).

“Verify domain names” in Settings?

That block is for a purchased custom domain later (e.g. hackerplanet.dev). It is not required for the free URL and does not mean pages are missing.

Use the live project URL (note /cyberThreatGotchi/ in the path): salvador-Data.github.io/cyberThreatGotchi/. Links like …github.io/services.html (without the project folder) return 404.

Enable Pages (Settings) ? 60-second setup guide ? Verified domains FAQ ?

Releases

Download zips & STLs

Tagged releases bundle source, enclosure STLs, sprite sheets, and cybertech graphics — upload assets ship with each tag. Grab the latest from GitHub Releases ? or clone main for day-to-day dev.

In each release tag

  • marketing-graphics.zip — OG images + social squares
  • sprites.zip — Cipherhorn PNG mood frames
  • enclosure-stl-eink.zip — CypherTek Rache Tamagotchi shell (3 STLs)
  • enclosure-stl-lcd.zip — arcade LCD shell variant (3 STLs)
  • Full Python source · YARA rules · hardware docs · install scripts

What it does when you run it

  • Live Scapy capture or simulation mode (auto on Windows dev)
  • Traffic analyzer + port-scan detection + signature engine
  • ClamAV + YARA + SHA256 deny-list AV scoring pipeline
  • IPS auto-block via iptables on Linux (authorized networks only)
  • Cipherhorn gotchi FSM — moods, hunger, security XP, Feed/Pet
  • Terminal · Rich CLI · Waveshare e-ink · SPI LCD · Flask web UI
  • SQLite threat log + tamper-evident audit chain export
  • CSV / JSON executive report for board, SOC, and IR
  • Outbound webhooks · Pro feed API (signatures, YARA, hashes)
  • YAML config · rate limits · optional API token on mutating routes
  • Docker compose · BPI-R3 install.sh systemd · M5 Cardputer client

Defensive use only — run on networks and systems you own or are authorized to monitor. Full stack docs ? CyberThreatGotchi page · CISO playbook ?

??

Main repository

salvador-Data/cyberThreatGotchi — MIT license, CI green, 42+ tests.
??

Website source

website/ on main · mirrored to docs/web/
?

CI & releases

Automated tests, release zips (STLs, sprites, graphics), Pages deploy.
??

Live site (free)

Enable Pages once ? salvador-Data.github.io/cyberThreatGotchi

Quick clone

git clone https://github.com/salvador-Data/cyberThreatGotchi.git
cd cyberThreatGotchi
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
python main.py --simulation --web

Also on GitHub