https://github.com/manojkp08/subredditorx
The Reddit Automation Bot is a Python-based application designed to streamline interactions with Reddit through automation.
https://github.com/manojkp08/subredditorx
api appium automation chromedriver python selenium
Last synced: about 1 month ago
JSON representation
The Reddit Automation Bot is a Python-based application designed to streamline interactions with Reddit through automation.
- Host: GitHub
- URL: https://github.com/manojkp08/subredditorx
- Owner: manojkp08
- Created: 2025-01-14T07:06:32.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-18T12:56:05.000Z (over 1 year ago)
- Last Synced: 2025-02-18T13:41:29.721Z (over 1 year ago)
- Topics: api, appium, automation, chromedriver, python, selenium
- Language: Python
- Homepage:
- Size: 158 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🤖 SubRedditorX
🚀 AI-Powered Reddit Automation
A robust automated Reddit bot built with Python that can post, upvote, and comment on any subreddit through a single GenAI prompt interface without manual Reddit navigation.
---
## ✨ Features
- 🧠 **AI-Powered Interaction**: Use Gemini AI to generate and process Reddit interactions
- 🔄 **Multiple Actions**: Post new content, upvote posts, and comment on threads
- 🖥️ **Simple Interface**: Streamlit web interface for easy interaction
- 📊 **Activity Tracking**: MongoDB integration for comprehensive activity logging
- 🌐 **Automated Browser Control**: Selenium for headless Reddit interaction
## 🛠️ Tech Stack
- 🐍 Python
- 📊 Streamlit (UI)
- 🧠 Gemini API (AI capabilities)
- 🔍 Selenium (browser automation)
- 🗄️ MongoDB (activity logging)
## 📥 Installation
```bash
# Clone the repository
git clone https://github.com/manojkp08/SubRedditorX.git
cd SubRedditorX
# Install dependencies
pip install -r requirements.txt
# Set up environment variables
cp .env.example .env
# Edit .env with your API keys and credentials
```
## ⚙️ Configuration
Before running the bot, update the following in your `.env` file:
```
GEMINI_API_KEY=your_gemini_api_key
REDDIT_USERNAME=your_reddit_username
REDDIT_PASSWORD=your_reddit_password
REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret
MONGODB_URI=your_mongodb_connection_string
```
## 🚀 Usage
```bash
# Start the Streamlit interface
streamlit run app/streamlit_app.py
```
## 📸 Screenshots
Create a post manually !!
Create a post using GenAI !!
Generate a comment !!
Example Usage on Reddit's website !!
## 📝 Interface Guide
1. 🎯 **Select Action**: Choose to post, comment, or upvote
2. 🔍 **Target Selection**: Enter subreddit name or post URL
3. 💬 **AI Prompt**: Enter your natural language prompt for the AI to process
4. ▶️ **Execute**: Bot will perform the requested action on Reddit
5. 📋 **View Logs**: Check the history of all bot actions
## 📁 Project Structure
```
SUBREDDITORX/
├── .vscode/
├── app/
│ ├── **pycache**/
│ ├── bot/
│ ├── db/
│ ├── config.py
│ ├── gemini_api.py
│ ├── reddit-logo.png
│ ├── streamlit_app.py
│ ├── test.py
│ └── utils.py
├── ui_automation/ (under development phase)
├── .env (you have to add your own)
├── .gitignore
├── docker-compose.yml
├── Dockerfile
├── README.md
└── requirements.txt
```
## ⚠️ Limitations
- ⏱️ Respects Reddit's rate limiting and terms of service
- 🔐 Requires valid Reddit credentials
- 📊 Gemini API usage subject to quota limitations
## 📢 Disclaimer
This tool is intended for legitimate Reddit engagement. Users are responsible for adhering to Reddit's terms of service and content policies.
---