​
Overview

The official Velatir SDK for Python provides a simple decorator-based approach to add human-in-the-loop approval to your functions. Simply decorate any function with @review_task() and Velatir will:
  • Intercept function calls and create approval requests
  • Route requests through your configured policies and flows
  • Wait for human approval before executing sensitive operations
  • Handle denials gracefully with detailed feedback

​
Quick Example

import velatir

velatir.init(api_key="your-api-key")

class EmailService:
    @velatir.review_task()
    def send_email(self, to: str, subject: str, body: str) -> None:
        # Your email sending logic here
        pass

​
Installation & Documentation

Get the latest version and complete documentation from PyPI:

velatir on PyPI

Install with pip install velatir - includes full API reference, examples, and type hints support

​
Features

  • Decorator-based integration - Just add @review_task() to any function
  • Async/sync support - Works with both synchronous and asynchronous functions
  • Type hints support - Complete type safety with modern Python typing
  • Framework integration - Works seamlessly with Django, Flask, FastAPI
  • Configurable polling - Customize approval timeout and retry behavior
  • Rich metadata - Add context for better approval routing
  • Exception handling - Graceful handling of denials with feedback

TypeScript SDK

JavaScript/TypeScript integration

API Integration

Direct REST API usage