You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
add a new napcat-qq-ai-bot Docker Compose sample under the "basic setups" section
show a messaging-native local stack using NapCat for QQ / OneBot transport and qq-ai-bot as the ACP bridge
keep the sample intentionally local-development oriented with the built-in mock ACP agent for deterministic first-run validation
Why this sample is useful
Most Compose examples around AI focus on web UIs, model serving, or generic chat apps. This sample demonstrates a different but real integration shape:
That gives Compose users one concrete reference for a message-channel deployment path, not only browser-facing apps.
What is included
compose.yaml for napcat + qq-ai-bot
a matching NapCat OneBot reverse-WS config file
a README that documents the local-validation flow, ports, login path, token note, health endpoints, and how to replace the mock ACP agent with a real one
Small follow-up note: ghcr.io/happysnaker/qq-ai-bot:latest now publishes both linux/amd64 and linux/arm64, so this sample is no longer only relevant to x86 hosts. That makes the NapCat + qq-ai-bot compose shape more realistic for self-hosted / homelab users running ARM NAS or SBC hardware too.
That run pulled ghcr.io/happysnaker/qq-ai-bot:sha-99a42df as linux/arm64, started the container, and verified /readyz, /status, and /metrics. This keeps the sample more realistic for both x86 and ARM self-hosted / homelab environments.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
napcat-qq-ai-botDocker Compose sample under the "basic setups" sectionWhy this sample is useful
Most Compose examples around AI focus on web UIs, model serving, or generic chat apps. This sample demonstrates a different but real integration shape:
That gives Compose users one concrete reference for a message-channel deployment path, not only browser-facing apps.
What is included
compose.yamlfornapcat+qq-ai-botProject page: https://happysnaker.github.io/qq-ai-bot/
Notes
ghcr.io/happysnaker/qq-ai-bot:latestimagedocker compose configCloses #780