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.32
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.32.tar.gz | 1.2 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cursor_sdk-1.0.32-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| cursor_sdk-1.0.32-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.32-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| cursor_sdk-1.0.32-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details |
| cursor_sdk-1.0.32-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 261.5 MB
Release files / cursor_sdk-1.0.32.tar.gz
| Download URL | cursor_sdk-1.0.32.tar.gz |
|---|---|
| Size | 1.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c02442ff190c804dac0061587d616226721d23bdea2e87592331df368f6f4a88
|
|
BLAKE2b-256 checksum How to use checksums |
1427f018b131088f5053bc89f50d22d414fd0f92f418ce465b0de6609bf5d7d1
|
| 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.32-py3-none-win_amd64.whl
| Download URL | cursor_sdk-1.0.32-py3-none-win_amd64.whl |
|---|---|
| Size | 45.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
a92ac2c82f340631b21c005ef2d622d9a60c605224bc4fd13ffc08ae80440ba9
|
|
BLAKE2b-256 checksum How to use checksums |
9aca473c26bc1e2dbae52eac857cba012174e83025fddacab4c5548d67392da3
|
| 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.32-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | cursor_sdk-1.0.32-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 |
c90a458b86d76ab9e0c1eb8590f6da728c48af330d14adc834a158013b448a92
|
|
BLAKE2b-256 checksum How to use checksums |
2a4d68b6e075d30191eefffd7707ed42a8eebdf0e82a2b1080a1463c603609da
|
| 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.32-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | cursor_sdk-1.0.32-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 |
77ec88589a76137febabf8787713e6167c7a2c359049c4d23a6aa355aed69f19
|
|
BLAKE2b-256 checksum How to use checksums |
11a284db69794aadfabdbf5ed5b45ebf1237e4183b9ac5b48a71cc23d953ed1f
|
| 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.32-py3-none-macosx_11_0_x86_64.whl
| Download URL | cursor_sdk-1.0.32-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 |
e0d28fb4f477128771733d1006e9e3d012c0f7bd238a1d44baf90d20790cb763
|
|
BLAKE2b-256 checksum How to use checksums |
5bde69f1c0d5dda3b57a190f9d17e370b688a4f853599de7980e4e9917c9f443
|
| 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.32-py3-none-macosx_11_0_arm64.whl
| Download URL | cursor_sdk-1.0.32-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 |
8d604fcfd9269ec0682a5775b4679427eb5ca53ce3f4c2e295554dede40a3184
|
|
BLAKE2b-256 checksum How to use checksums |
6147aee9bb9247606bc7be06416250922bab320ae1db75ace8d94e2b20553f1e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
