Koishi logo

Koishi

Cross-Platform Chatbot Framework with Rich Plugin Ecosystem

TypeScript-based chatbot framework supporting QQ, Telegram, Discord, and more. Features a web console, 1000+ plugins, and hot-reload for seamless development.

Koishi banner

Overview

Build Powerful Chatbots Across Any Platform

Koishi is a high-performance, extensible chatbot framework designed for both non-technical users and professional developers. Named after the Touhou Project character Komeiji Koishi, it embodies the theme of automated, thoughtful interactions.

No-Code to Pro-Code Flexibility

The built-in web console lets anyone deploy a chatbot in minutes without programming knowledge. Browse and install from 1000+ official and community plugins covering platform adapters, databases, storage, monitoring, and business logic. Connect to QQ, Telegram, Discord, Feishu, and other major chat platforms with multi-account and cross-platform data synchronization. Monitor status, control behavior, and even chat directly through the dashboard.

Developer-First Architecture

Built entirely in TypeScript, Koishi delivers top-tier type safety and IntelliSense that reduces the need for documentation lookups. Core functionality is backed by comprehensive unit tests, establishing best practices for plugin testing and debugging. Hot module reloading enables save-and-refresh workflows comparable to modern frontend development, eliminating constant restarts during plugin development.

After four years of iteration, Koishi provides robust infrastructure for both large-scale interactive applications and lightweight utility bots, supported by detailed documentation and an active community.

Highlights

Web console with online plugin marketplace for zero-code setup
1000+ plugins covering platforms, databases, and business features
Full TypeScript support with rich IntelliSense and type safety
Hot module reloading for seamless plugin development workflow

Pros

  • Accessible to non-developers via intuitive web console
  • Mature ecosystem with four years of active development
  • Comprehensive TypeScript types reduce learning curve
  • Multi-platform and multi-account support out of the box

Considerations

  • Documentation and community resources primarily in Chinese
  • Large plugin ecosystem may require time to navigate
  • TypeScript requirement may deter JavaScript-only developers
  • Advanced features assume familiarity with modern Node.js tooling

Managed products teams compare with

When teams consider Koishi, these hosted platforms usually appear on the same shortlist.

Chanty logo

Chanty

Team chat and collaboration with channels, audio/video calls, and task management

Discord logo

Discord

Voice, video, and chat communities for groups and teams

Mattermost logo

Mattermost

Secure collaboration and messaging for mission-critical teams

Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.

Fit guide

Great for

  • Teams needing chatbots across multiple platforms simultaneously
  • Non-developers wanting no-code bot deployment with plugin marketplace
  • TypeScript developers building complex, scalable bot applications
  • Projects requiring hot-reload and rapid iteration cycles

Not ideal when

  • Teams requiring English-first documentation and support
  • Simple single-platform bots needing minimal dependencies
  • Developers preferring Python or other non-JavaScript ecosystems
  • Projects with strict constraints on bundle size or startup time

How teams use it

Multi-Platform Community Management

Synchronize messages and moderation across QQ, Discord, and Telegram with unified data storage and cross-platform user tracking.

Rapid Prototype Deployment

Non-technical team members install pre-built plugins from the marketplace to launch feature-rich bots in minutes without writing code.

Enterprise Integration Bot

Developers build custom TypeScript plugins with full type safety to integrate Feishu/Lark with internal APIs, leveraging hot-reload for fast iteration.

Interactive Game or Service Bot

Create complex stateful applications using Koishi's database abstractions and plugin architecture, with unit tests ensuring reliability at scale.

Tech snapshot

TypeScript100%
JavaScript1%

Tags

koishikoishijslinefeishutelegrammatrixmailframeworkbotlarksdkdiscordchatbotonebot

Frequently asked questions

Do I need programming experience to use Koishi?

No. The web console and plugin marketplace allow non-developers to install and configure chatbots without writing code. Developers can extend functionality with TypeScript plugins.

Which chat platforms does Koishi support?

Koishi supports QQ, Telegram, Discord, Feishu/Lark, LINE, Matrix, Mail, and OneBot protocol, with multi-account and cross-platform data synchronization.

What is hot module reloading and why does it matter?

Hot reload lets you save plugin code and see changes instantly without restarting the bot, dramatically speeding up development and debugging workflows.

Is Koishi suitable for large-scale production deployments?

Yes. Four years of iteration, comprehensive unit tests, and a robust plugin ecosystem make Koishi viable for both lightweight bots and complex, scalable applications.

What language is the documentation written in?

Primary documentation and community resources are in Chinese. English-speaking users may need translation tools or community support for full access.

Project at a glance

Active
Stars
5,418
Watchers
5,418
Forks
291
LicenseMIT
Repo age6 years old
Last commit2 days ago
Primary languageTypeScript

Last synced 3 hours ago