> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sovara-labs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations

> Record LangChain, LangGraph, OpenAI Agents, Claude Code and Pi in Sovara with their integration packages.

Integrations record what only the framework knows about, such as agent steps, tool calls and
sessions, and add relevant lessons to model requests. Install the one for your framework next to
the [SDK](https://docs.sovara-labs.com/sdks.md); `auto_instrument()` / `autoInstrument()` still records model calls over HTTP
and MCP calls.

> [card] [LangChain and LangGraph](https://docs.sovara-labs.com/integrations/langchain.md)
>
> Middleware for `create_agent`, or a chat-model wrapper for LangGraph and direct model use.

> [card] [OpenAI Agents SDK](https://docs.sovara-labs.com/integrations/openai-agents.md)
>
> Function tools and agent tools of your agents.

> [card] [Claude Code](https://docs.sovara-labs.com/integrations/claude-code.md)
>
> Each session as a trace, with lessons added to every prompt.

> [card] [Pi](https://docs.sovara-labs.com/integrations/pi.md)
>
> Each session as a trace, with lessons added to Pi's context.

| Framework | Python | TypeScript |
| - | - | - |
| LangChain / LangGraph | `sovara-langchain` | `@sovara/langchain` |
| OpenAI Agents SDK | `sovara-openai-agents` | `@sovara/openai-agents` |
| Claude Code | `sovara-claude-code` | `@sovara/claude-code` |
| Pi | none | `@sovara/pi` |

> [!NOTE]
>
> Model calls that an integration records itself (the LangChain middleware and chat-model wrapper,
> Claude Code and Pi) are stored as conversations, not HTTP requests, so **Rerun** is not
> available for them. Model calls captured over HTTP by `auto_instrument()` can be rerun.

## Building an integration

Integrations use only the public SDK: the step API (`start_step`, `record_step`,
`retrieve_lessons`, ...), the cross-process functions, and `sovara.integration` /
`@sovara/sdk/integration`. Those helpers never let a Sovara outage break the host, retry only
briefly, and convert arbitrary values to JSON safely. See the
[Python](https://docs.sovara-labs.com/sdks/python/api-reference.md#integrations) and
[TypeScript](https://docs.sovara-labs.com/sdks/typescript/api-reference.md#integrations) API references.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.