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.37
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.37.tar.gz | 1.2 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cursor_sdk-1.0.37-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| cursor_sdk-1.0.37-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.37-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| cursor_sdk-1.0.37-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details |
| cursor_sdk-1.0.37-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 262.7 MB
Release files / cursor_sdk-1.0.37.tar.gz
| Download URL | cursor_sdk-1.0.37.tar.gz |
|---|---|
| Size | 1.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
475aa1013977e5b6f318fd48afbc5886f6b23b9ba78e837caf447523957c0d7d
|
|
BLAKE2b-256 checksum How to use checksums |
717b4cba50f7cb816608ded196696efe0959fc91e58178a5666122509db48e33
|
| 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.37-py3-none-win_amd64.whl
| Download URL | cursor_sdk-1.0.37-py3-none-win_amd64.whl |
|---|---|
| Size | 45.2 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
90c03382c5193c7988d1b901d5c8415f0eb57d9017857b2997842b4f115a7ca9
|
|
BLAKE2b-256 checksum How to use checksums |
b21270f7398bec1de38e4dbaa774cc27365013b0ee4fc0d53941fdfcda9c7ea9
|
| 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.37-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | cursor_sdk-1.0.37-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 59.2 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
18f841c8a0fe5be6e13a7294875e17b5cb1f58ed95c8d2e9c05340fa7911f3f7
|
|
BLAKE2b-256 checksum How to use checksums |
832d355dba0db4a37618f413d0d9762d2f3999cdd701a4019590e5df6adc9fc1
|
| 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.37-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | cursor_sdk-1.0.37-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 58.5 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
3a9b53735c84c53784d2f95ce3e1a288df69a69c10f93b3509e94ce436ac5c6c
|
|
BLAKE2b-256 checksum How to use checksums |
ee6cd40ddffdccd7035f76c38feaff0fce5430f27d54d772c9acef9a902f163f
|
| 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.37-py3-none-macosx_11_0_x86_64.whl
| Download URL | cursor_sdk-1.0.37-py3-none-macosx_11_0_x86_64.whl |
|---|---|
| Size | 50.7 MB |
| Tags | Python 3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
ffb92ba244b4395c20a2478f8559cee555753f3c3f11ef2f002e7921705b3a2a
|
|
BLAKE2b-256 checksum How to use checksums |
05e6db5686f7660992f26f0d2972b547c1a87481a36a455d70a2b2b8d923aa50
|
| 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.37-py3-none-macosx_11_0_arm64.whl
| Download URL | cursor_sdk-1.0.37-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 |
92044518f8b565b29faddc8199b880f08cd83071970f0a9c6d28cf4c14e078e0
|
|
BLAKE2b-256 checksum How to use checksums |
9d721c9c7d84b33b11168567083d9e0912435d8f5621ecc5e0679988191ee711
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
