Truveil — Making AI Accountable

Install the SDK

Add Truveil to your project in seconds. Available for JavaScript and Python — no external dependencies.

Log your agent actions

Add one line at each decision point in your agent. Every autonomous action gets captured automatically.

Get your audit report

Click Analyse — get a plain-language compliance report instantly. Export as PDF for regulators.

const Truveil = require('./truveil');
const truveil = new Truveil(
  'https://api.truveil.app',
  'YOUR_API_KEY_ABOVE',
  'My Agent'
);

const run = truveil.run();
run.decision('subject-001', {
  factors: ['criterion met', 'risk within threshold'],
  outcome: 'approve',
  confidence: 0.9,
});
run.stage('screening').complete('1 of 1 processed');

from truveil_sdk import TruveilSDK

sdk = TruveilSDK(
    'https://api.truveil.app',
    'YOUR_API_KEY_ABOVE',
    'My Agent'
)

run = sdk.run()
run.decision('subject-001',
    factors=['criterion met', 'risk within threshold'],
    outcome='approve',
    confidence=0.9)
run.stage('screening').complete('1 of 1 processed')

Active agents

—

of — tracked

High risk

—

needs review

Runs this week

—

across the fleet

As of

—

auto-refreshes hourly

Needs attention

checking…

All agents

Loading agents…

LIVE AGENT ACTIVITY

Waiting for your agent. Select a project above or connect your agent using the SDK.

or explore demo scenarios

Select a run to see the audit preview

Manual Analysis

Connect your AI agent

● Your API Key

Loading...

Use this key in any of the integrations below. Keep it private.

Closing ends your access now. Your personal account data is deleted or de-identified within 30 days. Audit-log records are retained under applicable data-retention requirements.

Standalone Python or JavaScript agent

Custom AI agent you have built and run yourself.

ChatGPT Workspace Agent

Agent built inside a ChatGPT Business or Enterprise workspace.

Custom GPT

GPT you have built in ChatGPT.

Click any platform above to see the step-by-step setup.

Connect your standalone agent

What you need: A Truveil API key from your dashboard, plus Python 3.7+ or Node.js 16+.

01Download the Truveil SDK file: truveil_sdk.py (Python) or truveil.js (JavaScript). Drop it into your project folder.
02Initialise the SDK once at the top of your agent file using your API key.
03Open a run handle with sdk.run() and record each decision with one named line, as below.

        
        
      
from truveil_sdk import TruveilSDK

sdk = TruveilSDK(
    'https://api.truveil.app',
    'your_truveil_api_key',
    'My Agent'
)

run = sdk.run()
run.decision('subject-001',
    factors=['criterion met', 'risk within threshold'],
    outcome='approve',
    confidence=0.9)
run.stage('screening').complete('1 of 1 processed')
const Truveil = require('./truveil');

const truveil = new Truveil(
  'https://api.truveil.app',
  'your_truveil_api_key',
  'My Agent'
);

const run = truveil.run();
run.decision('subject-001', {
  factors: ['criterion met', 'risk within threshold'],
  outcome: 'approve',
  confidence: 0.9,
});
run.stage('screening').complete('1 of 1 processed');

Test it Run your agent. Events appear in your Live Feed within seconds.

Connect your Workspace Agent

What you need: A ChatGPT Business, Enterprise, Edu, or Teachers plan with Developer Mode enabled, plus your Truveil API key.

01In ChatGPT, go to Workspace settings → Apps → enable Developer Mode.
02Open your Workspace Agent → Skills → Add custom MCP server.
03Paste the URL: https://mcp.truveil.app/mcp
04Set the header x-client-secret to your Truveil API key.
05Add the integration paragraph below to your agent's instructions.

You have access to the Truveil audit tool. After every material
decision, action, or recommendation you make, call the appropriate
Truveil tool before proceeding to the next step. Set project to the
name of this agent, run_id to a short identifier for this session,
and agent to the same name as the project. Include your reasoning in
the detail field. Do not assess or assign risk levels yourself.
Do not combine multiple decisions into one log entry. One decision,
one log entry. On completion, call get_audit_history with the project
name and report the total events logged.

Test it Run your agent on a task. Open Live Feed in your dashboard and watch events arrive.

Connect your Custom GPT

What you need: A ChatGPT Plus, Pro, Team, Business, or Enterprise plan, plus your Truveil API key.

01Open your Custom GPT → Configure → Actions → Create new action.
02Paste the OpenAPI schema below.
03Set Authentication to API Key, Custom header x-client-secret, value: your Truveil API key.
04Add the integration paragraph below to your GPT's Instructions.

openapi: 3.1.0
info:
  title: Truveil Audit
  version: 1.1.0
servers:
  - url: https://api.truveil.app
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-client-secret
security:
  - apiKeyAuth: []
paths:
  /log:
    post:
      operationId: logAgentEvent
      summary: Log a single agent decision or action
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [action, detail, project]
              properties:
                project: { type: string }
                run_id: { type: string }
                agent: { type: string }
                action: { type: string }
                detail: { type: string }
                decision_type: { type: string }
                human_checkpoint: { type: boolean }
                reversible: { type: boolean }
      responses:
        '200': { description: Event logged }
  /logs:
    get:
      operationId: getAuditHistory
      summary: Get audit history for a project
      parameters:
        - name: project
          in: query
          required: true
          schema: { type: string }
      responses:
        '200': { description: Logs returned }

You have access to the Truveil audit tool. After every material
decision, action, or recommendation you make, call logAgentEvent
before proceeding to the next step. Set project to the name of this
assistant, run_id to a short identifier for this session, and agent
to the same name as the project. Include your reasoning in the detail
field. Do not log secrets, credentials, or personal data in
detail fields.

Test it Ask your GPT to run a task. Open Live Feed in your dashboard and watch events arrive.