Convenience wrapper for exonware-xwchat - provides 'import xwchat' alias
Project description
xwchat
One agent, many chat networks. Telegram, WhatsApp, Instagram, and others behind one typed API. Chat UX lives here; heavy bot automation is aimed at xwbots. Docs in docs/.
Details: README_LONG.md.
Company: eXonware.com · Author: eXonware Backend Team · Email: connect@exonware.com
📦 Install
pip install exonware-xwchat
pip install exonware-xwchat[lazy]
pip install exonware-xwchat[full]
🚀 Quick start
from exonware.xwchat import XWChatAgent, Telegram
chat_agent = XWChatAgent(name="MyAgent", title="My Chat Agent", description="A helpful chat agent")
chat_agent.providers(Telegram("YOUR_TELEGRAM_API_TOKEN"))
await chat_agent["telegram"].send_message("user_id", "Hi there!")
See docs/ for the fluent API, multiple providers, and REF_* when present.
✨ What you get
| Area | What's in it |
|---|---|
| Providers | Telegram, WhatsApp, Instagram (and more); one API. |
| Interface | Protocol-based (IChatAgent); typed; easy to extend. |
| Scope | Chat flows; bot frameworks in xwbots. |
🌐 Ecosystem functional contributions
xwchat provides channel abstraction; sibling libraries handle automation logic, AI generation, persistence, and shared runtime behavior.
You can use xwchat standalone for multi-provider chat integration without the full XW stack.
Additional ecosystem modules are optional and most useful for enterprise and mission-critical chat platforms that need fully self-managed automation, identity, and data infrastructure.
| Supporting XW lib | What it provides to xwchat | Functional requirement it satisfies |
|---|---|---|
| XWAI | AI response generation and command interpretation integration for chat flows. | Intelligent conversational behavior across channels. |
| XWBots / XWAction | Bot-command and action execution orchestration on incoming chat events. | Structured automation and tool execution from chat interactions. |
| XWStorage | Persistent conversation state, session context, and message history backends. | Durable multi-session chat behavior and replayability. |
| XWEntity | Domain-aware identity/contact/user profile linkage in chat workflows. | Consistent user/domain mapping across channels and backend services. |
| XWAuth | AuthN/AuthZ boundaries for protected chat operations and agent actions. | Secure chat-triggered operations in multi-tenant environments. |
| XWSystem | Shared async/runtime/logging/config/security utilities. | Stable cross-provider operations and lower integration overhead. |
Competitive edge: one chat surface can participate in the full action/AI/domain stack instead of being a siloed messaging adapter.
📖 Docs and tests
- Start: docs/INDEX.md or docs/.
- Tests: From repo root, follow the project's test layout.
📜 License and links
Apache-2.0 - see LICENSE. Homepage: https://exonware.com · Repository: https://github.com/exonware/xwchat
⏱️ Async Support
- xwchat includes asynchronous execution paths in production code.
- Source validation: 219 async def definitions and 295 await usages under src/.
- Use async APIs for I/O-heavy or concurrent workloads to improve throughput and responsiveness.
Version: 0.0.1.10 | Updated: 18-Apr-2026
Built with ❤️ by eXonware.com - Revolutionizing Python Development Since 2025
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xwchat-0.0.1.10.tar.gz.
File metadata
- Download URL: xwchat-0.0.1.10.tar.gz
- Upload date:
- Size: 70.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8289bebf8b524e3bb103ea3d8d8fe8cf352390ce5e2ed8eebc981a0ee57ee273
|
|
| MD5 |
b4b2e67472a4ec2d720025a43527d484
|
|
| BLAKE2b-256 |
37d093c65d9b4343d13569f1438b2b7d351fa0a0ce29893ea24231b9ed25927b
|
File details
Details for the file xwchat-0.0.1.10-py3-none-any.whl.
File metadata
- Download URL: xwchat-0.0.1.10-py3-none-any.whl
- Upload date:
- Size: 115.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c64c3e9987e3698360e8c546eb7102185030be3d8be72c5f894e1bdd4359270e
|
|
| MD5 |
25138fff63c3b7997d5173222c929767
|
|
| BLAKE2b-256 |
ac94f139a93de5a24d20ca056044e047d1e6a44ba9c85030e3631af1ad4f1409
|