{"id":15199956,"url":"https://github.com/xsymphony/telegram-gemini-bot","last_synced_at":"2025-10-17T19:28:57.484Z","repository":{"id":223803092,"uuid":"761581765","full_name":"xsymphony/telegram-gemini-bot","owner":"xsymphony","description":"One-click deployment of a Telegram bot using the Gemini API","archived":false,"fork":false,"pushed_at":"2024-02-29T07:03:36.000Z","size":232,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-14T14:58:13.988Z","etag":null,"topics":["gemini-api","telegram-bot","vercel"],"latest_commit_sha":null,"homepage":"https://telegram-gemini-bot-one.vercel.app","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xsymphony.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-02-22T05:12:53.000Z","updated_at":"2024-02-23T08:11:59.000Z","dependencies_parsed_at":"2024-02-29T08:24:56.741Z","dependency_job_id":null,"html_url":"https://github.com/xsymphony/telegram-gemini-bot","commit_stats":null,"previous_names":["xsymphony/telegram-gemini-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xsymphony%2Ftelegram-gemini-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xsymphony%2Ftelegram-gemini-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xsymphony%2Ftelegram-gemini-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xsymphony%2Ftelegram-gemini-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xsymphony","download_url":"https://codeload.github.com/xsymphony/telegram-gemini-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241844286,"owners_count":20029611,"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":["gemini-api","telegram-bot","vercel"],"created_at":"2024-09-28T02:22:38.056Z","updated_at":"2025-10-17T19:28:57.433Z","avatar_url":"https://github.com/xsymphony.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003etelegram-gemini-bot\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n🔨One-click deployment of a Telegram bot using the Gemini API\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"README.md\"\u003e中文\u003c/a\u003e | English\n\u003c/p\u003e\n\n## Preview\n\u003cimg src=\"screenshot/chat.png\" alt=\"chat\" width=\"400\"/\u003e\n\n## Prerequisites (Must-Read)\n### GEMINI_API_KEY\nWhen using the Gemini API, developers need an exclusive API key to use. Follow the [official instructions](https://ai.google.dev/tutorials/web_quickstart?hl=zh-cn#set-up-project) to apply for it.\n### TGBOT_TOKEN\nAfter creating a Telegram bot, you need to obtain a specific token to use this bot to send messages or configure other behaviors.\nInitiate a conversation with [@BotFather](https://t.me/botfather) to request the bot until you acquire the token.\nYou can refer to the [complete guide](https://core.telegram.org/bots/tutorial).\n\n### DOMAIN\nSince this project utilizes the Telegram bot webhook to receive messages, it requires setting the callback address for the bot to your deployed project address.\nAfter deploying with `vercel`, if you haven't altered the repository name, fill in the form `https://telegram-gemini-bot-{{github user name}}-projects.vercel.app`.\nOther available addresses include:\n+ `https://telegram-gemini-{{random suffix}}.vercel.app`\n+ `https://telegram-gemini-bot-{{github user name}}-projects.vercel.app`\n+ `https://telegram-gemini-bot-git-main-{{github user name}}-projects.vercel.app`\n\n## Getting Started with Deployment\n1. Click [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fxsymphony%2Ftelegram-gemini-bot\u0026env=GEMINI_API_KEY,TGBOT_TOKEN,DOMAIN\u0026demo-title=Telegram%20Gemini%20Bot\u0026demo-url=https%3A%2F%2Ftelegram-gemini-bot-ten.vercel.app%2F) \n2. Follow the Vercel instructions to link your GitHub account and create a repository.\n3. When prompted to fill in environment variables, enter your `GEMINI_API_KEY` and `TGBOT_TOKEN`.\n4. Fill in the `DOMAIN` environment variable in the format `https://telegram-gemini-bot-{{github user name}}-projects.vercel.app`. If you input an incorrect address at this step, you can also modify the environment variables after deployment and restart the task to apply the correct address.\n5. Visit the successfully deployed project page, click `Enable bot message callback`, and then the page will refresh, displaying the correct webhook setup information, indicating that it has taken effect.\n6. Chat with the Telegram bot you created to verify if message handling is correct.\n\n\n## LICENSE\n\n[MIT](https://opensource.org/license/mit/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxsymphony%2Ftelegram-gemini-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxsymphony%2Ftelegram-gemini-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxsymphony%2Ftelegram-gemini-bot/lists"}