{"id":25631591,"url":"https://github.com/manojkp08/subredditorx","last_synced_at":"2026-05-13T13:47:16.578Z","repository":{"id":272403283,"uuid":"916476514","full_name":"manojkp08/SubRedditorX","owner":"manojkp08","description":"The Reddit Automation Bot is a Python-based application designed to streamline interactions with Reddit through automation. ","archived":false,"fork":false,"pushed_at":"2025-02-18T12:56:05.000Z","size":162,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-18T13:41:29.721Z","etag":null,"topics":["api","appium","automation","chromedriver","python","selenium"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manojkp08.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-14T07:06:32.000Z","updated_at":"2025-02-18T12:56:09.000Z","dependencies_parsed_at":"2025-01-14T08:21:08.519Z","dependency_job_id":"fd49fead-2172-42fc-829a-37be08b1b21d","html_url":"https://github.com/manojkp08/SubRedditorX","commit_stats":null,"previous_names":["manojkp08/reddit_x_bot","manojkp08/reddit_genai_bot","manojkp08/subredditorx"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojkp08%2FSubRedditorX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojkp08%2FSubRedditorX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojkp08%2FSubRedditorX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojkp08%2FSubRedditorX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manojkp08","download_url":"https://codeload.github.com/manojkp08/SubRedditorX/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240234314,"owners_count":19769353,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","appium","automation","chromedriver","python","selenium"],"created_at":"2025-02-22T20:28:44.901Z","updated_at":"2026-05-13T13:47:16.573Z","avatar_url":"https://github.com/manojkp08.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 SubRedditorX\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"app/reddit-logo.png\" alt=\"Reddit Bot Logo\" width=\"200\" /\u003e\r\n  \u003cbr\u003e\r\n  \u003ch3\u003e🚀 AI-Powered Reddit Automation\u003c/h3\u003e\r\n  \u003cp\u003eA 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.\u003c/p\u003e\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\n## ✨ Features\r\n\r\n- 🧠 **AI-Powered Interaction**: Use Gemini AI to generate and process Reddit interactions\r\n- 🔄 **Multiple Actions**: Post new content, upvote posts, and comment on threads\r\n- 🖥️ **Simple Interface**: Streamlit web interface for easy interaction\r\n- 📊 **Activity Tracking**: MongoDB integration for comprehensive activity logging\r\n- 🌐 **Automated Browser Control**: Selenium for headless Reddit interaction\r\n\r\n## 🛠️ Tech Stack\r\n\r\n- 🐍 Python\r\n- 📊 Streamlit (UI)\r\n- 🧠 Gemini API (AI capabilities)\r\n- 🔍 Selenium (browser automation)\r\n- 🗄️ MongoDB (activity logging)\r\n\r\n## 📥 Installation\r\n\r\n```bash\r\n# Clone the repository\r\ngit clone https://github.com/manojkp08/SubRedditorX.git\r\ncd SubRedditorX\r\n\r\n# Install dependencies\r\npip install -r requirements.txt\r\n\r\n# Set up environment variables\r\ncp .env.example .env\r\n# Edit .env with your API keys and credentials\r\n```\r\n\r\n## ⚙️ Configuration\r\n\r\nBefore running the bot, update the following in your `.env` file:\r\n\r\n```\r\nGEMINI_API_KEY=your_gemini_api_key\r\nREDDIT_USERNAME=your_reddit_username\r\nREDDIT_PASSWORD=your_reddit_password\r\nREDDIT_CLIENT_ID=your_reddit_client_id\r\nREDDIT_CLIENT_SECRET=your_reddit_client_secret\r\nMONGODB_URI=your_mongodb_connection_string\r\n```\r\n\r\n## 🚀 Usage\r\n\r\n```bash\r\n# Start the Streamlit interface\r\nstreamlit run app/streamlit_app.py\r\n```\r\n\r\n## 📸 Screenshots\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"https://github.com/user-attachments/assets/17745544-f90f-4ef1-b853-89ca6a74aacc\" width=\"600\" /\u003e\r\n  \u003cp\u003e\u003ci\u003eCreate a post manually !!\u003c/i\u003e\u003c/p\u003e\r\n  \r\n  \u003cimg src=\"https://github.com/user-attachments/assets/28b063b4-0b7d-4b8c-b916-9d900fb27937\" width=\"600\" /\u003e\r\n  \u003cp\u003e\u003ci\u003eCreate a post using GenAI !!\u003c/i\u003e\u003c/p\u003e\r\n  \r\n  \u003cimg src=\"https://github.com/user-attachments/assets/0ae4f902-6c6d-4e1a-aeb8-89ca5aeb2b12\" width=\"600\" /\u003e\r\n  \u003cp\u003e\u003ci\u003eGenerate a comment !!\u003c/i\u003e\u003c/p\u003e\r\n  \r\n  \u003cimg src=\"https://github.com/user-attachments/assets/93812dac-3689-4692-ab66-ff21cd149301\" width=\"600\" /\u003e\r\n  \u003cp\u003e\u003ci\u003eExample Usage on Reddit's website !!\u003c/i\u003e\u003c/p\u003e\r\n\u003c/div\u003e\r\n\r\n## 📝 Interface Guide\r\n\r\n1. 🎯 **Select Action**: Choose to post, comment, or upvote\r\n2. 🔍 **Target Selection**: Enter subreddit name or post URL\r\n3. 💬 **AI Prompt**: Enter your natural language prompt for the AI to process\r\n4. ▶️ **Execute**: Bot will perform the requested action on Reddit\r\n5. 📋 **View Logs**: Check the history of all bot actions\r\n\r\n## 📁 Project Structure\r\n\r\n```\r\nSUBREDDITORX/\r\n├── .vscode/\r\n├── app/\r\n│   ├── **pycache**/\r\n│   ├── bot/\r\n│   ├── db/\r\n│   ├── config.py\r\n│   ├── gemini_api.py\r\n│   ├── reddit-logo.png\r\n│   ├── streamlit_app.py\r\n│   ├── test.py\r\n│   └── utils.py\r\n├── ui_automation/ (under development phase)\r\n├── .env (you have to add your own)\r\n├── .gitignore\r\n├── docker-compose.yml\r\n├── Dockerfile\r\n├── README.md\r\n└── requirements.txt\r\n```\r\n\r\n## ⚠️ Limitations\r\n\r\n- ⏱️ Respects Reddit's rate limiting and terms of service\r\n- 🔐 Requires valid Reddit credentials\r\n- 📊 Gemini API usage subject to quota limitations\r\n\r\n## 📢 Disclaimer\r\n\r\nThis tool is intended for legitimate Reddit engagement. Users are responsible for adhering to Reddit's terms of service and content policies.\r\n\r\n---\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cp\u003e⭐ Star this repository if you find it useful! ⭐\u003c/p\u003e\r\n  \u003cp\u003eMade with ❤️ by \u003ca href=\"https://github.com/manojkp08\"\u003emanojkp08\u003c/a\u003e\u003c/p\u003e\r\n\u003c/div\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanojkp08%2Fsubredditorx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanojkp08%2Fsubredditorx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanojkp08%2Fsubredditorx/lists"}