Orq SDKs

Install and configure the official Orq.ai SDKs for Python and Node.js. Authenticate with your API key and start making API calls in minutes.

We recommend to use our official client libraries to interact with the orq.ai API.

Github

Our SDKs are available on Github:

Node.js

Get started with our Node.js SDK

Python

Get started with our Python SDK

Installation

Bash

# The SDK can be installed with either pip or poetry package managers.
# PIP

pip install orq-ai-sdk

# Poetry

poetry add orq-ai-sdk

Usage

To get your workspace API Keys, see API Keys.

Initialize the orq.ai client with your API key:

Python

import os

from orq_ai_sdk import Orq

client = Orq(
	 api_key=os.environ.get("ORQ_API_KEY", "__API_KEY__"),
 	 environment="production",
   # optionally initiate the identity_id for the session
   identity_id=2025
)

If environment is provided in the SDK initialization, it will be set as the global environment for every request to Deployments Invoke, Get config, and Retrieve a remote config even if the context contains an environment property.

Deployments

The Deployments API delivers text outputs, images, or tool calls based on the configuration established within orq.ai for your deployments. Additionally, this API supports streaming. It is highly recommended that you use the code snippets from the orq.ai Organization panel to ensure ease of use and minimize errors.

Invoke a deployment

invoke()

Python

generation = client.deployments.invoke(
    key="customer_service",
    context={"environments": "production", "country": "NLD"},
    inputs={"firstname": "John", "city": "New York"},
    metadata={"customer_id": "Qwtqwty90281"},
)

print(generation.choices[0].message.content)

Learn more about Invoke() reading the Python and Node.js docs.

Deployments can also be streamed:

• using stream() with the Python SDK
• using stream() with the Node.js

Read more about using the SDK to interact with the Deployments API with Python and Node.js.

Other Resources and Operations

Read more on the Github SDK Documentation for all Resources and Operations:

All available Resources and Operations for Python

All available Resources and Operations for Node.js