How iwyxdxl/pawzochat works
PawzoChat is an extensible AI companion platform that brings character-based conversations to WeChat, QQ, and a Web panel. Its principal workflow receives a message through a channel, queues and processes a conversation round with configured context and model/tool calls, then dispatches and persists the reply. Separate capabilities cover memory and worldbooks, image and voice generation, MCP tools, plugins, and social moments. The README documents these branches; sampled source confirms manager setup and provider selection, but not every runtime call path.
Main entry points: chat.py Chat processing · channels Message channels · app.py Application lifecycle · reply_dispatcher.py Reply dispatch
Components 24
Conversation runtime
- Application lifecycle
pawzochat/app.py - Message queue
pawzochat/services/message_queue.py - Chat processing
pawzochat/services/chat.py - Reply dispatch
pawzochat/services/reply_dispatcher.py - Conversation store
pawzochat/store/conversation.py
Channels and transport
- Message channels
pawzochat/channels - Platform transport
pawzochat/transport
AI capabilities
- LLM providers
pawzochat/llm - Memory service
pawzochat/services/memory.py - Worldbook service
pawzochat/services/worldbook.py - Image generation
pawzochat/image - Voice synthesis
pawzochat/voice - MCP tools
pawzochat/mcp - MCP servers
data/mcp_servers
Web management
- Web panel
pawzochat/web/static/app.js - Web application
pawzochat/web/app.py - Management routes
pawzochat/web/routes
Extensions and social
- Social moments
pawzochat/services/moments.py - Moments store
pawzochat/store/moments.py - Plugin runtime
pawzochat/core/extensions/manager.py
Other components
- User
- LLM service
- Image service
- TTS service
Connections 26
- User → Message channels: sends message
- Message channels → Platform transport: uses platform
- Message channels → Message queue: accepts message
- Message queue → Chat processing: processes round
- Chat processing → LLM providers: requests inference
- LLM providers → LLM service: calls provider
- Chat processing → Memory service: uses context
- Chat processing → Worldbook service: loads entries
- Chat processing → MCP tools: invokes tools
- MCP tools → MCP servers: calls tools
- Chat processing → Image generation: generates image
- Image generation → Image service: calls provider
- Chat processing → Voice synthesis: synthesizes speech
- Voice synthesis → TTS service: calls provider
- Chat processing → Reply dispatch: produces reply
- Reply dispatch → Conversation store: persists messages
- Reply dispatch → Message channels: delivers reply
- Application lifecycle → Chat processing: wires service
- Application lifecycle → Web application: starts panel
- Web panel → Web application: requests panel
- Web application → Management routes: registers routes
- Management routes → Conversation store: manages history
- Management routes → Memory service: manages memories
- Social moments → Moments store: persists activity
- Application lifecycle → Plugin runtime: loads plugins
- Plugin runtime → Message channels: registers channel