{"id":13825031,"url":"https://github.com/sudoAlireza/GeminiBot","last_synced_at":"2025-07-08T21:30:51.173Z","repository":{"id":222186255,"uuid":"756437648","full_name":"sudoAlireza/GeminiBot","owner":"sudoAlireza","description":"TelegramBot Tool to Interact with Google's Gemini AI Chatbot","archived":false,"fork":false,"pushed_at":"2024-02-15T20:18:25.000Z","size":789,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-02-16T19:28:48.493Z","etag":null,"topics":["ai-chatbot","chatbot","gemini","gemini-ai","gemini-api","gemini-pro","gemini-pro-vision","google-bard","python-telegram-bot","telegram-bot","telegram-bot-api"],"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/sudoAlireza.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-02-12T17:01:04.000Z","updated_at":"2024-05-30T01:29:32.060Z","dependencies_parsed_at":"2024-05-30T01:29:29.319Z","dependency_job_id":"b729f487-a22f-4458-90d6-50fd3e1c077d","html_url":"https://github.com/sudoAlireza/GeminiBot","commit_stats":null,"previous_names":["sudoalireza/geminibot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sudoAlireza/GeminiBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudoAlireza%2FGeminiBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudoAlireza%2FGeminiBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudoAlireza%2FGeminiBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudoAlireza%2FGeminiBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sudoAlireza","download_url":"https://codeload.github.com/sudoAlireza/GeminiBot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudoAlireza%2FGeminiBot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264352602,"owners_count":23594926,"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-chatbot","chatbot","gemini","gemini-ai","gemini-api","gemini-pro","gemini-pro-vision","google-bard","python-telegram-bot","telegram-bot","telegram-bot-api"],"created_at":"2024-08-04T09:01:13.769Z","updated_at":"2025-07-08T21:30:51.150Z","avatar_url":"https://github.com/sudoAlireza.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# GeminiBot - Personalized Telegram Bot\n\nGeminiBot is a Telegram bot tailored to chat with Google's Gemini AI chatbot. Leveraging the official Gemini Bot on the Telegram platform, it engages users in dynamic conversations.\n\n[Set-up Tutorial on Medium](https://medium.com/@alirezafathi/how-to-use-google-gemini-ai-in-your-personal-telegram-bot-on-your-own-server-b1f0b9de2bdd)\n\n## Getting Started\n\n### Prerequisites\n\nBefore deploying the bot, ensure you have the following:\n\n- Python 3.10 installed on your system\n- Obtain a [Telegram API token](https://core.telegram.org/bots) from BotFather\n- Acquire a [Gemini API key](https://makersuite.google.com/app/apikey) from the Google Gemini website\n- Get your Telegram Account id from [Show Json Bot](https://t.me/ShowJsonBot). Account id is different than Account username and you should set it in `.env` file to restrict GeminiBot to your account.\n\n##\n\n\nhttps://github.com/sudoAlireza/GeminiBot/assets/87416117/beeb0fd2-73c6-4631-baea-2e3e3eeb9319\n\n\n\n### Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/sudoAlireza/GeminiBot.git\n   ```\n\n2. Navigate to the project directory:\n\n   ```bash\n   cd GeminiBot\n   ```\n\n3. Install the required dependencies:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n### Configuration\n\n1. Create a file named `.env` in the project root and add your Telegram bot API token and Gemini API key:\n\n   ```dotenv\n   TELEGRAM_BOT_TOKEN=\u003cYour Telegram Bot Token\u003e\n   GEMINI_API_TOKEN=\u003cYour Gemini API key\u003e\n   AUTHORIZED_USER=\u003cYour Telegram account ID number\u003e\n   ```\n\n2. Update the `safety_settings.json` file with appropriate safety settings for Gemini policies.\n\n### Usage\n\nRun GeminiBot using:\n\n```bash\npython main.py\n```\n\n## Features\n\n- Engage in online conversations with Google's Gemini AI chatbot\n- Maintain conversation history for continuing or initiating new discussions\n- Send images with captions to receive responses based on the image content. For example, the bot can read text within images and convert it to text.\n\n\n## To-Do\n\n- [x] **Removing Specific Conversation from History**\n- [ ] **Add Conversation Feature to Images Part**\n- [ ] **Handle Long Responses in Multiple Messages**\n- [ ] **Add Tests and Easy Deployment**\n\n\n## Documentation\n\nFor detailed instructions on using Telegram bots, refer to the [Telegram Bots Documentation](https://core.telegram.org/bots).\n\nTo begin with Gemini, refer to the [Gemini API: Quickstart with Python](https://ai.google.dev/tutorials/python_quickstart).\n\n\n## Security\n\nEnsure the security of your API keys and sensitive information. Follow best practices for securing API keys and tokens.\n\n## Contributing\n\nContributions to GeminiBot are encouraged. Feel free to submit issues and pull requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FsudoAlireza%2FGeminiBot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FsudoAlireza%2FGeminiBot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FsudoAlireza%2FGeminiBot/lists"}