visceral-ai 0.1.0

Visceral Python SDK — runtime optimization layer for AI agents

Visceral Python SDK

visceral — runtime optimization layer for AI agents. Wrap your LLM client and Visceral observes traffic, finds wasted work, and proves a cheaper call is safe before making it. Fails open: if Visceral is unreachable, your agent runs exactly as before.

Install

pip install "visceral-ai[openai]"   # or [anthropic], [google], [all-providers]

Distribution name is visceral-ai; the import package is visceral. Requires Python 3.10+.

Usage

from openai import OpenAI
from visceral import wrap

client = wrap(OpenAI(), agent_id="my-agent")   # same client back, now instrumented

Set VISCERAL_API_KEY (and VISCERAL_BASE_URL if self-hosting).

Prompt and response text never leaves your process unencrypted: content is stripped or AES-256-GCM-encrypted with your per-workspace key before export, and spans that cannot be redacted are dropped, never sent.

Develop

pip install -e ".[dev]"
ruff check src/ tests/
pytest

License

Apache-2.0 — see LICENSE.