vigil-sdk

Route OpenAI and Anthropic API calls through the Vigil AI security proxy. One-line integration — wrap your existing client and everything else stays the same.

Quickstart

from openai import OpenAI
from vigil_sdk import wrap

client = wrap(OpenAI())
response = client.chat.completions.create(
    model="gpt-4o", messages=[{"role": "user", "content": "Hello"}]
)

Install

pip install vigil-sdk[openai]     # for OpenAI
pip install vigil-sdk[anthropic]  # for Anthropic
pip install vigil-sdk[all]        # both

Usage

OpenAI

from openai import OpenAI
from vigil_sdk import wrap

client = wrap(OpenAI())
# Use client exactly as before — all traffic flows through Vigil

Anthropic

from anthropic import Anthropic
from vigil_sdk import wrap

client = wrap(Anthropic())
# Use client exactly as before — all traffic flows through Vigil

Async clients

from openai import AsyncOpenAI
from vigil_sdk import wrap

client = wrap(AsyncOpenAI())

Custom proxy URL

client = wrap(OpenAI(), proxy_url="http://localhost:9090")

Or set the VIGIL_PROXY_URL environment variable.

How it works

wrap() reconfigures the client's underlying HTTP transport to route through the Vigil proxy at localhost:8080. The proxy intercepts requests, runs them through Vigil's security pipeline (injection detection, policy enforcement, anomaly scoring), and forwards allowed requests to the upstream API. Blocked requests return a 403 before reaching the AI provider.

Requirements

• Python 3.9+
• Vigil proxy running locally (the Vigil menu bar app handles this)
• openai>=1.0 and/or anthropic>=0.20

License

MIT