SDKs and Client Libraries

Ottili provides official SDKs and client libraries so you can build on the platform from code instead of clicking through the dashboard. This page lists only the SDKs that are maintained in the repository today or are planned on the public roadmap. It does not list packages that are not real.

Current SDKs

Ottili ONE Developer SDK (Python)

The official client library for the public Ottili Developer API. Use it to discover modules, check capabilities, manage workspaces, and issue developer API keys from Python. This is the current Ottili SDK for API access.

• Language*: Python 3.8+
• Package*: ottili-sdk
• Version*: 1.0.0
• Status*: Maintained · Beta
• Source*: libs/ottili_sdk/

Installation (from source)*

The package is not yet published to PyPI. Install it from the monorepo source:

git clone https://github.com/ottili/ottili-one.git
cd ottili-one/libs/ottili_sdk
pip install -e .

Example*

from ottili_sdk import OttiliClient

client = OttiliClient(
    base_url="https://api.ottilione.com",
    api_key="ott_your_api_key_here",
)

for module in client.list_modules().items:
    print(f"{module.name}: {module.description}")

client.close()

See libs/ottili_sdk/examples/ for complete module-discovery, API-key-management, and async workflows.

Ottili Module SDK (TypeScript)

A scaffolding and authoring toolkit for building platform-compliant modules, with CLI generators, validation, and TypeScript types.

• Language*: TypeScript / Node.js 18+
• Package*: ottili-module-sdk
• Version*: 1.0.0
• Status*: Maintained · source-available
• Source*: ottili-module-sdk/

Installation (from source)*

The package is not yet published to npm. Build and run it from the monorepo source:

git clone https://github.com/ottili/ottili-one.git
cd ottili-one/ottili-module-sdk
npm install
npm run build

Example*

# Scaffold a new module from the built CLI
node dist/cli.js create-ottili-module my-module --category integration

Ottili Module SDK (Python)

A module-authoring toolkit used inside the monorepo to build and validate platform modules: base adapter classes, manifest handling, contract validation, and a watch mode for local development.

• Language*: Python 3.10+
• Package*: source only (no public package)
• Version*: tracked in-repo
• Status*: Maintained · source-available
• Source*: libs/ottili_module_sdk/

Example*

# From the monorepo root
python -m libs.ottili_module_sdk --help

Planned SDKs

Ottili ONE Developer SDK (TypeScript)

A TypeScript client for the public Developer API, mirroring the Python SDK, is planned. It is not available yet; track it on the public roadmap.

How to choose

• Building an integration that calls the platform API from your backend? Use the Ottili ONE Developer SDK (Python)* — the current Ottili SDK.
• Building a new platform module or add-on? Use the Ottili Module SDK* (TypeScript or Python).
• Need a language we do not ship yet? Call the public Developer API directly over HTTPS; the Python SDK documents the request and response shapes.

Related

• [What is Ottili ONE](/docs/what-is-ottili-one)
• [Getting started with Ottili ONE](/docs/getting-started-with-ottili-one)
• [Cloud APIs](/docs/cloud-apis)