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.35
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.35.tar.gz | 1.2 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cursor_sdk-1.0.35-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| cursor_sdk-1.0.35-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.35-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| cursor_sdk-1.0.35-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details |
| cursor_sdk-1.0.35-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 261.7 MB
Release files / cursor_sdk-1.0.35.tar.gz
| Download URL | cursor_sdk-1.0.35.tar.gz |
|---|---|
| Size | 1.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
499a9f7ccd094db45f6d4e1b791d4aaa2f04ee1cc9e4e002b91ad445509c36e5
|
|
BLAKE2b-256 checksum How to use checksums |
cb48466b50ea3f240870f4f2eb0053f0c2de2ddd5cd3262edaa394a8cb59b0b4
|
| 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.35-py3-none-win_amd64.whl
| Download URL | cursor_sdk-1.0.35-py3-none-win_amd64.whl |
|---|---|
| Size | 45.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
de906e1b02aa41dd661b54806b2ed72ca1ef8cc38742a3a2279cf1547b85bf13
|
|
BLAKE2b-256 checksum How to use checksums |
d52d13855b1c4154511001f7388ee3c29cfbbcf03fcf176156173fa2d2ab33d4
|
| 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.35-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | cursor_sdk-1.0.35-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 |
8c85394f3cc163777c1a97baee84b56a7f386c51552173833887dd1f2ead4370
|
|
BLAKE2b-256 checksum How to use checksums |
cbbca45dfc01512984eac9d680d943c5b0b0347543552aa89773d0f8ab62b6a0
|
| 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.35-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | cursor_sdk-1.0.35-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 |
dbab9b6dce790651518aea8dcf0345975f5b81ba255d150a53b6260547c318aa
|
|
BLAKE2b-256 checksum How to use checksums |
a3268c708d9d3e096499c0a1993eadf7750bd0a7173e7299f7876e787bd226f2
|
| 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.35-py3-none-macosx_11_0_x86_64.whl
| Download URL | cursor_sdk-1.0.35-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 |
68f0f605bb438ca39cb17bd17de71d23b39c121e8ceef4fcfff69d7d26f71ff1
|
|
BLAKE2b-256 checksum How to use checksums |
d42c5634c523160430bdf3880f23530933713fb37ffca5c4f60269ebecc85369
|
| 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.35-py3-none-macosx_11_0_arm64.whl
| Download URL | cursor_sdk-1.0.35-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 49.0 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
49eb52220fcfae1aba4bed8d1b397d9ae793662fe7345fce4403de4a992d8986
|
|
BLAKE2b-256 checksum How to use checksums |
4087fdd9731eead90399e51a051a7268eda6359796e26332a2109ed0c8e5bcf1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
