Skip to content

Add qq-ai-bot compose example#137

Open
happysnaker wants to merge 1 commit into
Haxxnet:mainfrom
happysnaker:add-qq-ai-bot-example
Open

Add qq-ai-bot compose example#137
happysnaker wants to merge 1 commit into
Haxxnet:mainfrom
happysnaker:add-qq-ai-bot-example

Conversation

@happysnaker

Copy link
Copy Markdown

Summary

Add a qq-ai-bot Docker Compose example under Large Language Models & AI.

This example packages a runnable NapCat + qq-ai-bot stack so self-hosters can validate a full QQ -> OneBot 11 -> ACP agent flow on one machine, instead of only deploying another browser chat UI.

Included files:

  • examples/qq-ai-bot/docker-compose.yml
  • examples/qq-ai-bot/.env
  • examples/qq-ai-bot/napcat.onebot11.reverse-ws.json
  • examples/qq-ai-bot/README.md

The example uses the public ghcr.io/happysnaker/qq-ai-bot:latest image and keeps the built-in mock ACP agent enabled by default, so users can verify reverse WebSocket wiring, persistent sessions, progress streaming, and basic bot commands before swapping in a real ACP-compatible local agent.

Notes

  • follows the existing example pattern with ${DOCKER_VOLUME_STORAGE} bind mounts
  • keeps optional Traefik labels commented out like the other examples
  • exposes NapCat WebUI on 6099 and qq-ai-bot health/status endpoints on 18080
  • docker compose config passes for this example

Disclosure: I am the author of qq-ai-bot.

@happysnaker

Copy link
Copy Markdown
Author

Small maintainer note: I proposed this example because it gives self-hosters a runnable messaging-native AI stack instead of only another browser chat UI. qq-ai-bot sits between NapCat / OneBot 11 transport and an ACP-compatible agent, so this compose example lets someone validate the full QQ -> OneBot -> agent path first with the built-in mock agent, then swap in their own local runtime later.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant