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.34
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.34.tar.gz | 1.2 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cursor_sdk-1.0.34-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| cursor_sdk-1.0.34-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.34-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| cursor_sdk-1.0.34-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details |
| cursor_sdk-1.0.34-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 261.6 MB
Release files / cursor_sdk-1.0.34.tar.gz
| Download URL | cursor_sdk-1.0.34.tar.gz |
|---|---|
| Size | 1.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7ac9040725e40bd893b3d613034c4e7dd2a7ac20a882355dcc17b4b379be5e58
|
|
BLAKE2b-256 checksum How to use checksums |
ef90d1c10dcb23c9a85891e39688988e20ddf1678bd0c08333d94737adabe2c6
|
| 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.34-py3-none-win_amd64.whl
| Download URL | cursor_sdk-1.0.34-py3-none-win_amd64.whl |
|---|---|
| Size | 45.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8ba840fe1ae925fe98b99b1499322e33d0fbd9fce1fd31a41239658410dca17c
|
|
BLAKE2b-256 checksum How to use checksums |
25069c3647d28af037f961936858b7c943f82a6f7e2e338158480ba2f2ec70e3
|
| 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.34-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | cursor_sdk-1.0.34-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 58.8 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
0fd9a251c6afcd7dab2f828bd51590ef59b37ae7f7496336f03e1bba57f53dd3
|
|
BLAKE2b-256 checksum How to use checksums |
7beca5f90d788274db76d89d3044ad48f9f3c52d02af8bbbe5276bb783ae3d2a
|
| 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.34-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | cursor_sdk-1.0.34-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 58.1 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
532cac9ceb607ef3ad9099ccfa599991cc2c22a3f111afab3fd100d6682c3db9
|
|
BLAKE2b-256 checksum How to use checksums |
5dd327e54ce34f76cd217f479077878ca1e7475b52da9145f0584145eded2df0
|
| 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.34-py3-none-macosx_11_0_x86_64.whl
| Download URL | cursor_sdk-1.0.34-py3-none-macosx_11_0_x86_64.whl |
|---|---|
| Size | 50.5 MB |
| Tags | Python 3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
5ec9891d65fd458290cb7cf7a7c28a32a5bf833f3f2ef8101086dc0bb6286e84
|
|
BLAKE2b-256 checksum How to use checksums |
55fe8ac83851e88059eb639279dfaf92babe5fcdfddc2f642c6e5efe82b132de
|
| 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.34-py3-none-macosx_11_0_arm64.whl
| Download URL | cursor_sdk-1.0.34-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 |
4d314bc30cfca120f1ea171f033938cd7c1d21cc224cbe221da68fbdb7625f49
|
|
BLAKE2b-256 checksum How to use checksums |
60b57f6d324bcd3a8c0aeb4ecd86dfbb728bdb0c2da99c6a577872d9b41abbb5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
