{"id":28400266,"url":"https://github.com/im3an/socialchatbot","last_synced_at":"2025-06-28T09:32:07.685Z","repository":{"id":295802255,"uuid":"991281047","full_name":"im3an/SocialChatBot","owner":"im3an","description":"Welcome to SocialChatBot, your multi-platform, personality-driven chatbot for Instagram and Snapchat. SocialChatBot isn’t just another bot—she’s a fictional 22-year-old art history student in Berlin, with a sharp wit, a unique style, and a memory for your conversations. She’s designed to make every chat feel real.","archived":false,"fork":false,"pushed_at":"2025-05-27T12:01:04.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-08T09:49:19.374Z","etag":null,"topics":["ai","aichatbot","chatbot","instagram","instagram-api","instagram-automation","instagram-bot","python","pythonapi","pythonchatbot","snapchat-hacker","socialmedia"],"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/im3an.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,"zenodo":null}},"created_at":"2025-05-27T11:50:35.000Z","updated_at":"2025-05-27T12:05:53.000Z","dependencies_parsed_at":"2025-05-27T12:45:56.044Z","dependency_job_id":"5c9f5227-7308-4b05-9978-cf83163488a1","html_url":"https://github.com/im3an/SocialChatBot","commit_stats":null,"previous_names":["im3an/socialchatbot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/im3an/SocialChatBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/im3an%2FSocialChatBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/im3an%2FSocialChatBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/im3an%2FSocialChatBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/im3an%2FSocialChatBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/im3an","download_url":"https://codeload.github.com/im3an/SocialChatBot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/im3an%2FSocialChatBot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262406209,"owners_count":23306104,"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":["ai","aichatbot","chatbot","instagram","instagram-api","instagram-automation","instagram-bot","python","pythonapi","pythonchatbot","snapchat-hacker","socialmedia"],"created_at":"2025-06-01T09:38:31.500Z","updated_at":"2025-06-28T09:32:07.678Z","avatar_url":"https://github.com/im3an.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Riley: The Instagram \u0026 Snapchat Chatbot\n\nWelcome to **Riley**, your multi-platform, personality-driven chatbot for Instagram and Snapchat. Riley isn’t just another bot—she’s a fictional 22-year-old art history student in Berlin, with a sharp wit, a unique style, and a memory for your conversations. She’s designed to make every chat feel real, engaging, and just a little bit mysterious.\n\n\n## 🚀 Features\n\n- **Multi-Platform:** Seamlessly connects to both Instagram and Snapchat.\n- **Personality Engine:** Riley’s responses are shaped by a detailed, editable [personality profile](data/personality.txt).\n- **Conversational Memory:** Remembers past chats and references them for continuity.\n- **Modern Slang:** Uses Gen-Z slang naturally (but sparingly) for authenticity.\n- **AI-Powered:** Leverages Google Gemini for intelligent, context-aware replies.\n- **Proxy Support:** Robust proxy management for reliable Instagram connectivity.\n- **Safety First:** Strict controls to prevent inappropriate or unsafe interactions.\n\n\n## 🗂️ Project Structure\n\n```\ninstagram-chatbot/\n├── src/\n│   ├── main.py                  # Main entry point (CLI)\n│   ├── chatbot/\n│   │   ├── chatbot.py           # Riley's core logic\n│   │   ├── gemini_client.py     # Gemini API integration\n│   │   ├── nlp_model.py         # (Optional) Local NLP model\n│   │   └── personality.py       # Personality trait loader\n│   ├── instagram_api/\n│   │   ├── instagram_client.py  # Instagram automation\n│   │   ├── proxy_manager.py     # Proxy rotation\n│   │   └── proxy_scraper.py     # Proxy scraping\n│   └── snapchat_api/\n│       └── snapchat_client.py   # Snapchat automation\n├── data/\n│   └── personality.txt          # Riley's personality definition\n├── tests/\n│   └── test_local.py            # Local chatbot tests\n├── .env.example                 # Example environment config\n├── requirements.txt             # Python dependencies\n└── README.md                    # This file\n```\n\n\n## 🛠️ Setup \u0026 Installation\n\n1. **Clone the repository**\n   ```sh\n   git clone https://github.com/im3an/SocialChatBot.git\n   cd instagram-chatbot\n   ```\n\n2. **Install dependencies**\n   ```sh\n   pip install -r requirements.txt\n   ```\n\n3. **Configure environment variables**\n   - Copy `.env.example` to `.env` and fill in your credentials:\n     - Instagram \u0026 Snapchat usernames/passwords\n     - Gemini API key\n     - Path to `personality.txt` (default: `data/personality.txt`)\n\n4. **(Optional) Edit Riley’s personality**\n   - Tweak [data/personality.txt](data/personality.txt) to change Riley’s style, memory, or slang.\n\n\n## 💬 Usage\n\n### Start the Chatbot\n\n```sh\npython src/main.py\n```\n\n- **Choose your platform:** Instagram, Snapchat, or both.\n- **Interact:** Riley will respond to DMs on the selected platforms, using her unique personality.\n\n### Local Testing\n\nFor local, terminal-based chat with Riley:\n\n```sh\npython chat_local.py\n```\n\n## ✨ Customization\n\n- **Personality:** Edit [data/personality.txt](data/personality.txt) to shape Riley’s character, memory, and slang.\n- **Slang \u0026 Style:** Add or remove slang terms, tweak her background, or adjust her communication style.\n- **Safety:** Riley will never initiate conversations or respond after receiving \"STOP TEXTING ME\".\n\n## 🧪 Testing\n\nRun the included test script to simulate conversations and verify Riley’s responses:\n\n```sh\npython -m tests.test_local\n```\n\n## 🛡️ Safety \u0026 Ethics\n\n- Riley will **never** engage in illegal, unethical, or harmful conversations.\n- All responses are filtered for safety and appropriateness.\n\n## 📄 License\n\nMIT License. See [LICENSE](LICENSE) for details.\n\n---\n\n## 🙏 Credits\n\n- [Google Gemini](https://ai.google.dev/) for AI-powered conversations\n- [instagrapi](https://github.com/adw0rd/instagrapi) for Instagram automation\n- [Selenium](https://www.selenium.dev/) for Snapchat automation\n\n\u003e _“Riley is more than code—she’s a vibe.”_","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fim3an%2Fsocialchatbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fim3an%2Fsocialchatbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fim3an%2Fsocialchatbot/lists"}