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.12.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.12.0
File Size Uploaded
chatsee_ai-0.12.0.tar.gz 29.9 kB Details

Built distribution (wheel)

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

Total release size: 56.9 kB

Release files / chatsee_ai-0.12.0.tar.gz

Download URL chatsee_ai-0.12.0.tar.gz
Size 29.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b9bd8517ed6579e1cfccde560e5f64755fd5788d867a4b0775a718a054acbf23
BLAKE2b-256 checksum
How to use checksums
dd14d8630c1d92abebb52a7d7843e098a11a1105fe7a2ef3ba9b1729548e423b
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.12.0-py3-none-any.whl

Download URL chatsee_ai-0.12.0-py3-none-any.whl
Size 26.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b5b4b2265e64c47858e29d04289816140e6812e4fca76013265d4dde0ca5eef8
BLAKE2b-256 checksum
How to use checksums
b937c94d444970886c48fa70f5b16bc0814e6c3e93f020b0c2239e5f2a56d78d
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

This release

0.12.0 This release

2 release files

0.11.0

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