Skip to main content
The Vijil package includes everything you need to evaluate and protect agents programmatically:
  • Vijil client — Run evaluations, manage agents, retrieve results
  • LocalAgentExecutor — Wrap local agent functions for evaluation without deployment
  • Dome SDK — Add runtime guardrails to intercept and filter agent inputs/outputs
One package, one install. Choose optional extras based on your framework.

Requirements

  • Python 3.9+
  • pip or poetry

Install with pip

pip install vijil

Install with poetry

poetry add vijil

Verify Installation

import vijil
print(vijil.__version__)

Quick Test

from vijil import Client

client = Client(api_key="your-api-key")

# List your agents
agents = client.agents.list()
print(f"Found {len(agents)} agents")

Optional Dependencies

For Dome SDK

pip install vijil[dome]

For LangChain Integration

pip install vijil[langchain]

For Full Development

pip install vijil[all]

Configuration

Environment Variables

export VIJIL_API_KEY="your-api-key"

Configuration File

Create ~/.vijil/config.yaml:
api_key: your-api-key
base_url: https://api.vijil.ai  # default
timeout: 30  # seconds

Next Steps

Authentication

Configure API keys

Quickstart

Run your first evaluation
Last modified on March 19, 2026