SDKs

Official Flowra SDKs wrap the public API-key surface (the same operations as the API reference). Use them from your backend instead of hand-writing HTTP for common flows.

Package	Language	Notes
`@flowra/sdk`	TypeScript / Node 18+	OpenAPI-generated client + product facade
`flowra`	Python 3.10+	Hand-written facade (stdlib HTTP, no extra deps)

When to use the SDK vs MCP vs curl

Approach	Use when
SDK	Your app/backend calls Flowra (list tools, run workflows, manage skills, knowledge, MCP servers, …)
MCP	An IDE or agent runtime (Cursor, Claude Desktop) should discover and call tools — see MCP
HTTP / curl	Quick checks, languages without an SDK yet — Quickstart and API reference

The SDKs are not a Composio-style agent framework. For agent-side tool access, prefer MCP.

Install

TypeScript

npm install @flowra/sdk
# or: pnpm add @flowra/sdk

If the package is not on the registry yet, install from the Flowra monorepo: sdks/typescript (build with pnpm build). Python

pip install flowra
# or from the monorepo:
pip install -e sdks/python

Authenticate

Both clients send your project API key as x-api-key. Optionally set an external user with username / x-username for multi-tenancy.

import { Flowra } from '@flowra/sdk';

const flowra = new Flowra({
  apiKey: process.env.FLOWRA_API_KEY!,
  // username: 'customer_alice', // optional
  // baseUrl: 'https://flowra.dev', // default
});

from flowra import Flowra

flowra = Flowra(api_key="...", username="customer_alice")  # username optional

Create keys in the dashboard — Authentication.

Namespaces

High-level helpers cover the main product areas (names may use camelCase in TypeScript and snake_case in Python): tools, toolkits, skills, workflows, connections, authConfigs / auth_configs, users, triggers, chat, files, knowledge, database, sandbox, mcp, llm, browser Anything not wrapped on the facade is still available:

TypeScript: flowra.raw (generated OpenAPI operations)
Python: flowra.request(method, path, ...)

Tutorials

TypeScript SDK

Install, list tools, run a workflow, skills, and raw client.

Python SDK

Install, list tools, run a workflow, as_user, and escape hatch.

Quickstart — First curl request
API reference — Full HTTP schemas
Multi-tenancy — x-username scoping
MCP — Agent / IDE integration

Getting started

Core building blocks

Data and runtime

Integrate and scale

Recipes

Native tools

Contributing

When to use the SDK vs MCP vs curl

Install

Authenticate

Namespaces

Tutorials

TypeScript SDK

Python SDK

​When to use the SDK vs MCP vs curl

​Install

​Authenticate

​Namespaces

​Tutorials

TypeScript SDK

Python SDK

​Related

When to use the SDK vs MCP vs curl

Install

Authenticate

Namespaces

Tutorials

Related