sentinos-sdk-core (Python)

Low-level generated Python client for the Sentinos API. Choose sentinos-sdk-core when you want direct OpenAPI coverage, typed models, and full control over HTTP behavior.

Most teams should install sentinos instead. The higher-level wrapper adds curated helpers, runtime integrations, and a simpler onboarding path on top of this generated client.

Choose this package if...

• You want the raw generated client for custom automation or framework integration
• You need access to the full typed API surface without higher-level abstractions
• You care about sync and async entry points for every endpoint
• You want to build your own retry, logging, or instrumentation layer around the HTTP client

Install

pip install sentinos-sdk-core

Configure

export SENTINOS_API_URL="https://api.sentinos.ai"
export SENTINOS_ACCESS_TOKEN="<access-token>"

Then create an authenticated client:

import os

from sentinos_core import AuthenticatedClient

client = AuthenticatedClient(
    base_url=os.environ.get("SENTINOS_API_URL", "https://api.sentinos.ai"),
    token=os.environ["SENTINOS_ACCESS_TOKEN"],
)

Example: inspect and replay a decision trace

from uuid import UUID

from sentinos_core.api.default import trace_get, trace_replay
from sentinos_core.models.trace_replay_body import TraceReplayBody

trace_id = UUID("11111111-1111-1111-1111-111111111111")

trace = trace_get.sync(client=client, trace_id=trace_id)
print(trace.trace_id, trace.policy_evaluation.decision.value)

replay = trace_replay.sync(
    client=client,
    trace_id=trace_id,
    body=TraceReplayBody(include_explain=True),
)
print(replay.drift_detected, replay.replayed_at.isoformat())

Async uses the matching asyncio(...) entry points:

import asyncio

async def main() -> None:
    trace = await trace_get.asyncio(client=client, trace_id=trace_id)
    print(trace.trace_id)

asyncio.run(main())

Generated client ergonomics

Every endpoint module exposes four call styles:

• sync(...) for the parsed model
• sync_detailed(...) for parsed data plus HTTP metadata
• asyncio(...) for async codebases
• asyncio_detailed(...) for async metadata access

Models live under sentinos_core.models.*, and the underlying AuthenticatedClient exposes its shared httpx clients so you can attach hooks, logging, or custom transport settings.

Resources

• Sentinos SDK docs
• PyPI: sentinos-sdk-core
• PyPI: sentinos