Crypto Labeler is an automated AI-driven labeler and moderator designed to safeguard the BlueSky community. It detects and combats crypto spammers, scammers, phishing attempts, and other malicious activities, ensuring a safer and more transparent environment for users.

This bot leverages ATProto and the Ozone server protocol to identify and label harmful behavior. It utilizes advanced AI capabilities to detect spam, scams, bots, and phishing accounts, streamlining moderation efforts on the BlueSky platform.

To run Crypto Labeler, ensure you have the following installed:

• Node.js (version 20 or higher)
• Yarn (version 1.22.22 or higher)
• OpenAI you need an account and API key to use the OPEN AI API. (gpt-4o-mini)
• Ozone Labeler (registered with moderator permissions on the BlueSky network; see Ozone for details)

1. Clone the repository:

   git clone https://github.com/<your-repo-url>

2. Navigate to the project directory:

   cd crypto-labeler

3. Install dependencies using Yarn:

   yarn install

To start the bot, run:

yarn start

This command initiates the bot, resuming a previous session if available or logging in as a new session.

The bot uses environment variables for authentication and configuration. Set these variables in a .env file located in the root directory of the project. Use the sample file as a template:

cp .env-sample .env

Adjust the values in .env as needed.

• Add Scam Terms to the scamTerms array in lists/scam_terms.js.
• Add Ignored handles to the handleIgnore array in lists/handle_ignore_array.js.

The bot uses an SQLite database to manage automatically ignored handles and their expiration times. The database file is located at ./ignoreHandles.db.

The ignore_handles table consists of the following columns:

• handle: The handle to be ignored (primary key)
• expiration_time: The expiration timestamp in milliseconds

Contributions are highly encouraged! If you wish to contribute:

1. Fork the repository.
2. Create a feature branch.
3. Submit a pull request with your changes.

Your support helps improve Crypto Labeler and its impact on the BlueSky community.

This project is licensed under the MIT License. See the LICENSE.txt file for full details.

If you found this project helpful, please consider supporting it:

Buy me a coffee

Or drop me a tip through Lightning Network: ⚡ getalby.com/p/eddieoz

Your contributions and support are greatly appreciated!