This extension provides a set of tools to interact with the Telegram Bot API directly from the Gemini CLI.

• Send messages
• Read messages
• Get bot information
• Get chat information
• Edit messages
• Delete messages
• Send photos
• Send documents
• Get chat administrators
• Answer callback queries

To install the extension, run the following command in your Gemini CLI:

/extension install https://github.com/VSKurkin/gemini-cli-telegram-extension.git

Note: Your Gemini CLI must be configured to allow installing third-party extensions.

This extension requires a Telegram Bot API token. You can provide it in one of two ways:

1. Environment Variable (Recommended): Set the TELEGRAM_BOT_TOKEN environment variable in your system. This is the most secure and flexible method.

   • Linux/macOS:

     export TELEGRAM_BOT_TOKEN="your-bot-token"

   • Windows:

     $env:TELEGRAM_BOT_TOKEN="your-bot-token"

2. .env File: Create a file named .env in the directory where you run the gemini command. Add the following line to it:

   TELEGRAM_BOT_TOKEN="your-bot-token"
   

To use the tools provided by this extension, you need to make a tool call in your prompt. The Gemini CLI will execute the tool call and return the result.

Example 1: Send a message

To send a message, make a tool call to telegram:send_message with the chat_id and text parameters.

telegram:send_message(chat_id="your-chat-id", text="Hello from Gemini!")

Example 2: Read new messages

To read new messages, make a tool call to telegram:read.

telegram:read()

Example 3: Send a photo

To send a photo, make a tool call to telegram:send_photo.

telegram:send_photo(chat_id="your-chat-id", photo_path="/path/to/your/photo.jpg")

This section provides a detailed description of each tool and its parameters.

Sends a text message.

Reads new messages.

Gets information about the bot. (No parameters)

Gets information about a chat.

Edits a text message.

Deletes a message.

Sends a photo.

Sends a document.

Gets a list of chat administrators.

Answers a callback query.

To set up the development environment, follow these steps:

1. Clone the repository:

   git clone https://github.com/VSKurkin/gemini-cli-telegram-extension.git
   cd gemini-cli-telegram-extension

2. Create a virtual environment:

   python -m venv .venv
   source .venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt
   pip install ruff # Or add it to a requirements-dev.txt

To run the tests, execute the following command from the root of the repository:

python -m unittest discover tests

To lint the code, use ruff:

ruff check .

To format the code, use ruff:

ruff format .