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.39
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| cursor_sdk-1.0.39.tar.gz | 1.2 kB | Without provenance | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cursor_sdk-1.0.39-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| cursor_sdk-1.0.39-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.39-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| cursor_sdk-1.0.39-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details |
| cursor_sdk-1.0.39-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 267.0 MB
Release files / cursor_sdk-1.0.39.tar.gz
| Download URL | cursor_sdk-1.0.39.tar.gz |
|---|---|
| Size | 1.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
676e3af7daf6b916618f8f2d9609920fd9c94556abc87934ea2c57f2e880b125
|
|
BLAKE2b-256 checksum How to use checksums |
2387ea29b1e0ab3ec025660d7c77b725a6a12b92fadd9bd21cf3613fd8492000
|
| 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.39-py3-none-win_amd64.whl
| Download URL | cursor_sdk-1.0.39-py3-none-win_amd64.whl |
|---|---|
| Size | 46.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
dd6024ef26c5a5bbf121520d192a6539e8f9d7edb6cce0f39659583a4dd84cb7
|
|
BLAKE2b-256 checksum How to use checksums |
8142932f6124ffcd4db214369c948a10c8a36b783481a87c679bdf105ef71115
|
| 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.39-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | cursor_sdk-1.0.39-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 60.0 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
d2dbb0aba42f921e4ea46770b64ca85fb0b3f344d1392691e989dcbeca4c2e4f
|
|
BLAKE2b-256 checksum How to use checksums |
90f8db80b45970be67cf22940775ad4885b225717bfc7e52196ce6a572e114ba
|
| 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.39-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | cursor_sdk-1.0.39-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 59.4 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
94b02cbe6d962f2fbc9a4fb084a9805411f33ab245983017cac1f6a89bbc2c9b
|
|
BLAKE2b-256 checksum How to use checksums |
ca36a2c98e70547102e9c6c1e974c8b81ba582f6c8ac71e6a73c0c9da1b623c0
|
| 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.39-py3-none-macosx_11_0_x86_64.whl
| Download URL | cursor_sdk-1.0.39-py3-none-macosx_11_0_x86_64.whl |
|---|---|
| Size | 51.5 MB |
| Tags | Python 3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
c34726838f284d67790d21f9214169fee27516355c9b8855677e48e3ab972f75
|
|
BLAKE2b-256 checksum How to use checksums |
1a3973581b4a3588a45cf244de8f07442a2aaa3fb508b5ce520440ec9ce016d8
|
| 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.39-py3-none-macosx_11_0_arm64.whl
| Download URL | cursor_sdk-1.0.39-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 50.0 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
e3320ece5bcd2821c599f7a00ca53b75133c0e758746d20eff7edd0f79893c11
|
|
BLAKE2b-256 checksum How to use checksums |
9324c64d24bc03a9ab7a15272156e4f0a8324bc7b3d18ec029702660fa3cdca4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
Security for cursor-sdk 1.0.39
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
