riven-sdk

Official SDKs for the Riven API — an OpenAI-compatible chat completions gateway plus the Computer API for longer-running agentic tasks (research, synthesis, planning, council, and quick probes).

This monorepo contains:

• python/ — the riven package (PyPI: riven-sdk)
• javascript/ — the @rivenai/sdk package (npm)

Install

Python:

pip install riven-sdk

The PyPI distribution is named riven-sdk; the importable module is riven.

from riven import Riven

JavaScript / TypeScript:

npm install @rivenai/sdk

Quickstart

Python:

from riven import Riven

client = Riven()  # reads RIVEN_API_KEY from the environment
resp = client.chat.completions.create(
    model="rvn-assistant-v2",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp["choices"][0]["message"]["content"])

JavaScript / TypeScript:

import { Riven } from "@rivenai/sdk";

const riven = new Riven(); // reads RIVEN_API_KEY from the environment
const resp = await riven.chat.completions.create({
  model: "rvn-assistant-v2",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);

Both SDKs also expose the Computer API for agentic tasks:

task = client.computer.tasks.create(
    title="Competitive landscape",
    prompt="Summarize the top 3 competitors in the observability space.",
    kind="research",
)
client.computer.tasks.run(task["id"])

Authentication

Both SDKs read your API key from the RIVEN_API_KEY environment variable by default, or accept it directly in the constructor. Keys are issued from your Riven account and are prefixed rvn_.

export RIVEN_API_KEY=rvn_...

Documentation

Full API reference, guides, and model catalog: docs.rivenai.io

For runnable end-to-end examples, see riven-cookbook.

Package details

Package	Language	Registry	Version
riven-sdk (riven)	Python 3.9+	PyPI	0.1.0
@rivenai/sdk	TypeScript / Node 18+	npm	0.1.0

License

MIT © 2026 RivenAI. See LICENSE.