A pure Python, asynchronous wrapper for the Telegram Bot API, with high-level classes in telegram.ext for building bots.
koishijs/koishi
A cross-platform chatbot framework in TypeScript with a web console and plugin ecosystem for building bots across chat platforms.
- Stars
- 6,316
- Forks
- 358
- Open issues
- 113
- Last commit
- last month
What is it?
Koishi is a chatbot framework that lets developers build bots which run across multiple chat platforms, including QQ, Telegram, Discord, and Feishu. It supports multiple accounts per platform and cross-platform data sharing, so one bot can operate in several chat services at once.
The project includes a web console for monitoring bot status, controlling behavior, and installing plugins from an online plugin market, which lets users get a bot running without writing code. For developers, the framework is written in TypeScript with full type definitions, and it supports hot reloading of plugins during development.
Koishi's ecosystem consists of a large set of official and community plugins covering platform adapters, databases, resource storage, web consoles, and business features. The documentation provides a starter guide for new users.
Key features
- 01Supports QQ, Telegram, Discord, Feishu and other major chat platforms.
- 02Includes a web console for monitoring and controlling the bot.
- 03Offers an online plugin market for installing plugins without coding.
- 04Written in TypeScript with full type support.
- 05Supports hot reloading of plugins during development.
Use cases
- Running a community bot across several chat platforms at once.
- Building a custom bot for a group chat without writing much code.
- Developing and testing plugins with hot reloading and a TypeScript toolchain.
Quick start
- 1
Open the official quick start guide in the README
Things to know
- Quick start instructions are only linked to external documentation, not given in the README.
In collections
Topics
FAQ
- What is koishi?
- A cross-platform chatbot framework in TypeScript with a web console and plugin ecosystem for building bots across chat platforms. Koishi is a chatbot framework that lets developers build bots which run across multiple chat platforms, including QQ, Telegram, Discord, and Feishu. It supports multiple accounts per platform and cross-platform data sharing, so one bot can operate in several chat services at once.
- Is koishi free to use? What license does it have?
- koishi is open source under the MIT license. Check the license terms before using it in commercial products.
- Is koishi still maintained?
- Updated within 6 months. The last commit to koishi was on Oct 8, 2026.
- What can I use koishi for?
- Running a community bot across several chat platforms at once. Building a custom bot for a group chat without writing much code. Developing and testing plugins with hot reloading and a TypeScript toolchain.
- How do I install koishi?
- Open the official quick start guide in the README
- Where can I get koishi?
- The source code and installation instructions are on GitHub: https://github.com/koishijs/koishi
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A PHP framework for building Telegram bots, with handlers, middleware, conversations, and support for the full Telegram Bot API.
A Go chat bot that connects Telegram, Discord, Slack, Lark, DingTalk, WeCom, QQ and WeChat to LLMs such as OpenAI, Gemini and DeepSeek.
A Discord bot that turns a server or DM into a shared frontend for any OpenAI-compatible LLM, local or remote.
An asynchronous Python framework for building chatbots that connect to multiple chat platforms through pluggable protocol adapters.
A PHP SDK for building Telegram bots on the Telegram Bot API, with built-in Laravel support.