Skip to main content

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

Status Python License


📦 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


📜 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xwchat-0.0.1.10.tar.gz (70.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xwchat-0.0.1.10-py3-none-any.whl (115.0 kB view details)

Uploaded Python 3

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

Hashes for xwchat-0.0.1.10.tar.gz
Algorithm Hash digest
SHA256 8289bebf8b524e3bb103ea3d8d8fe8cf352390ce5e2ed8eebc981a0ee57ee273
MD5 b4b2e67472a4ec2d720025a43527d484
BLAKE2b-256 37d093c65d9b4343d13569f1438b2b7d351fa0a0ce29893ea24231b9ed25927b

See more details on using hashes here.

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

Hashes for xwchat-0.0.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 c64c3e9987e3698360e8c546eb7102185030be3d8be72c5f894e1bdd4359270e
MD5 25138fff63c3b7997d5173222c929767
BLAKE2b-256 ac94f139a93de5a24d20ca056044e047d1e6a44ba9c85030e3631af1ad4f1409

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page