floxoris 0.1.0

Async Python SDK for the Floxoris AI API gateway.

floxoris

Minimal async Python SDK for the Floxoris AI API gateway.

Install

pip install floxoris

Quickstart

import floxoris

floxoris.api_key = "ak-fs-..."

result = await floxoris.moderate("ти дебіл")
print(result.label)        # "toxic"
print(result.toxic_score)  # 0.89
print(result.safe_score)   # 0.10

Specify a model explicitly:

import floxoris

floxoris.api_key = "ak-fs-..."

result = await floxoris.moderate(
    "hello world",
    model="floxoris/harmony-v0",
)

Use the explicit client when you want to control connection lifecycle:

from floxoris import AsyncClient

async with AsyncClient(api_key="ak-fs-...") as client:
    result = await client.moderate("text here")

Configuration

Module-level configuration:

import floxoris

floxoris.api_key = "ak-fs-..."
floxoris.base_url = "https://floxoris.xyz"
floxoris.default_model = "floxoris/harmony-v0"

The SDK:

• sends Authorization: Bearer <api_key>
• retries once automatically on 5xx
• raises typed exceptions for auth, rate limit, and API failures

Response model

from dataclasses import dataclass


@dataclass
class ModerationResult:
    label: str
    class_id: int
    safe_score: float
    toxic_score: float
    latency_ms: float | None
    model: str

Exceptions

from floxoris import APIError, AuthError, FloxorisError, RateLimitError