Skip to main content

Chatsee SDK (Python)

Installation

pip install chatsee-ai

Environment deployment (Dev / QA / Demo / Poc)

The SDK supports one package and you select the environment by setting api_base_url to an alias: "dev" | "qa" | "demo" | "poc".

Alias URL
dev https://dev-react.chatsee.ai/api
qa https://qa.chatsee.ai/api
demo https://gcp-demo.chatsee.ai/api
poc https://app.chatsee.ai/api
dev-legacy https://dev.chatsee.ai/api

Or pass any full URL (e.g. "https://my-custom-host.com/api").

Classifiers source (redaction)

Redaction classifiers are fetched from the same environment you select via api_base_url (endpoint …/v1/redaction/fetch_classifiers). Override with redaction_classifiers_url if needed.

Usage (tracking)

from chatsee import ChatseeTracker

tracker = ChatseeTracker(
    agent_id="agent_1",
    tenant_id="tenant_1",
    api_base_url="qa",  # or "dev" / "demo" / "poc"
    redaction_enabled=True,  # optional: locally redact before sending
)

tracker.start_turn("My email is test@example.com", metadata={"any": "metadata"})
tracker.end_turn("Thanks!")

Usage (redaction as an SDK feature)

Module-level chatsee.redact()

from chatsee import redact

redacted = redact(
    {"message": "Card 4111 1111 1111 1111", "email": "a@b.com"},
    api_base_url="qa",
    fields_to_redact="*",
    verify_ssl=True,
)

Tracker instance tracker.redact()

redacted = tracker.redact({"user_message": "Phone +1 (555) 123-4567"}, fields_to_redact="*")

Encryption

Encryption support has been removed from this SDK.

Track Claude Code (adapter)

Claude Code is a closed CLI, so instead of instrumenting its code you point the adapter at its session logs. It reconstructs each turn and sends it via the SDK.

# preview (sends nothing)
python -m chatsee.adapters.claude_code --latest --dry-run

# one-time hook install -> every completed turn auto-streams, no terminal needed
python -m chatsee.adapters.claude_code --install-hook \
  --agent-id <AGENT_ID> --tenant-id <TENANT_ID> --env dev

# remove it
python -m chatsee.adapters.claude_code --uninstall-hook

Alternatives to the hook: --watch (foreground tail) or a one-shot run. A per-session checkpoint (~/.chatsee/claude_code_state.json) prevents duplicates.

Redaction is on by default. Claude Code turns — especially tool arguments and results — often contain secrets and PII, so the adapter redacts client-side before sending (fields: user_message, bot_message, tool_calls_details, exception, system_prompt). Override the field set with --redact-fields a,b,c, or disable entirely with --no-redact (not recommended). The setting is preserved in installed hooks/autostart commands.

Release files for chatsee-ai 0.11.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chatsee-ai 0.11.0
File Size Uploaded
chatsee_ai-0.11.0.tar.gz 29.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for chatsee-ai 0.11.0
File Interpreter ABI Platform
chatsee_ai-0.11.0-py3-none-any.whl Python 3 none any Details

Total release size: 55.8 kB

Release files / chatsee_ai-0.11.0.tar.gz

Download URL chatsee_ai-0.11.0.tar.gz
Size 29.2 kB
Tags Source
SHA-256 checksum
How to use checksums
33a6a179ad6ee0df6fca29682af9fe6fed9a3e73f80e0ee513a761e3a6d26dcc
BLAKE2b-256 checksum
How to use checksums
2469509d056f66baf04a33c110aa1dadcfc39042eff9acc80ac9d4f2901a8bae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release files / chatsee_ai-0.11.0-py3-none-any.whl

Download URL chatsee_ai-0.11.0-py3-none-any.whl
Size 26.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d038d21a96e1e3984b0bdfdcc9788429a2211eb1c3723bb634701a66804e8044
BLAKE2b-256 checksum
How to use checksums
ea3d7efb04608f783ba2d548832d89f53082af6be9edf0be0f1c76b22ba2609d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release history Release notifications | RSS feed

0.14.0

2 release files

0.13.0

2 release files

0.12.1

2 release files

0.12.0

2 release files

This release

0.11.0 This release

2 release files

0.10.0

2 release files

0.9.5

2 release files

0.9.4

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page