chatsee-ai 0.10.0

A Python SDK for Chatsee AI.

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.chatsee.ai/api
qa	https://qa.chatsee.ai/api
demo	https://gcp-demo.chatsee.ai/api
poc	https://app.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 [e-mail]", 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": "[e-mail]"},
    api_base_url="qa",
    fields_to_redact="*",
    verify_ssl=True,
)

Tracker instance tracker.redact()

redacted = tracker.redact({"user_message": "Phone [phone]"}, 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.