Skip to content
Intura

Get started

Quickstart

Install intura-ai, create a download key, then load a model you own and run your first prediction on your own CPU.

Install

bash
pip install intura-ai
# or
uv add intura-ai

The package supports Python 3.10 to 3.13. It installs everything a prediction needs: onnxruntime (CPU), tokenizers, numpy, and httpx for the download. The old local extra still resolves, so pip install "intura-ai[local]" keeps working, but it adds nothing.

Get a model and a download key

  1. Get a model from the model catalogue. Buying a model once gets you every version of it.
  2. Create a download key on your account page. The key is shown once, so copy it then.
  3. Give it to the SDK in INTURA_API_KEY:
bash
export INTURA_API_KEY=sk_...

See Download keys for the other ways to pass it, and for when you don't need one.

Load a model, then predict

python
from intura_ai import Intura

client = Intura()                  # reads INTURA_API_KEY
model = client.models.load("chat-commerce-intent-id")

model.predict("kak, paket saya kok belum sampai ya?")
# {'label': 'shipping', 'score': 0.996}

The first load downloads the model into a local cache. After that it loads from disk in well under a second, with no network call and no key. Load once per process and keep the model.

A model that finds personal data returns spans instead of a label:

python
model = client.models.load("guardrails-pii-detection-id")
model.predict("Nama saya Budi Santoso, NIK 3171234567890001")
# [{'type': 'PERSON', 'start': 10, 'end': 22, 'value': 'Budi Santoso'},
#  {'type': 'NATIONAL_ID', 'start': 28, 'end': 44, 'value': '3171234567890001'}]

What predict returns depends on the model's decision rule. Load and predict has all five.

Try it from a shell

The package also installs an intura-ai command:

bash
intura-ai library                                     # what your account owns
intura-ai predict chat-commerce-intent-id "kak, paket saya kok belum sampai ya?"

The Command line page has every command and flag.

Next