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)
| File | Size | Uploaded | |
|---|---|---|---|
| chatsee_ai-0.12.0.tar.gz | 29.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|