An agent that calls OpenAI, Anthropic, or Google GenAI from Python
Install
The base package has no LLM SDK dependencies of its own. Install it with the
extra matching the provider(s) your agent uses so the right instrumentation is
pulled in:
The PyPI distribution is named visceral-ai. The import name is visceral:
from visceral import wrap, instrument, node, tool
Anthropic users: stay on anthropic<1.0.anthropic 1.x removed an API
surface the instrumentation still imports, so under 1.x the SDK captures
zero LLM calls while your agent runs normally: everything looks
instrumented, and the dashboard shows an agent with no calls. Install with
the [anthropic] extra, which pins anthropic>=0.25,<1.0 for you (since
SDK 0.2.4); if you manage the provider pin yourself, keep the same cap. A
bare pip install visceral-ai on top of an incompatible provider SDK is the
trap this pin exists to avoid. Since 0.2.3 the SDK also warns loudly at
wrap() when an instrumentor fails to attach, instead of failing silently.
Authenticate
The SDK reads your workspace API key from the environment:
export VISCERAL_API_KEY="vsc_live_..."
Create a key from the dashboard.The full key is shown exactly once when it’s minted — Visceral stores only a
hash of it. By default the SDK reports to https://api.visceralai.dev; set
VISCERAL_BASE_URL to point at anything else.
Set up with Claude Code
The package ships a setup command, installed as visceral and also runnable
as python -m visceral:
visceral install # or: python -m visceral install
It registers a /visceral skill with Claude Code
(in ~/.claude/skills, or in the current repo’s .claude/skills with
--project). Then open Claude Code in the repo you want instrumented and run
/visceral . to have it wire the SDK into your agent. visceral install --stdout prints the skill instead, for other assistants or manual setup.Next: instrument your agent.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Visceral","description":"Docs for the Visceral SDK: instrument your agent and cut inference cost safely.","colors":{"primary":"#9333EA","light":"#C084FC","dark":"#7E22CE"},"logo":{"light":"https://mintcdn.com/visceral/OTeNOeolOjV3PfK-/logo/light.svg?fit=max\u0026auto=format\u0026n=OTeNOeolOjV3PfK-\u0026q=85\u0026s=6703188c49d394b1cb8385b43537cb35","dark":"https://mintcdn.com/visceral/OTeNOeolOjV3PfK-/logo/dark.svg?fit=max\u0026auto=format\u0026n=OTeNOeolOjV3PfK-\u0026q=85\u0026s=19b86af847b10845f241af17910488fd","href":"https://www.visceralai.dev"},"favicon":"https://mintcdn.com/visceral/bpGHS2r5j08t-Bm2/favicon.svg?fit=max\u0026auto=format\u0026n=bpGHS2r5j08t-Bm2\u0026q=85\u0026s=566c2e3f060b4687a07bb2f71b42bb76","appearance":{"default":"light"},"background":{"decoration":"grid","color":{"light":"#F8F2E6","dark":"#09090B"}},"navbar":{"links":[{"href":"https://www.visceralai.dev/research","label":"Research"},{"href":"https://github.com/visceral-ai","label":"GitHub"}],"primary":{"type":"button","label":"Sign in","href":"https://www.visceralai.dev/signin"}},"footer":{"socials":{"github":"https://github.com/visceral-ai"},"links":[{"header":"Product","items":[{"label":"How it works","href":"https://www.visceralai.dev/"},{"label":"Get started","href":"https://www.visceralai.dev/signup"},{"label":"Sign in","href":"https://www.visceralai.dev/signin"}]},{"header":"Resources","items":[{"label":"Research","href":"https://www.visceralai.dev/research"},{"label":"Contact","href":"https://www.visceralai.dev/contact"}]}]},"fonts":{"heading":{"family":"Playfair Display"},"body":{"family":"Plus Jakarta Sans"}},"styling":{"codeblocks":"dark","latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"visceral","hasAudioNarration":false,"actualSubdomain":"visceral","customDomains":["docs.visceralai.dev"],"gitSource":{"type":"github","owner":"visceral-ai","repo":"visceral-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a89c4d7d55e45e735127623","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"API Reference","count":32},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Auth \u0026 sessions","count":10},{"language":"default","tag":"Observability","count":9},{"language":"default","tag":"Workspaces \u0026 keys","count":6},{"language":"default","tag":"SDK","count":5},{"language":"default","tag":"SDK \u0026 ingestion","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Concepts","count":2},{"language":"default","tag":"Health","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"sdk/installation","slug":"/sdk/installation","pageMetadata":{"title":"Installation","description":"Add the Visceral SDK to a Python agent.","icon":"cube","href":"/sdk/installation"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Add the Visceral SDK to a Python agent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`requirements`,children:`Requirements`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Python 3.10+`}),`\n`,_jsx(_components.li,{children:`An agent that calls OpenAI, Anthropic, or Google GenAI from Python`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`install`,children:`Install`}),`\n`,_jsx(_components.p,{children:`The base package has no LLM SDK dependencies of its own. Install it with the\nextra matching the provider(s) your agent uses so the right instrumentation is\npulled in:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`pip`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'visceral-ai[openai]'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`pip`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'visceral-ai[anthropic]'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`pip`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'visceral-ai[google]'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`pip`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'visceral-ai[all-providers]'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Building on a framework instead? Add its extra so\n`,_jsx(_components.a,{href:`/sdk/instrumenting#instrumenting-a-framework-with-instrument`,children:_jsx(_components.code,{children:`instrument()`})}),`\ncan capture it (these aren’t part of `,_jsx(_components.code,{children:`all-providers`}),`):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`pip`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'visceral-ai[langchain]'`}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` # LangChain + LangGraph`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`pip`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'visceral-ai[llama-index]'`}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` # LlamaIndex`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`pip`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'visceral-ai[crewai]'`}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` # CrewAI`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The PyPI distribution is named `,_jsx(_components.code,{children:`visceral-ai`}),`. The import name is `,_jsx(_components.code,{children:`visceral`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` visceral `}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` wrap, instrument, node, tool`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Anthropic users: stay on `,_jsx(_components.code,{children:`anthropic\u003c1.0`}),`.`]}),` `,_jsx(_components.code,{children:`anthropic`}),` 1.x removed an API\nsurface the instrumentation still imports, so under 1.x the SDK captures\n`,_jsx(_components.strong,{children:`zero`}),` LLM calls while your agent runs normally: everything looks\ninstrumented, and the dashboard shows an agent with no calls. Install with\nthe `,_jsx(_components.code,{children:`[anthropic]`}),` extra, which pins `,_jsx(_components.code,{children:`anthropic>=0.25,\u003c1.0`}),` for you (since\nSDK 0.2.4); if you manage the provider pin yourself, keep the same cap. A\nbare `,_jsx(_components.code,{children:`pip install visceral-ai`}),` on top of an incompatible provider SDK is the\ntrap this pin exists to avoid. Since 0.2.3 the SDK also warns loudly at\n`,_jsx(_components.code,{children:`wrap()`}),` when an instrumentor fails to attach, instead of failing silently.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`authenticate`,children:`Authenticate`}),`\n`,_jsx(_components.p,{children:`The SDK reads your workspace API key from the environment:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` VISCERAL_API_KEY`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"vsc_live_...\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Create a key from the dashboard.`}),`\n`,_jsxs(_components.p,{children:[`The full key is shown exactly once when it’s minted — Visceral stores only a\nhash of it. By default the SDK reports to `,_jsx(_components.code,{children:`https://api.visceralai.dev`}),`; set\n`,_jsx(_components.code,{children:`VISCERAL_BASE_URL`}),` to point at anything else.`]}),`\n`,_jsx(Heading,{level:`2`,id:`set-up-with-claude-code`,children:`Set up with Claude Code`}),`\n`,_jsxs(_components.p,{children:[`The package ships a setup command, installed as `,_jsx(_components.code,{children:`visceral`}),` and also runnable\nas `,_jsx(_components.code,{children:`python -m visceral`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`visceral`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` # or: python -m visceral install`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`It registers a `,_jsx(_components.code,{children:`/visceral`}),` skill with `,_jsx(_components.a,{href:`https://claude.com/claude-code`,children:`Claude Code`}),`\n(in `,_jsx(_components.code,{children:`~/.claude/skills`}),`, or in the current repo’s `,_jsx(_components.code,{children:`.claude/skills`}),` with\n`,_jsx(_components.code,{children:`--project`}),`). Then open Claude Code in the repo you want instrumented and run\n`,_jsx(_components.code,{children:`/visceral .`}),` to have it wire the SDK into your agent. `,_jsx(_components.code,{children:`visceral install --stdout`}),` prints the skill instead, for other assistants or manual setup.`]}),`\n`,_jsxs(_components.p,{children:[`Next: `,_jsx(_components.a,{href:`/sdk/instrumenting`,children:`instrument your agent`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Installation","description":"Add the Visceral SDK to a Python agent.","icon":"cube","href":"/sdk/installation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Requirements","slug":"requirements","depth":2,"children":[]},{"title":"Install","slug":"install","depth":2,"children":[]},{"title":"Authenticate","slug":"authenticate","depth":2,"children":[]},{"title":"Set up with Claude Code","slug":"set-up-with-claude-code","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"visceral","siteName":"Visceral","title":"Installation - Visceral","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-21T21:17:03.152Z","originalFileLocation":"sdk/installation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add the Visceral SDK to a Python agent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Visceral\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Installation - Visceral\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add the Visceral SDK to a Python agent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Visceral\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.visceralai.dev/sdk/installation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://visceral.mintlify.site/_mintlify/api/og/v2?division=SDK\u0026amp;title=Installation\u0026amp;description=Add+the+Visceral+SDK+to+a+Python+agent.\u0026amp;theme=0154727b0bfc4265035be65d\u0026amp;signature=1dda2af435999e0c52c8ce36ec8640b8591a8877876240f57e922d9f534f4074\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Installation - Visceral\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add the Visceral SDK to a Python agent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://visceral.mintlify.site/_mintlify/api/og/v2?division=SDK\u0026amp;title=Installation\u0026amp;description=Add+the+Visceral+SDK+to+a+Python+agent.\u0026amp;theme=0154727b0bfc4265035be65d\u0026amp;signature=1dda2af435999e0c52c8ce36ec8640b8591a8877876240f57e922d9f534f4074\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/visceral/ModMiBYp1aeOyaRg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Visceral\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9333EA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.visceralai.dev/sdk/installation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/sdk/installation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.visceralai.dev/#organization\",\"name\":\"Visceral\",\"url\":\"https://docs.visceralai.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/visceral/OTeNOeolOjV3PfK-/logo/light.svg?fit=max\u0026auto=format\u0026n=OTeNOeolOjV3PfK-\u0026q=85\u0026s=6703188c49d394b1cb8385b43537cb35\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.visceralai.dev#website\",\"name\":\"Visceral\",\"url\":\"https://docs.visceralai.dev\",\"publisher\":{\"@id\":\"https://docs.visceralai.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.visceralai.dev/sdk/installation#webpage\",\"url\":\"https://docs.visceralai.dev/sdk/installation\",\"name\":\"Installation\",\"description\":\"Add the Visceral SDK to a Python agent.\",\"dateModified\":\"2026-08-21T21:17:03.152Z\",\"isPartOf\":{\"@id\":\"https://docs.visceralai.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.visceralai.dev/sdk/installation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.visceralai.dev/sdk/installation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Visceral\",\"item\":\"https://docs.visceralai.dev\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Installation\",\"item\":\"https://docs.visceralai.dev/sdk/installation\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.visceralai.dev/sdk/installation#article\",\"headline\":\"Installation\",\"name\":\"Installation\",\"description\":\"Add the Visceral SDK to a Python agent.\",\"url\":\"https://docs.visceralai.dev/sdk/installation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.visceralai.dev/sdk/installation#webpage\"},\"dateModified\":\"2026-08-21T21:17:03.152Z\",\"publisher\":{\"@id\":\"https://docs.visceralai.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.visceralai.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Visceral\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Visceral\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/sdk/installation.md","siteName":"Visceral","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"Introduction","icon":"house","href":""},{"title":"Quickstart","icon":"rocket","href":"/quickstart"},{"title":"Plans \u0026 limits","description":"What the hosted free tier includes, how its caps are enforced, and how to see your usage.","icon":"gauge","href":"/plans-and-limits"}]},{"group":"SDK","pages":[{"title":"Installation","icon":"cube","href":"/sdk/installation"},{"title":"Instrumenting your agent","description":"Wrap the LLM client your agent already uses — sync or async — and annotate its steps.","icon":"plug","href":"/sdk/instrumenting"},{"title":"Configuration","icon":"sliders","href":"/sdk/configuration"},{"title":"Optimization","icon":"bolt","href":"/sdk/optimization"},{"title":"Tool-call reuse","icon":"wrench","href":"/sdk/tools"}]},{"group":"Concepts","pages":[{"title":"How it works","icon":"diagram-project","href":"/concepts/how-it-works"},{"title":"Privacy \u0026 data","icon":"lock","href":"/concepts/privacy"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Installation - Visceral","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":[],"chunks":[]}