gemini-cli-telegram-extension

KO | EN

gitlite — search

#hacktoberfest #ai #golang #go #android #machine-learning #nodejs #windows #awesome #cli #kubernetes #security #mcp #ios

gemini-cli-telegram-extension

(★ 21)

Telegram extension for the Gemini CLI

gemini-cli-telegram-extension Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Gemini Telegram Extension

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

## Features

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

## Installation

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

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

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

## Configuration

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:**
        ```bash
        export TELEGRAM_BOT_TOKEN="your-bot-token"
        ```
    -   **Windows:**
        ```powershell
        $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"
    ```

## Usage

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")

## Available Tools

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

### `telegram:send_message`

Sends a text message.

### `telegram:read`

Reads new messages.

### `telegram:get_me`

Gets information about the bot. (No parameters)

### `telegram:get_chat`

Gets information about a chat.

### `telegram:edit_message_text`

Edits a text message.

### `telegram:delete_message`

Deletes a message.

### `telegram:send_photo`

Sends a photo.

### `telegram:send_document`

Sends a document.

### `telegram:get_chat_administrators`

Gets a list of chat administrators.

### `telegram:answer_callback_query`

Answers a callback query.

## Development

To set up the development environment, follow these steps:

1.  **Clone the repository:**
    ```bash
    git clone https://github.com/VSKurkin/gemini-cli-telegram-extension.git
    cd gemini-cli-telegram-extension
    ```

2.  **Create a virtual environment:**
    ```bash
    python -m venv .venv
    source .venv/bin/activate
    ```

3.  **Install dependencies:**
    ```bash
    pip install -r requirements.txt
    pip install ruff # Or add it to a requirements-dev.txt
    ```

### Running Tests

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

```bash
python -m unittest discover tests
```

### Linting

To lint the code, use `ruff`:

```bash
ruff check .
```

To format the code, use `ruff`:

```bash
ruff format .
```

gemini-cli-telegram-extension

gemini-cli-telegram-extension Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gemini-cli-telegram-extension

gemini-cli-telegram-extension Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README