# mrs4s/go-cqhttp

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/mrs4s-go-cqhttp).**

10,653 stars · 1,587 forks · Go · AGPL-3.0

## Links

- GitHub: https://github.com/Mrs4s/go-cqhttp
- awesome-repositories: https://awesome-repositories.com/repository/mrs4s-go-cqhttp.md

## Topics

`bot` `coolq` `coolq-http-api` `qqbot` `qqrobot`

## Description

go-cqhttp is a native Go implementation of the CQHTTP protocol that serves as a messaging platform gateway. It translates network events from the QQ messaging platform into standardized JSON messages, providing a backend for building automated bots.

The project distinguishes itself by supporting bidirectional communication through both HTTP APIs and WebSocket connections. It features a flexible execution model that includes both forward and reverse communication modes, allowing remote servers to initiate connections and manage client sessions.

The system covers a broad range of capabilities, including the transmission and parsing of multimedia messages, real-time event monitoring, and account administration. It provides tools for managing group configurations, member permissions, and the retrieval of contact and profile data. Additionally, it includes media processing utilities for tasks such as text-to-speech and image-to-text conversion.

The software is produced as a statically linked binary that runs natively across different operating systems.

## Tags

### Networking & Communication

- [API Gateways](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/messaging-platform-integrations/api-gateways.md) — Provides a gateway server that translates QQ network events into standardized JSON messages for external application integration.
- [Messaging Platform Integrations](https://awesome-repositories.com/f/networking-communication/messaging-platform-integrations.md) — Acts as a connectivity layer between automated bots and the QQ messaging platform. ([source](https://github.com/mrs4s/go-cqhttp#readme))
- [Chat Platform Integrations](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/communication-platforms/messaging-middleware/chat-platform-integrations.md) — Connects external software to chat protocols via HTTP and WebSockets for bidirectional data flow.
- [Protocol Translators](https://awesome-repositories.com/f/networking-communication/cross-chain-messaging-protocols/protocol-translators.md) — Translates QQ network events into standardized CQHTTP JSON messages via a lightweight cross-platform server.
- [WebSocket Clients and Servers](https://awesome-repositories.com/f/networking-communication/distributed-systems-p2p/distributed-computing/communication-protocols/websocket-implementations/websocket-clients-and-servers.md) — Establishes persistent full-duplex WebSocket connections for real-time event streaming and command execution.
- [Messaging Bot Frameworks](https://awesome-repositories.com/f/networking-communication/messaging-bot-frameworks.md) — Provides a programmable interface for creating and managing automated bots on messaging platforms.
- [Multi-Protocol Communication Bridges](https://awesome-repositories.com/f/networking-communication/multi-protocol-communication-bridges.md) — Provides bidirectional data exchange using both HTTP APIs and WebSocket connections in forward and reverse modes. ([source](https://github.com/mrs4s/go-cqhttp#readme))
- [Protocol Translation Bridges](https://awesome-repositories.com/f/networking-communication/protocol-translation-bridges.md) — Translates standard HTTP requests into protocol-specific commands for synchronous interaction with the messaging service.
- [QQ Bot Development](https://awesome-repositories.com/f/networking-communication/qq-bot-development.md) — Implements the CQHTTP protocol to enable the development of automated bots specifically for the QQ platform.
- [Reverse Connection Management](https://awesome-repositories.com/f/networking-communication/communication-protocols-architectures/communication-protocols-standards/network-protocols/connection-establishment-protocols/reverse-connection-management.md) — Implements a reverse proxy mechanism allowing remote servers to initiate connections and manage client sessions.
- [User Profile Retrieval](https://awesome-repositories.com/f/networking-communication/contact-management/user-profile-retrieval.md) — Fetches user profile details, contact lists, and login information for registered and unknown users. ([source](https://github.com/mrs4s/go-cqhttp#readme))
- [JSON-RPC Implementations](https://awesome-repositories.com/f/networking-communication/json-rpc-implementations.md) — Uses a standardized JSON-RPC interface to decouple internal protocol logic from API handling.
- [Messaging Event Monitoring](https://awesome-repositories.com/f/networking-communication/messaging-event-monitoring.md) — Tracks real-time activity including incoming messages, content deletions, and group membership changes. ([source](https://github.com/mrs4s/go-cqhttp#readme))
- [Real-Time Messaging](https://awesome-repositories.com/f/networking-communication/real-time-messaging.md) — Tracks live communication events and membership changes to trigger automated responses.

### Part of an Awesome List

- [Messaging Multimedia Transmission](https://awesome-repositories.com/f/awesome-lists/media/media-and-files/messaging-multimedia-transmission.md) — Facilitates the transmission and parsing of text, images, voice records, and videos via messaging APIs. ([source](https://github.com/mrs4s/go-cqhttp#readme))

### Programming Languages & Runtimes

- [Chatbot Runtimes](https://awesome-repositories.com/f/programming-languages-runtimes/chatbot-runtimes.md) — Provides a native Go runtime for processing real-time messaging events and automating social interactions.

### Content Management & Publishing

- [Interaction Event Tracking](https://awesome-repositories.com/f/content-management-publishing/chat-community-management/social-community-interactions/interaction-event-tracking.md) — Enables processing of friend requests and group joins while tracking specific interaction events like poking. ([source](https://github.com/mrs4s/go-cqhttp#readme))

### Development Tools & Productivity

- [Cross-Platform and Native Compilation](https://awesome-repositories.com/f/development-tools-productivity/build-tooling/cross-platform-native-compilation.md) — Produces statically linked binaries that run natively across different operating systems using the Go toolchain.

### Software Engineering & Architecture

- [Asynchronous Event Dispatchers](https://awesome-repositories.com/f/software-engineering-architecture/asynchronous-event-dispatchers.md) — Implements a non-blocking pipeline to process protocol events and ensure high throughput for concurrent messages.

### System Administration & Monitoring

- [User Account Administration](https://awesome-repositories.com/f/system-administration-monitoring/user-account-administration.md) — Provides a programmatic interface for managing user profiles, contact lists, and group permissions.
