Skip to content

SmartSparkCoding/hackanomoly-bot

This branch is 40 commits ahead of and 22 commits behind hackclub/nephthys:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0d33c93 · · May 2, 2026

History

206 Commits
Oct 20, 2025
Nov 20, 2025
Apr 26, 2026
May 2, 2026
Apr 26, 2026
Apr 30, 2026
Oct 25, 2025
Feb 10, 2026
Nov 29, 2025
May 30, 2025
May 30, 2025
Apr 30, 2026
May 30, 2025
Apr 26, 2026
Apr 10, 2026
Apr 10, 2026
Apr 26, 2026
Feb 16, 2026
Feb 20, 2026

Repository files navigation

Hackanomoly

Hackanomoly is the Slack support bot used for Hack Club help workflows, with ticket routing, helper tooling, App Home dashboards, and automation.

What It Does

Ticket Lifecycle

  • Creates a backend ticket whenever a new help message is posted.
  • Posts a user-facing thread reply with a resolve button.
  • Generates short ticket titles.
  • Suggests and applies team tags for routing.
  • Assigns tickets to helpers when helpers reply in-thread.

Duplicate Guard

  • Prevents repeat tickets from the same user within a short window.
  • Uses relatedness checks to decide whether to close the newer ticket as a duplicate.
  • Posts a summary and link to the original ticket when a duplicate is closed.

App Home

  • Dashboard
  • Guide
  • User Profiles
  • Assigned Tickets
  • Team Tags
  • DM User (maintainer-only)
  • My Stats

Macros

Helper macros available in help threads:

  • ?resolve and aliases like ?close
  • ?reopen and aliases like ?open, ?unresolve
  • ?ai and aliases like ?ask-ai
  • ?faq
  • ?identity
  • ?fraud
  • ?shipcertqueue and related aliases
  • ?thread
  • ?redirect and aliases like ?admin

Scheduled Jobs

  • Daily stats summary post.
  • Fulfillment reminder post.
  • Stale-ticket monitor.

Scripts

Dummy data generator for performance testing:

uv run nephthys/scripts/add_dummy_data.py num_records>gt;

License

MIT

About

Support bot for Slack

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors

No contributors

Languages

  • Python 97.3%
  • Shell 2.5%
  • Dockerfile 0.2%