Suspy is a bot for discord (and telegram soon), to help automatically scan and moderate suspicious link (like scam/phish/etc.) sent on your server, with the help of AI powered scan tool.

It can scan messages containing links sent in the server, evaluate how safe they are, and automatically moderate the message by deleting it and notifying an admin. It can also analyze new, unknown links using an AI-powered tool to detect threats in real time (using Gemini).

Invite the bot to your server and run /setup after invite, or add to your user apps (my apps) and use /check:

((https://discord.com/oauth2/authorize?client_id=1392111150807912488)

Just follow this instruction to self host this project yourself, or use this button for one click deploy to railway (hosting service). If you're a Hack Club Nest member and want to set up this bot on your nest, be sure to also follow this tutorial.

• Create a Discord bot in Developer portal
• Generate Gemini api key from Google AI studio
• Spin up postgres database (You can use Neon service, Hackclub Public Postgres (if you're a nest member), or self-host your own postgres for this.)
• Installed bun for runtime and package manager.

1. Clone/download this repository (look for button "Code" on top of this repo page or run this if you have git installed.)

git clone https://github.com/realzzysan/suspy.git

2. Add environment variables
   You can also use .env file on your local project. Look on file .env.example for instruction on what to set.

DATABASE_URL="..."

GEMINI_API_KEY="..."
....

3. Set up project using bun
   This command will install dependencies, and setup database migration. (postinstall))

# Make sure to complete step 2 first before running this.
bun installl

4. 🎉 Run the bot (yay!)

bun start

Contributions are welcome!
Feel free to open issues or pull requests to add features, fix bugs, or improve the project!!

• Gemini - AI Provider for this project
• Drizzle - Database ORM
• Bun - JavaScript Runtime