# koishijs/koishi

Cross-platform chatbot framework made with love

Repository: https://github.com/koishijs/koishi
Canonical: https://ross.abutalabs.com/products/koishi
Homepage: https://koishi.chat
Language: TypeScript
License: MIT
License Family: permissive
Topics: koishi, chatbot, onebot, bot, telegram, discord, koishijs, feishu, sdk, lark, matrix, framework, line, mail
Last push: 2026-03-08T16:36:46+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 71, release rhythm 74, longevity 100
- inputs: {"age_days": 2465, "days_push": 178, "days_rel": 177, "gap_med": 0.0, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6125, forks 335 (observed 2026-08-28T04:09:36.229322+00:00)

## What it is
Koishi is a cross-platform, extensible chatbot framework written in TypeScript for Node.js. It provides a unified SDK for building bots across platforms like QQ, Telegram, Discord, Feishu/Lark, Matrix, and Line, with a rich plugin ecosystem, web dashboard, and sandbox preview.

## Use cases
- build a chatbot that runs on QQ, Telegram, and Discord from one codebase
- create a cross-platform bot with a plugin ecosystem
- develop and hot-reload bot plugins like frontend development
- monitor and configure my bot through a web dashboard
- simulate chat messages in a sandbox before deploying
- handle millions of chat records with a multi-driver database
- write a bot SDK with full TypeScript type support

## When to choose
- you want one bot framework supporting many chat platforms
- you prefer TypeScript with strong typing and hot module reload
- you need a plugin marketplace and active community
- you want a dashboard and sandbox for bot management

## When to avoid
- you need a single-platform bot with minimal dependencies
- you want a language other than TypeScript/JavaScript
- you need a lightweight script rather than a full framework

## Facets
- artifact type: framework
- maturity: active
- function: chatbot, agent-framework, plugin-system, sdk, web-framework, database, gui
- domain: chatbots, messaging-platforms, developer-tools, cross-platform
- platform: cross-platform, self-hosted
- tags: onebot, telegram, discord, feishu, lark, matrix, line, qq, plugin-market, hot-reload, dashboard, sandbox, automation, nodejs, typescript, web-server

## Member repositories
- koishijs/koishi (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:36.229322+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:47:59.298666+00:00, confidence not recorded.
  - readme: https://github.com/koishijs/koishi (fetched 2026-08-28T04:09:36.229322+00:00, sha 8d894eb409e3)
  - homepage: https://koishi.chat (fetched 2026-08-29T08:44:50.408614+00:00, sha cf9c4836f54d)
  - site_page: https://koishi.chat/zh-CN/about/contact.html (fetched 2026-08-29T08:44:50.411269+00:00, sha 744a388311f8)
  - site_page: https://koishi.chat/zh-CN/about/community.html (fetched 2026-08-29T08:44:50.413051+00:00, sha 4d56915536cc)
  - site_page: https://koishi.chat/zh-CN/releases/index.html (fetched 2026-08-29T08:44:50.414574+00:00, sha 2c2209b76392)
- Data as of 2026-08-30T08:39:29.467469+00:00.