Xovis SDK

Welcome to the xovis-sdk documentation. This is an enterprise-grade, high-performance Python SDK designed to intercept, parse, and normalize data from Xovis 3D stereo-vision sensors and orchestrate fleets via the Xovis HUB Cloud.

Compliance Note

This project is an independent, open-source initiative. It is not officially affiliated with, maintained by, or endorsed by Xovis AG.

Key Features

• Quadrifurcated Architecture: Separation of Data, Control, State, and Agentic planes.
• Zero-Copy Telemetry: High-speed Live-Push (up to 12.5Hz) ingestion with binary packing.
• Fleet Orchestration: Resilient bulk operations via Xovis HUB Cloud.
• Topology Awareness: Automatic resolution of physical vs. virtual sensor contexts via Top-Down Synthesis and 3-Tier ARP/L2 network discovery fallback.
• AI-Ready: Native toolkits for OpenAI, Anthropic, LangGraph, and Model Context Protocol (MCP) support.

AI & Autonomous Agents

The Xovis SDK is built for the agentic era. It transforms hardware into "Live Resource Providers" for AI:

• Universal Tool Adapter: Projects SDK methods as strictly validated tools for GPT-5.5 and latest Anthropic models. See Agentic Layer.
• MCP Server: Native integration for Cursor, Windsurf, and Claude Desktop. Explore MCP Integration.
• Safety Guardrails: Human-in-the-loop confirmation for high-impact operations and 350-device safety thresholds for fleet operations.
• Documentation Excellence: >75% docstring coverage with strict Google-style enforcement.

Explore the AI & Agents Guide for a deep dive into skills and toolsets.

Installation & Setup

The Xovis SDK is modular. Choose the installation that fits your deployment:

1. Standard Installation

Core SDK for local sensor interaction and cloud orchestration.

pip install xovis-sdk

2. High-Performance (Recommended for Linux/macOS)

Includes uvloop for maximum socket throughput in the Data Plane. On Windows, the SDK automatically utilizes the high-performance ProactorEventLoopPolicy.

pip install "xovis-sdk[uvloop]"

3. Full Mission Control (TUI & AI)

Includes the terminal interface (TUI) and AI Agentic Layer dependencies.

pip install "xovis-sdk[tui,ai]"

Quick Start: CLI Mission Control

Launch your environment in seconds using the built-in CLI.

1. Warmup: Synchronize schemas from your sensor.

   xovis-cli warmup <SENSOR_IP>
   

2. Type Generation: Create strict Python types for your IDE.

   xovis-cli generate-types
   

3. Launch Terminal: Open the interactive dashboard.

   xovis-cli ui
   

For advanced orchestration and fleet-wide commands, see the CLI Reference & TUI Guide.

Next Steps

Dive straight into the API Reference for more.