Skip to main content
Developer Resources

Vienna OS SDKs

Official client libraries for JavaScript, TypeScript, and Python. Build AI governance into your applications in minutes.

Installation

JavaScript / TypeScript

via npm

npm install vienna-os
TypeScript types included

Python

via PyPI

pip install vienna-os
Type hints included

Quick Start

JavaScript / TypeScript

import { ViennaClient } from 'vienna-os';

const vienna = new ViennaClient({
  apiKey: process.env.VIENNA_API_KEY,
  baseUrl: 'https://console.regulator.ai/api/v1'
});

// Register your agent
await vienna.agents.register({
  id: 'my-agent-v1',
  name: 'My AI Agent',
  capabilities: ['read_files', 'send_emails'],
  riskTier: 2
});

// Request approval for high-risk action
const proposal = await vienna.proposals.create({
  agentId: 'my-agent-v1',
  action: 'send_email',
  target: 'customer@example.com',
  payload: { subject: 'Update', body: '...' }
});

// Check if approved
if (proposal.state === 'approved') {
  // Execute action with warrant
  await vienna.executions.create({
    proposalId: proposal.id,
    warrantId: proposal.warrantId,
    result: { status: 'sent' }
  });
}

Python

from vienna_os import ViennaClient
import os

vienna = ViennaClient(
    api_key=os.environ['VIENNA_API_KEY'],
    base_url='https://console.regulator.ai/api/v1'
)

# Register your agent
vienna.agents.register(
    id='my-agent-v1',
    name='My AI Agent',
    capabilities=['read_files', 'send_emails'],
    risk_tier=2
)

# Request approval for high-risk action
proposal = vienna.proposals.create(
    agent_id='my-agent-v1',
    action='send_email',
    target='customer@example.com',
    payload={'subject': 'Update', 'body': '...'}
)

# Check if approved
if proposal.state == 'approved':
    # Execute action with warrant
    vienna.executions.create(
        proposal_id=proposal.id,
        warrant_id=proposal.warrant_id,
        result={'status': 'sent'}
    )

Features

Simple API

Intuitive methods for agent registration, proposal creation, warrant verification, and execution tracking.

Type Safety

Full TypeScript definitions and Python type hints for IDE autocomplete and error checking.

Async/Await

Modern async patterns for non-blocking governance checks in your application.

Webhook Handlers

Built-in utilities for verifying and handling Vienna OS webhook events.

Ready to Build?

Start governing your AI agents in minutes. No credit card required.