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).
No-repo cloud agents
Cloud agents can run on an empty VM with no repository. Pass cloud and leave
repos unset:
agent = client.agents.create(cloud=CloudAgentOptions(repos=[]))
No-repo agents must be enabled for your account or team, and repository-scoped
API keys cannot create them. See examples/no_repo_cloud_agent.py.
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.
Metadata
Release files for cursor-sdk 1.0.36
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cursor_sdk-1.0.36.tar.gz | 1.2 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cursor_sdk-1.0.36-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| cursor_sdk-1.0.36-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| cursor_sdk-1.0.36-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| cursor_sdk-1.0.36-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details |
| cursor_sdk-1.0.36-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 261.8 MB
Release files / cursor_sdk-1.0.36.tar.gz
| Download URL | cursor_sdk-1.0.36.tar.gz |
|---|---|
| Size | 1.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
620b9a5f65a7312077898e4c2015ddf7931f3817fec43601f0321eee03135ac6
|
|
BLAKE2b-256 checksum How to use checksums |
9d55c0aa2b2030bd4e91d778c8c9a37db1fff152f502b1a70a0af87380eb19a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
Release files / cursor_sdk-1.0.36-py3-none-win_amd64.whl
| Download URL | cursor_sdk-1.0.36-py3-none-win_amd64.whl |
|---|---|
| Size | 45.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
1b9323336c8088476c4c720179f25f9166c5045acd23b35ee6f94d931f533ff5
|
|
BLAKE2b-256 checksum How to use checksums |
eb6bcae174ab8ead8f15b126e4a23efe49a7ef5dfb70f773f31cd78807f17c42
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
Release files / cursor_sdk-1.0.36-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | cursor_sdk-1.0.36-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 58.9 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
311f0063015ee9d31e1d6f8a1d42d3b4e738ca9e40cacac94a3164681e49c5ec
|
|
BLAKE2b-256 checksum How to use checksums |
d6c3e32f95792e000c8c5a5f2f274f7511079b827d48e2a76a265fc1f0e286d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
Release files / cursor_sdk-1.0.36-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | cursor_sdk-1.0.36-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 58.2 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
79d57f7bedea1a506245569157c21412c9ea0205ec7a8549f4d63d924362b86f
|
|
BLAKE2b-256 checksum How to use checksums |
e5f18be53780ae5eca4d640c85655473edaa51cc81e5fa6b0030d65c16e6728d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
Release files / cursor_sdk-1.0.36-py3-none-macosx_11_0_x86_64.whl
| Download URL | cursor_sdk-1.0.36-py3-none-macosx_11_0_x86_64.whl |
|---|---|
| Size | 50.6 MB |
| Tags | Python 3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
3c91e29b616768e844d4a19d939c0a7949c13d3d66da6695b4a774f6a89ccd4b
|
|
BLAKE2b-256 checksum How to use checksums |
ea527c5c6e2a7ff7e53f97421b73f7f4d79f5310933ffb16d27a56eb007a548a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
Release files / cursor_sdk-1.0.36-py3-none-macosx_11_0_arm64.whl
| Download URL | cursor_sdk-1.0.36-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 49.1 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
77e568054d9721a7d4f18f3ff20fd7f44f11a86f7aade438024b1faf112048b4
|
|
BLAKE2b-256 checksum How to use checksums |
d1965be53907bcf333ec88f966cc4c3146142382ac1b2bfa51811b7836576aef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
