DEDUPED Hot AI repos, turned into use cases Get the Monday 5

How to use Octop Gateway: what you can do with it

What is Octop Gateway? octop-gateway is a Python library that connects AI agents and bots to many instant-messaging platforms through one message abstraction and one processor.

How do I use it? Run pip install octop-gateway in a Python 3.12+ environment; then save the minimal echo bot example from the README as a Python file, and set the environment variable TELEGRAM_BOT_TOKEN to your bot token; run the saved file with python <your-file>.py. Full steps below.

Trended earlier

View repo on GitHub

Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer

What do you want to do?

5 use cases

  • Run a working Telegram echo bot in under an hour

    Install the library and run the README echo example to confirm messages flow end to end.

    View prompt
    Using the octop-gateway repo at TencentCloud/octop-gateway, install the core package and run the Telegram echo example with my bot token stored in TELEGRAM_BOT_TOKEN. Report whether the bot replies 'Echo: <message>' to a test message from <target chat>. Verify that the process stays running after startup.

  • Serve one agent on Feishu, DingTalk, and QQ at once

    Attach three IM platforms to one processor so the agent logic is written once.

    View prompt
    In the TencentCloud/octop-gateway repo, build a ChannelManager that attaches Feishu, QQ, and DingTalk channels to one processor using credentials from my .env file. Expected output: a running process that replies to a test message from each platform with the channel type in brackets. Verify that all three channels start without errors in the logs.

  • Stream an LLM agent's reply token by token into chat

    Use DELTA events and a final COMPLETED event so users see the answer as it is generated.

    View prompt
    Using the octop-gateway repo, write an async processor that streams tokens from <model client> as MessageEvent DELTA events and ends with COMPLETED, then attach it to a Telegram channel. Expected output: a chat reply that grows over time for a long prompt. Verify that an ERROR event is never yielded for a normal run.

  • Create QQ Bot credentials by scanning a QR code

    Use QQBotQRLogin to get QQ Bot credentials without copying an AppID and AppSecret by hand.

    View prompt
    In the TencentCloud/octop-gateway repo, run the QQ Bot QR binding flow with QQBotQRLogin, print the qrcode_url for <user>, and wait for confirmation. Expected output: a QQConfig object built from result.credentials[0] and saved to <config store>. Verify that result.connected is true before building the config.

  • Run two Feishu apps for two teams in one process

    Register two channels of the same kind with separate credentials and keep them isolated.

    View prompt
    In the TencentCloud/octop-gateway repo, create one ChannelManager with two Feishu channels using credentials for <team A> and <team B> from environment variables. Expected output: two channels running side by side with distinct channel_id values. Verify that a message to team A's bot never appears on team B's channel.

Quick start with Octop Gateway

  1. Check you have what it needs: Python 3.12+; Credentials for each platform you connect, such as a Telegram bot token, Feishu app ID and secret, or a Discord bot token; Access to the developer portal of each platform you use.
  2. Open TencentCloud/octop-gateway on GitHub and read the README and license.
  3. Run pip install octop-gateway in a Python 3.12+ environment.
  4. Save the minimal echo bot example from the README as a Python file, and set the environment variable TELEGRAM_BOT_TOKEN to your bot token.
  5. Run the saved file with python <your-file>.py. (inferred, check the README)
  6. Send a text message to your Telegram bot and check that it replies with the text prefixed by 'Echo: '.

These steps come from our top use case, Run a working Telegram echo bot in under an hour, which also has a copy-paste agent prompt.

Use this in your AI agent

Ask your agent

Using the Deduped MCP, get the setup steps for TencentCloud/octop-gateway

Add Deduped to Claude Code once

claude mcp add --transport http deduped https://dedupedai.com/mcp

Cursor, ChatGPT, others

Octop Gateway alternatives · Best AI repos for Software and DevOps

About this repo

  • Who it is forPython developers building chatbots or AI agents who want one message handler to work across several IM platforms.
  • Why it is hot77 stars, launched 32 days ago, picked up by one AI source we track
  • LanguagePython
  • Sourcegithub.com/TencentCloud/octop-gateway · Back to Hot repos

Requirements

  • Python 3.12+
  • Credentials for each platform you connect, such as a Telegram bot token, Feishu app ID and secret, or a Discord bot token
  • Access to the developer portal of each platform you use
  • A processor function that reads InboundMessage and yields MessageEvent objects

Add this badge to your README

Maintain Octop Gateway? Show readers where to find these use cases. Use cases on Deduped

Markdown 

[![Use cases on Deduped](https://dedupedai.com/badge/TencentCloud/octop-gateway.svg)](https://dedupedai.com/use-cases/tencentcloud-octop-gateway/?utm_source=github&utm_medium=badge&utm_campaign=TencentCloud-octop-gateway)

HTML 

<a href="https://dedupedai.com/use-cases/tencentcloud-octop-gateway/?utm_source=github&amp;utm_medium=badge&amp;utm_campaign=TencentCloud-octop-gateway"><img src="https://dedupedai.com/badge/TencentCloud/octop-gateway.svg" alt="Use cases on Deduped" height="20"></a>

A static image, no tracking script. About the badge

Questions about Octop Gateway

What is Octop Gateway?

octop-gateway is a Python library that connects AI agents and bots to many instant-messaging platforms through one message abstraction and one processor. It is an open-source project on GitHub: https://github.com/TencentCloud/octop-gateway.

How do I use Octop Gateway?

Run pip install octop-gateway in a Python 3.12+ environment; then save the minimal echo bot example from the README as a Python file, and set the environment variable TELEGRAM_BOT_TOKEN to your bot token; run the saved file with python <your-file>.py. The use cases on this page give the full steps and a copy-paste agent prompt for each job.

Who is Octop Gateway for?

Python developers building chatbots or AI agents who want one message handler to work across several IM platforms.

What can I do with Octop Gateway?

5 use cases so far, for example: Run a working Telegram echo bot in under an hour; Serve one agent on Feishu, DingTalk, and QQ at once; Stream an LLM agent's reply token by token into chat. Each has steps and a copy-paste agent prompt.

What do I need to run Octop Gateway?

Python 3.12+; Credentials for each platform you connect, such as a Telegram bot token, Feishu app ID and secret, or a Discord bot token; Access to the developer portal of each platform you use; A processor function that reads InboundMessage and yields MessageEvent objects.

What are alternatives to Octop Gateway?

Other hot AI repos in Software and DevOps: Deep Infer, Harness2, Orca, Opencode, Graphify.

Is Octop Gateway safe to run?

Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.