---
title: SDK overview
description: Reference for consuming deployed Flue agents and workflows with @flue/sdk.
lastReviewedAt: 2026-06-20
---

The client SDK is exported from `@flue/sdk`. Use it from applications that consume deployed Flue agents and workflows.

```ts
import { createFlueClient } from '@flue/sdk';

const client = createFlueClient({
  baseUrl: 'https://example.com/api',
  token: process.env.FLUE_TOKEN,
});
```

## Client

[`createFlueClient(...)`](/docs/sdk/client/) configures access to a deployed Flue application.

## API namespaces

- [`client.agents`](/docs/sdk/agents/) invokes persistent agent instances and streams their events.
- [`client.workflows`](/docs/sdk/workflows/) starts workflow runs.
- [`client.runs`](/docs/sdk/runs/) inspects and streams runs exposed by their owning workflows.

Deployment-wide listing (all runs, all agents) is a server-side concern: compose your own endpoints from the `listRuns()`, `getRun()`, and `listAgents()` primitives exported by `@flue/runtime`. See [compose your own admin endpoints](/docs/api/routing-api/#compose-your-own-admin-endpoints).

## Shared types

- [Events and records](/docs/sdk/events/) describes observable events, records, and normalized model-turn data.
- [Errors](/docs/sdk/errors/) describes HTTP and stream errors.