KumoRFM SDKEnvironment Setup

Cursor

View as Markdown
Cursor

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 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:

$mkdir my-kumo-project
$cd my-kumo-project

Open the folder in Cursor: File > Open Folder.

Step 2: Install KumoSDK

🖥 Terminal

$pip install kumoai

Verify installation:

1python -c "import kumoai; print(f'kumoai {kumoai.__version__} installed')"

Step 3: Authenticate

Set your API key:

🖥 Terminal

$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

$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

$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:

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

$pip install --upgrade kumoai

Upgrade the Kumo Coding Agent:

🖥 Terminal

$cd kumo-coding-agent && git pull

To pin to a specific version:

$cd kumo-coding-agent && git checkout v1.0.0

Troubleshooting

kumoai cannot be imported

$pip install kumoai

API key is missing

$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