> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://humanloop.com/docs/v5/sdk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://humanloop.com/docs/_mcp/server.

> Learn how to integrate Humanloop into your applications using our Python and TypeScript SDKs or REST API.

The Humanloop platform can be accessed through the [API](/docs/v5/api) or through our Python and TypeScript SDKs.

<Cards>
  <Card
    title="TypeScript ↗"
    icon="fa-brands fa-js"
    href="https://www.npmjs.com/package/humanloop"
  />
  <Card
    title="Python ↗"
    icon="fa-brands fa-python"
    href="https://pypi.org/project/humanloop/"
  />
  
</Cards>

### Usage Examples

<Tabs>

<Tab title="TypeScript">

**`Installation`**

```shell title="Installation"
npm install humanloop
```

**`Example usage`**

```typescript title="Example usage"
import { HumanloopClient } from "humanloop";

const humanloop = new HumanloopClient({ apiKey: "YOUR_API_KEY" });

// Check that the authentication was successful
console.log(await humanloop.prompts.list());
```

</Tab>

<Tab title="Python">

**`Installation`**

```shell title="Installation"
pip install humanloop
```

**`Example usage`**

```python title="Example usage"
from humanloop import Humanloop
hl = Humanloop(api_key="<YOUR Humanloop API KEY>")

# Check that the authentication was successful
print(hl.prompts.list())
```

</Tab>
</Tabs>

> Learn how to integrate Humanloop into your applications using our Python and TypeScript SDKs or REST API.

## Docs

- [Decorators Overview](https://humanloop.com/docs/sdk/decorators.md): Overview of the decorator system in the Humanloop SDK
- [Flow Decorator](https://humanloop.com/docs/sdk/decorators/flow.md): Technical reference for the Flow decorator in the Humanloop SDK
- [Prompt Decorator](https://humanloop.com/docs/sdk/decorators/prompt.md): Technical reference for the Prompt decorator in the Humanloop SDK
- [Tool Decorator](https://humanloop.com/docs/sdk/decorators/tool.md): Technical reference for the Tool decorator in the Humanloop SDK
- [Run Evaluation](https://humanloop.com/docs/sdk/run-evaluation.md): Getting up and running with Humanloop is quick and easy. This guide will explain how to set up evaluations on Humanloop and use them to iteratively improve your applications.