Skip to main content

​
Requirements

  • Node.js 18 or newer for JavaScript and TypeScript wrappers
  • Python 3.10 or newer for Python wrappers
  • An Averta API key
  • A policy attached to that Averta API key
  • Network access to https://api.averta.io
  • The native provider SDK for the provider you already use

​
Packages

PackageUse it when
@averta-security/sdk-openaiYour agent uses the OpenAI JavaScript SDK.
@averta-security/sdk-anthropicYour agent uses the Anthropic JavaScript SDK.
@averta-security/sdk-coreYou are building a custom adapter or unsupported provider integration.
averta-openaiYour agent uses the OpenAI Python SDK. Source beta; not on PyPI yet.
averta-coreYou are building Python custom adapter helpers. Source beta; not on PyPI yet.
Most applications should install a provider adapter, not sdk-core or averta-core directly. Use custom integrations or the raw API when no provider wrapper fits.

​
OpenAI

npm install openai @averta-security/sdk-openai
The Python packages are implemented in the SDK repository, but averta-openai and averta-core are not published to PyPI yet. Run the source install from the SDK repository until the PyPI release exists.
Python V1 requires Python 3.10 or newer, openai>=2, and a sync OpenAI client. It supports responses.create(...), responses.create(stream=True, ...), responses.stream(...), chat.completions.create(...), and chat.completions.create(stream=True, ...).

​
Anthropic JavaScript

npm install @anthropic-ai/sdk @averta-security/sdk-anthropic

​
Custom Adapters

npm install @averta-security/sdk-core
Use core packages only when you need to call the decision API yourself or build a provider adapter. If your runtime is not JavaScript or Python, use the raw API integration path.

​
Environment Variables

Set the provider key your agent already uses plus AVERTA_API_KEY. The Averta key must have a policy attached. 
export OPENAI_API_KEY="your-openai-key"
export ANTHROPIC_API_KEY="your-anthropic-key"
export AVERTA_API_KEY="your-averta-key"
Provider wrappers read AVERTA_API_KEY automatically. Use the explicit key option only when a wrapped client should ignore the process environment. If you are using a non-production Averta environment, you can also set: 
export AVERTA_BASE_URL="https://your-averta-host"

OpenAI quickstart

Wrap an existing OpenAI client.

Anthropic quickstart

Wrap an existing Anthropic client.

Custom integrations

Build an adapter on top of sdk-core.

Raw API

Call Averta directly from any language.

Choose an integration

Compare the supported paths.