{"id":23428420,"url":"https://github.com/xredax/chatbot-telegram","last_synced_at":"2025-06-20T18:37:48.557Z","repository":{"id":257002592,"uuid":"855407478","full_name":"XredaX/chatbot-telegram","owner":"XredaX","description":"A Telegram Chatbot powered by Google Gemini AI to deliver smart, conversational responses. With seamless integration, users can interact with AI directly through Telegram to get answers, engage in discussions, and access information across a variety of topics","archived":false,"fork":false,"pushed_at":"2024-09-13T17:58:08.000Z","size":8,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T13:18:59.208Z","etag":null,"topics":["api","chatbot","gemini","python"],"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/XredaX.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":"2024-09-10T20:19:18.000Z","updated_at":"2024-10-15T10:37:44.000Z","dependencies_parsed_at":"2024-09-14T09:02:46.346Z","dependency_job_id":"cb1cf6eb-584a-4692-a119-2bda192ca1ae","html_url":"https://github.com/XredaX/chatbot-telegram","commit_stats":null,"previous_names":["xredax/chatbot-telegram"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/XredaX/chatbot-telegram","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XredaX%2Fchatbot-telegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XredaX%2Fchatbot-telegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XredaX%2Fchatbot-telegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XredaX%2Fchatbot-telegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/XredaX","download_url":"https://codeload.github.com/XredaX/chatbot-telegram/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XredaX%2Fchatbot-telegram/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260998701,"owners_count":23095164,"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","chatbot","gemini","python"],"created_at":"2024-12-23T07:12:28.877Z","updated_at":"2025-06-20T18:37:43.527Z","avatar_url":"https://github.com/XredaX.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Gemini AI Telegram Chatbot\n\nThis project is a **Telegram Chatbot** powered by **Google Gemini AI**, allowing users to interact with the latest AI model directly through Telegram. The bot is capable of answering questions, engaging in conversations, and providing intelligent responses on various topics.\n\n## ✨ Features\n- **Conversational AI** using the Google Gemini API.\n- **Real-time interaction** through Telegram.\n- **Contextual and natural** conversation flow.\n- **Easy deployment** with Docker support.\n\n## 🚀 Getting Started\n\nFollow these steps to set up and run the bot locally.\n\n### 1. Clone the repository\n```bash\ngit clone https://github.com/XredaX/chatbot-telegram\ncd chatbot-telegram\n```\n\n### 2. Install dependencies\nMake sure you have Python installed. Then, run the following command to install the required packages:\n```bash\npip install -r requirements.txt\n```\n\n### 3. Set environment variables\nYou need to set two environment variables for the bot to function properly:\n\n- `API_KEY`: Your Google Gemini API key\n- `BOT_TOKEN`: Your Telegram bot token\n\nYou can set these in your environment or use a `.env` file:\n```bash\nexport API_KEY=\"your_gemini_api_key\"\nexport BOT_TOKEN=\"your_telegram_bot_token\"\n```\n\nAlternatively, create a `.env` file in the root directory of the project:\n```\nAPI_KEY=your_gemini_api_key\nBOT_TOKEN=your_telegram_bot_token\n```\n\n### 4. Configure the Gemini API and Telegram Bot\n\nThe bot will fetch these environment variables during runtime:\n```python\ngenai.configure(api_key=os.getenv('API_KEY'))\nTELEGRAM_BOT_TOKEN = os.getenv('BOT_TOKEN')\n```\n\n### 5. Run the bot\nAfter setting the environment variables, you can start the bot by running:\n```bash\npython bot.py\n```\n\nThe bot will be up and running, ready to interact with users via Telegram.\n\n## 🤝 Contributing\nContributions are welcome! Feel free to open issues or submit pull requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxredax%2Fchatbot-telegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxredax%2Fchatbot-telegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxredax%2Fchatbot-telegram/lists"}