Metadata-Version: 2.4
Name: googlechatai
Version: 0.0.2
Summary: Python package for the Google Chat AI SDK.
Project-URL: Homepage, https://github.com/adamallcock/googlechatai
Project-URL: Repository, https://github.com/adamallcock/googlechatai
Project-URL: Issues, https://github.com/adamallcock/googlechatai/issues
Author: Adam Allcock
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.10
Provides-Extra: fastapi
Requires-Dist: fastapi<0.139.0,>=0.138.2; extra == 'fastapi'
Requires-Dist: uvicorn[standard]<0.50.0,>=0.49.0; extra == 'fastapi'
Description-Content-Type: text/markdown

# googlechatai

googlechatai is a polyglot Google Chat AI SDK for building serious Google
Chat apps, AI assistants, and workflow extensions without living at the raw
REST-object layer. This is the Python package (standard library only, Python
3.10+); a matching Node.js package is published as `googlechatai` on npm,
kept behaviorally aligned through shared fixtures and cross-language
conformance tests.

Highlights:

- Deep normalization of Chat events, messages, actions, cards, and
  attachments into stable, model-ready structures.
- A webhook router with slash command, mention, reaction, membership, and
  dialog handlers, plus dedupe, deadline, and inbound request verification
  (Chat app bearer tokens and Pub/Sub push OIDC, verified with a
  stdlib-only RS256 implementation).
- Dry-run call plans for sends, replies, threads, reactions, and pins, and
  an executor that turns plans into real API calls with retries,
  idempotency, and explicit live-mode safety gates.
- Live streaming of model output through message edits via
  `stream_chat_reply` / `astream_chat_reply`, driven by a deterministic
  scheduler with patch cadence, size-limit truncate/split, cancellation,
  and resume.
- AI-first helpers: conversation context builders, attachment pipelines,
  placeholder responses, async response handoff, token stores, and queue
  adapters. Optional FastAPI/ASGI adapters install with
  `pip install "googlechatai[fastapi]"`.

Status: early development (0.0.x). APIs may change between minor versions
while the SDK stabilizes.

googlechatai is an independent project and is not affiliated with or
endorsed by Google LLC. Google Chat is a trademark of Google LLC.

Licensed under the Apache License 2.0. See LICENSE and NOTICE.
