Skip to main content
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. A Kumo account and API key (Create)

​
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: 
python -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"    # from https://kumorfm.ai/api-keys

​
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