https://github.com/cyio/tg-gemini-bot

https://github.com/cyio/tg-gemini-bot

Last synced: 11 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/cyio/tg-gemini-bot
• Owner: cyio
• Created: 2023-12-26T00:11:53.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-12-26T00:11:58.000Z (about 2 years ago)
• Last Synced: 2024-04-29T21:14:34.247Z (over 1 year ago)
• Language: Python
• Homepage: https://tg-gemini-bot-bit.vercel.app
• Size: 998 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# tg-gemini-bot

The tg-gemini-bot let's you use Google Gemini services right on your personal Telegram bot.

Super easy, just a single click and you've got it set up on Vercel.

![screen](./screenshots/screen.png)

## Features

- This is built with Flask - super straightforward and easy to develop.

- It's an all front-end project, and you can get it up and running on Vercel with just one click.

- Supports Gemini continuous conversation. (Due to Vercel's restrictions, conversations may not be saved for a long time)

- Supports both Gemini text, image interface, and telegram markdown.

## Preparation

Get these things ready, and then fill them in as environment variables in Vercel.

- **GOOGLE_API_KEY**

  apply for your Google gemini pro api: https://makersuite.google.com/app/apikey

- **BOT_TOKEN**

  create your own telegram bot ([check the tutorial](https://flowxo.com/how-to-create-a-bot-for-telegram-short-and-simple-guide-for-beginners/)), obtain the token of the bot, which is in the format similar to: `67295022320:AAHmfuSQb0ZoUq0ycNPvgzqCCX7I1uzzaSE`

- **ALLOWED_USERS**

  Gather the Telegram usernames of users who are permitted to access this bot, separating them with a comma (`,`). The usernames should be formatted like this: `name1,name2`. Including the `@` symbol is optional, so either `ohmorningsir` or `@ohmorningsir` is acceptable.

## Get Started

1. Click [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwinniesi%2Ftg-gemini-bot&env=BOT_TOKEN%2CGOOGLE_API_KEY%2CALLOWED_USERS&project-name=tg-gemini-bot&repository-name=tg-gemini-bot) to deploy to Vercel.

2. **Set the environment variable** according to the instructions below.

3. Once everything's done, visit the domain name of your Vercel project address.

4. Fill in your telegram bot token on the page to associate telegram bot and vercel.

![update_telegram_bot](./screenshots/update_telegram_bot.png)

## Environment Variable

| Environment Variable | Required | Description                                                                                                                            |

| -------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |

| GOOGLE_API_KEY       | Yes      | Your Google gemini pro api, it looks like `AI2aS4Cl55F9ni9WN84Qn_KWRSuqXvUWkPq6kovc `                                                  |

| BOT_TOKEN            | Yes      | The Telegram bot token you applied for, it looks like `67295022320:AAHmfuSQb0ZoUq0ycNPvgzqCCX7I1uzzaSE`                                |

| ALLOWED_USERS        | Yes      | List the allowed Telegram usernames. If there's more than one person, just split them with `,` and it should look like: `name1,name2`. |