Reddit-Ribbit-Ribbit 🐸

Welcome to the Reddit-Ribbit-Ribbit repository! This project features a friendly AI Reddit agent that hops into discussions. Powered by Google Gemini, it crafts engaging comments in a style that resonates with Gen Alpha. With features like subreddit monitoring, keyword filtering, image/URL analysis, and a customizable "bot brain," this bot is designed to enhance community engagement on Reddit.

Table of Contents

• Features
• Installation
• Usage
• Configuration
• Contributing
• License
• Contact

Features

• Subreddit Monitoring: Keep an eye on your favorite subreddits and join conversations.
• Keyword Filtering: Customize which topics your bot engages with by filtering keywords.
• Image/URL Analysis: Analyze shared content to make informed comments.
• Customizable Bot Brain: Tailor the bot's personality and style to fit your needs.
• Engaging Comments: Create comments that resonate with younger audiences, using Gen Alpha slang and emojis.

Installation

To get started with Reddit-Ribbit-Ribbit, follow these steps:

1. Clone the Repository:

   git clone https://github.com/aryanmeena6254/Reddit-Ribbit-Ribbit.git

2. Navigate to the Project Directory:

   cd Reddit-Ribbit-Ribbit

3. Install Required Packages: Make sure you have Python installed. You can install the necessary packages using pip:

   pip install -r requirements.txt

4. Download the Latest Release: You can find the latest release here. Download the appropriate file and execute it.

Usage

Once installed, you can start the bot by running the main script:

python main.py

The bot will begin monitoring the specified subreddits and engaging in discussions based on your configuration.

Configuration

To customize the bot's behavior, you will need to edit the config.json file. Here are the key configuration options:

• subreddits: List of subreddits the bot should monitor.
• keywords: Keywords that trigger the bot to engage.
• bot_brain: Define the personality and style of the bot.

Example Configuration

{
  "subreddits": ["learnpython", "Python"],
  "keywords": ["help", "question", "advice"],
  "bot_brain": {
    "style": "friendly",
    "use_emojis": true
  }
}

Contributing

We welcome contributions to Reddit-Ribbit-Ribbit! If you have ideas for features or improvements, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature:

   git checkout -b feature/YourFeatureName

3. Make your changes and commit them:

   git commit -m "Add your feature"

4. Push to your fork:

   git push origin feature/YourFeatureName

5. Create a pull request.

License

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

Contact

For any inquiries, feel free to reach out:

• Author: Aryan Meena
• Email: aryanmeena@example.com
• GitHub: aryanmeena6254

Thank you for checking out Reddit-Ribbit-Ribbit! For the latest updates and releases, visit the Releases section.