Ross ROSS = Recommend OSS · open-source software intelligence for agents

NapNeko/NapCatQQ

Modern protocol-side framework based on NTQQ observed · 2026-08-28

github.com/NapNeko/NapCatQQ · homepage · TypeScript · NOASSERTION (other) observed · 2026-08-28

Health v2 · maintenance only

87/100

  • Activity 99
  • Release rhythm 86
  • Longevity 63

Flags: no_license

How is this computed?

round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.

  • gap_med: 0
  • age_days: 890
  • days_rel: 19
  • days_push: 7
  • n_releases_24m: 408

Full methodology

Adoption not part of the score

10401 stars · 808 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

NapCatQQ is a modern bot protocol-side framework implemented on top of NTQQ, exposing a rich OneBot 11-compatible API for QQ messaging. It runs headless with low memory usage and supports multiple deployment methods on Windows, Linux, and macOS.

Use cases

  • run a qq bot without the desktop client
  • implement a onebot 11 protocol endpoint for qq
  • build a chatbot that sends and receives qq messages
  • deploy a lightweight headless qq bot on a low-memory server
  • connect llm bot frameworks to qq
  • automate qq group message pushing

When to choose

  • you need a stable, actively maintained OneBot 11 implementation for NTQQ
  • you want low memory usage and headless operation without Electron
  • you need broad API coverage and multiple deployment options
  • you want to migrate between bot protocols via its Core/Adapter architecture

When to avoid

  • you need a protocol for a platform other than QQ
  • you require a permissively licensed dependency - the license is a custom mixed license with usage restrictions
  • you expect community support for basic integration questions - the project explicitly does not provide that
  • you want an officially sanctioned client modification - unauthorized use may violate QQ terms of service

Facets

framework · maturity active

chatbot api-framework websocket http-server middleware chatbots messaging-platforms developer-tools windows cross-platform self-hosted onebot11 qq-bot ntqq bot-protocol headless automation linux macos nodejs docker

2 sources

Member repositories

RepositoryRoleHealth v2
NapNeko/NapCatQQmain87

For agents

markdown · JSON · MCP: product_card(name="NapNeko/NapCatQQ")

Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem