openuba 0.0.2

OpenUBA CLI & SDK — install, run, and manage user behavior analytics models

OpenUBA

The official CLI and Python SDK for OpenUBA — an open-source User Behavior Analytics platform.

Installation

pip install openuba

CLI Usage

# Install a model from the registry
openuba install model_sklearn

# List available models
openuba list

# Run a model
openuba run model_sklearn --data path/to/data.csv

# Show version
openuba version

Python SDK Usage

import openuba

# Configure the client (or set OPENUBA_API_URL env var)
openuba.configure(api_url="http://localhost:8000")

# List available models
models = openuba.list_models()
for model in models:
    print(model["name"], model["version"])

# Install a model
openuba.install("model_sklearn")

# Run a model
results = openuba.run("model_sklearn", data="path/to/data.csv")
print(results)

Configuration

The SDK can be configured via environment variables:

Variable	Description	Default
OPENUBA_API_URL	OpenUBA API server URL	http://localhost:8000
OPENUBA_TOKEN	Authentication token	None

Or programmatically:

import openuba
openuba.configure(api_url="http://your-server:8000", token="your-token")

License

GNU General Public License v3.0 — see LICENSE.