Skip to main content

TraceCtrl SDK — agentic AI security observability

Project description

TraceCtrl SDK

Security observability for agentic AI systems. TraceCtrl instruments your AI agents with OpenTelemetry, scans for security misconfigurations, and streams violations in real time to the TraceCtrl dashboard.

Install

pip install tracectrl

Quickstart

from tracectrl import init, tag_agent

# Initialize — sends traces to your TraceCtrl engine
init(endpoint="http://localhost:4317")

# Tag an agent with its system prompt for identity tracking
tag_agent("my-agent", system_prompt="You are a helpful assistant.")

Guardrails

from tracectrl.guardrails import register_guardrail, GuardrailAction

register_guardrail(
    agent_id="my-agent",
    name="no-exfiltration",
    action=GuardrailAction.BLOCK,
    description="Block attempts to send data to external endpoints",
)

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tracectrl-0.1.1.tar.gz (28.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tracectrl-0.1.1-py3-none-any.whl (35.0 kB view details)

Uploaded Python 3

File details

Details for the file tracectrl-0.1.1.tar.gz.

File metadata

  • Download URL: tracectrl-0.1.1.tar.gz
  • Upload date:
  • Size: 28.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for tracectrl-0.1.1.tar.gz
Algorithm Hash digest
SHA256 3e15baf5bc3e2fb08e4f8d82b13155cff7f0f092ad9d1cc7b6bb9c1ed7a56914
MD5 71f0dea4451cfa3fd7e9e1314ce83aa2
BLAKE2b-256 cefc9e28b077340a014c32b023b6e101b9b0f7979d558a794ded4b516a2da4e0

See more details on using hashes here.

Provenance

The following attestation bundles were made for tracectrl-0.1.1.tar.gz:

Publisher: publish.yml on tracectrl/tracectrl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tracectrl-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: tracectrl-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 35.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for tracectrl-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 faa9150b41826fc98b4cfa24261125fddbded563a7a728248c87a1a14ea67c42
MD5 ebba5cebb863d4f65421552eddf65a9c
BLAKE2b-256 738b3ae9a78898eb5b8cebe7cc2152dea61d2d6bef5772880420ee3847baf7b7

See more details on using hashes here.

Provenance

The following attestation bundles were made for tracectrl-0.1.1-py3-none-any.whl:

Publisher: publish.yml on tracectrl/tracectrl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page