---
title: "SDKs"
description: "Official TypeScript and Python clients for the Rumoro API, or generate one from the OpenAPI document."
canonical: https://docs.rumoro.dev/sdks
markdown: https://docs.rumoro.dev/sdks.mdx
---

# SDKs

Official TypeScript and Python clients for the Rumoro API, or generate one from the OpenAPI document.

Rumoro has official clients for TypeScript and Python. Both are generated from the [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) that the [API reference](/api) is built from. Each endpoint is one call with the same name, and requests and responses are typed. You need an [API key](/authentication).

| Language | Package | Install |
| --- | --- | --- |
| TypeScript | [`@rumoro-dev/sdk`](https://www.npmjs.com/package/@rumoro-dev/sdk) | `npm install @rumoro-dev/sdk` |
| Python | [`rumoro`](https://pypi.org/project/rumoro/) | `pip install rumoro` |

The [TypeScript](/sdks/typescript) and [Python](/sdks/python) guides cover the first call, errors, paging and async use.

## Other languages

For Go, Java, Ruby, PHP, .NET, Rust or anything else, you have three options.

1. **Use the [CLI](/cli).** Each endpoint is a `rumoro` command that prints JSON. Any language that can start a process can call it, for example `rumoro mentions:search --relevant true | your-script`.
2. **Call the API directly.** It uses a Bearer key, JSON requests and responses, one error format and camelCase field names. [Conventions](/conventions) explains it all on one page.
3. **Generate your own client.** Run [OpenAPI Generator](https://openapi-generator.tech) or [Kiota](https://learn.microsoft.com/openapi/kiota/) on `https://api.rumoro.dev/v1/openapi.json`. Each operation id becomes a method, and each tag a group.

## Versions

When the API changes, both clients and the CLI are generated again from the OpenAPI document and released together. The [changelog](/changelog) says what changed.

<Cards>
  <Card icon="Terminal" title="CLI" description="Run any endpoint from your terminal, or stream new mentions." href="/cli" />
  <Card icon="Sparkles" title="MCP server" description="Let AI agents use Rumoro as tools." href="/mcp" />
  <Card icon="ShieldCheck" title="Authentication" description="Keys, read and write scopes, and OAuth." href="/authentication" />
  <Card icon="TriangleAlert" title="Errors" description="The error format, every code, and when to retry." href="/errors" />
</Cards>