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.31
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.31.tar.gz | 1.2 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cursor_sdk-1.0.31-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| cursor_sdk-1.0.31-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.31-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| cursor_sdk-1.0.31-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details |
| cursor_sdk-1.0.31-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 264.1 MB
Release files / cursor_sdk-1.0.31.tar.gz
| Download URL | cursor_sdk-1.0.31.tar.gz |
|---|---|
| Size | 1.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fcdd279852d0b3eea4e4c4562dcd1c7d18360f507d2830bd2de79b6d855276a5
|
|
BLAKE2b-256 checksum How to use checksums |
82ca60a7ea6a8b08a430a499797261487cf9114fbbfb652e10379a1f98dde463
|
| 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.31-py3-none-win_amd64.whl
| Download URL | cursor_sdk-1.0.31-py3-none-win_amd64.whl |
|---|---|
| Size | 45.6 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
12d87c639ac1bdb50958028e81f295f856e8e9a4d784977ea0e07d196716410e
|
|
BLAKE2b-256 checksum How to use checksums |
de60e36b7d68ae702781fac63fef564fc9d643495b114fb959e442d449e537cf
|
| 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.31-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | cursor_sdk-1.0.31-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 59.3 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
e9b87cd80fe428b1a2ee88b4a08aac6297179a33f809d650f0383901fb60a766
|
|
BLAKE2b-256 checksum How to use checksums |
e9f125188d01c7bd0b42edee594225353176f90747047c1508bc315c0d2a3706
|
| 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.31-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | cursor_sdk-1.0.31-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 58.6 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
ae97e49570887953922eb6b3b84cb02c2d13e795fe4b3968f25e23ab569cf21f
|
|
BLAKE2b-256 checksum How to use checksums |
2896de1b8b0275c792d9a472b8e61fe12e0d9bcd3f49551658361f43d8d381ac
|
| 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.31-py3-none-macosx_11_0_x86_64.whl
| Download URL | cursor_sdk-1.0.31-py3-none-macosx_11_0_x86_64.whl |
|---|---|
| Size | 51.0 MB |
| Tags | Python 3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
22cb11230491cd989eb7015cb3778f09ba1e6a974661ddace5bee1e68f85ee8b
|
|
BLAKE2b-256 checksum How to use checksums |
ca21df0f17f3bd3d956897756e5bf4dbed355ad9261d0b7efa3d1af703912fee
|
| 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.31-py3-none-macosx_11_0_arm64.whl
| Download URL | cursor_sdk-1.0.31-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 49.5 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
0b7b1e8fb677fe400c9d63518ff08465a7527cd23f20a3d857bf9454ab99c411
|
|
BLAKE2b-256 checksum How to use checksums |
99181ea7bd9823dde860a44c68a0e920d07a415e5f73c4c3693cc8f22a081220
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
