> ## Documentation Index
> Fetch the complete documentation index at: https://kumo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Use Cursor with the Kumo RFM SDK

<img src="https://mintcdn.com/kumoai/sauZu1594eNyXDA7/images/rfm/agent-cursor.svg?fit=max&auto=format&n=sauZu1594eNyXDA7&q=85&s=ac3e930cdf768d77177eefa22571e6c5" alt="Cursor" style={{height: "100px", width: "auto"}} width="800" height="195" data-path="images/rfm/agent-cursor.svg" />

## Overview

This guide walks you through setting up the **KumoSDK** and **Kumo Coding Agent** in **Cursor**. It covers installation, authentication, agent setup, and a first prediction example.

## Prerequisites

Make sure you have:

1. Cursor installed and set up. See the [official Cursor docs](https://cursor.com/en-US/docs) for installation.
2. Python **3.10 to 3.13** installed
3. Access to a KumoRFM environment, including an API key and any required API URL

## Step 1: Create a Project

Create or open a project directory:

```bash theme={null}
mkdir my-kumo-project
cd my-kumo-project
```

Open the folder in Cursor: **File > Open Folder**.

## Step 2: Install KumoSDK

`🖥 Terminal`

```bash theme={null}
pip install kumoai
```

Verify installation:

```python theme={null}
python -c "import kumoai; print(f'kumoai {kumoai.__version__} installed')"
```

## Step 3: Authenticate

Set your API key:

`🖥 Terminal`

```bash theme={null}
export KUMO_API_KEY="YOUR_API_KEY_HERE"
```

## Step 4: Install Kumo Coding Agent

The Kumo Coding Agent has two parts:

* **Context** (knowledge base): Documentation, PQL rules, workflow guides, and data connector references that teach the agent how to use the Kumo platform. Installed by cloning the repository.
* **Skills** (slash commands): Actions like `/kumo-issue` and `/kumo-pr` for reporting bugs and contributing fixes. Installed via `npx skills add`.

**Install the context:**

`🖥 Terminal`

```bash theme={null}
git clone https://github.com/kumo-ai/kumo-coding-agent.git kumo-coding-agent
```

Cursor reads `.cursor/rules/` automatically. No extra configuration needed.

**Install the skills (optional):**

`🖥 Terminal`

```bash theme={null}
npx skills add kumo-ai/kumo-coding-agent --agent cursor
```

## Step 5: Use the Kumo Coding Agent

Open the Cursor chat and try a real prediction:

```text theme={null}
Load the RelBench F1 dataset and predict whether each driver will finish in the top 3 in the next race
```

The agent will inspect the data, build a graph, write PQL, and run the prediction end-to-end.

## Step 6 (Optional): Upgrade

**Upgrade KumoSDK:**

`🖥 Terminal`

```bash theme={null}
pip install --upgrade kumoai
```

**Upgrade the Kumo Coding Agent:**

`🖥 Terminal`

```bash theme={null}
cd kumo-coding-agent && git pull
```

To pin to a specific version:

```bash theme={null}
cd kumo-coding-agent && git checkout v1.0.0
```

## Troubleshooting

### `kumoai` cannot be imported

```bash theme={null}
pip install kumoai
```

### API key is missing

```bash theme={null}
export KUMO_API_KEY="YOUR_API_KEY_HERE"
```

### Agent does not respond with Kumo knowledge

* Verify `kumo-coding-agent/` exists in your project directory
* Verify `kumo-coding-agent/.cursor/rules/` contains `kumo-coding-agent.mdc`
* Restart Cursor

## Next Steps

* [Setup](/rfm/sdk-getting-started) for SDK fundamentals
* [Make Predictions](/rfm/make-predictions) for PQL query reference
* [Kumo Coding Agent](https://github.com/kumo-ai/kumo-coding-agent) for agent source and skills