cursor-sdk
Python SDK for Cursor agents — script the same agent that runs in the Cursor IDE, CLI, and web app, with sync and async clients.
Docs and quickstart: https://cursor.com/docs/sdk/python
Shared SDK version
Starting with 1.0.24, the Python package and @cursor/sdk use the same
version and are built from the same commit. Python therefore jumps directly
from 0.1.9 to 1.0.24; there are no missing Python releases in between.
The alignment does not change the Python SDK's public-beta status.
Install
pip install cursor-sdk
Requires Python 3.10+. Wheels are published for macOS (arm64, x64), Linux (arm64, x64), and Windows (x64).
For cloud agents, agent.get_usage() returns billed token usage and dollar
cost per run. Cost is server-derived from Cursor's billing pipeline
(discounts included, never estimated client-side) and eventually consistent
shortly after a run ends. Local agents are not supported yet.
Public beta. APIs may change before general availability.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cursor_sdk-1.0.27.tar.gz.
File metadata
- Download URL: cursor_sdk-1.0.27.tar.gz
- Upload date:
- Size: 1.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ad1647030dec45723ad571facc978cda78afa68600306ba1c073fcfadf5ea9a4
|
|
| MD5 |
de8ced2613620c32d88614577a0c7b43
|
|
| BLAKE2b-256 |
7de33dc4b4575948206cecb7f8bfdba972c14812a32a09a4c668f23db56f9b15
|
File details
Details for the file cursor_sdk-1.0.27-py3-none-win_amd64.whl.
File metadata
- Download URL: cursor_sdk-1.0.27-py3-none-win_amd64.whl
- Upload date:
- Size: 44.2 MB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bdbf02d102966e23be10dfd491f0f07944331a17b76239ac23f702b515e7e319
|
|
| MD5 |
e06935a77d8fc0992f2b997411417f4a
|
|
| BLAKE2b-256 |
c05ed8ac84432f4a709b7d1d748b0615dd88f7b51253d73305ab764b584ff173
|
File details
Details for the file cursor_sdk-1.0.27-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.
File metadata
- Download URL: cursor_sdk-1.0.27-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
- Upload date:
- Size: 57.9 MB
- Tags: Python 3, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c9a960fceb006349ff40f2499c5be4c5603487cbacbb865d3025c02867524317
|
|
| MD5 |
7f8501a716f85c89ed309e1986cf3794
|
|
| BLAKE2b-256 |
b95d63f909f74acbb2c4becdf824d3bce393220b643a422c93307c217158ab8b
|
File details
Details for the file cursor_sdk-1.0.27-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl.
File metadata
- Download URL: cursor_sdk-1.0.27-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
- Upload date:
- Size: 57.2 MB
- Tags: Python 3, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
678c05953adf34826a261e0d3bb12e088f49f8d3321d33ffbc490a865a89e042
|
|
| MD5 |
fbd914009c20ac17f9eabcc001e383f3
|
|
| BLAKE2b-256 |
a51be5a7befd1ec96e34cc50fd61c3bf8280eddceb28e3b8bb892144057859a8
|
File details
Details for the file cursor_sdk-1.0.27-py3-none-macosx_11_0_x86_64.whl.
File metadata
- Download URL: cursor_sdk-1.0.27-py3-none-macosx_11_0_x86_64.whl
- Upload date:
- Size: 49.6 MB
- Tags: Python 3, macOS 11.0+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f92cea918e460b45f2abcb8663fc2a2aab837eac3ee6b955af3b5d6a07a4ac4b
|
|
| MD5 |
2b90627878640ba159946e39e542e58d
|
|
| BLAKE2b-256 |
173e8fea3e8120b0177caeaea5b2e8c107e59f465705b4f187b13c1f0bce6980
|
File details
Details for the file cursor_sdk-1.0.27-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: cursor_sdk-1.0.27-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 48.1 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ee845c19a2dac77764610cc0911aedcba71b93ef99b2511bd4e764593b745dfe
|
|
| MD5 |
d1810122c6cbb3706881afe4f36cc9bd
|
|
| BLAKE2b-256 |
7d891dee9c6947234e6fb8d76108ba4841314811d0ab790859c09ed59d9fabfb
|
