Sail SDK
Python client library for Sail, the most cost-efficient infrastructure provider for long-horizon agents.
Documentation
- Sail documentation: quickstarts, guides, and examples.
- Sailbox Python guide and Python API reference.
- Other languages: TypeScript, Rust.
Installation
Install the package with pip:
pip install sail
Or with uv:
uv add sail
Installing the SDK also puts the sail CLI on your PATH. To install the CLI on
its own, without the Python SDK, use the standalone installer:
curl -fsSL https://cli.sailresearch.com/install.sh | sh
For Python SDK scripts, CI, and headless agents, set an API key explicitly:
export SAIL_API_KEY=sk_...
What's inside
The SDK covers Sail's three surfaces: hosted inference
(sail.inference), Sailboxes (sandboxed VMs for agent workloads,
sail.Sailbox), and Voyages, automatic telemetry that records an agent
run as a trace of named agents, spans, events, and attributed model calls
(sail.voyage). See the Sail documentation
for quickstarts and API guides.
Support
Questions or issues? Join the Sail Research Slack.
3 maintainers
Release files for sail 0.12.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| sail-0.12.2-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details |
| sail-0.12.2-cp39-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| sail-0.12.2-cp39-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | CPython 3.9 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| sail-0.12.2-cp39-abi3-macosx_11_0_arm64.whl | CPython 3.9 | abi3 | macOS 11.0+ ARM64 | Details |
| sail-0.12.2-cp39-abi3-macosx_10_12_x86_64.whl | CPython 3.9 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 74.7 MB
Release files / sail-0.12.2-cp39-abi3-win_amd64.whl
| Download URL | sail-0.12.2-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 12.8 MB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
e2049664959987e4c8fe0d2c511e66fb7cbe04cc0773d8b99ea1eeb44872c42b
|
|
BLAKE2b-256 checksum How to use checksums |
0beccecce96198e12df748a886cc5dfeda52f7d5a4b7b759577ef34fa01b6fa4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / sail-0.12.2-cp39-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | sail-0.12.2-cp39-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 16.0 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
81f408c05de620ad61a70b0f61bb2eb973805487597c6d932b99fcb1b51085ec
|
|
BLAKE2b-256 checksum How to use checksums |
35dd6307bb9ba36fe2ad68e5ae9ba5db096f406d0398f33eacc3d15c324b3471
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / sail-0.12.2-cp39-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | sail-0.12.2-cp39-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 16.3 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
0db2bb6de5e97a638d7d1018e3e43e64467b8d59b65aabeb32cb95a89df0f09d
|
|
BLAKE2b-256 checksum How to use checksums |
b42cf2355ee690b29b8500292205e0b64f67ec5a0d47fd080a2d83fe1de1ca75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / sail-0.12.2-cp39-abi3-macosx_11_0_arm64.whl
| Download URL | sail-0.12.2-cp39-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 14.4 MB |
| Tags | CPython 3.9 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
0d08ec1c74239756f9531b07c3a905f6858e3ef0162c5358d214209013fdc7bb
|
|
BLAKE2b-256 checksum How to use checksums |
d0456d97732acb55071c9a33c312105adda4f2f5742fa9421f17f32d3adf6bc6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / sail-0.12.2-cp39-abi3-macosx_10_12_x86_64.whl
| Download URL | sail-0.12.2-cp39-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 15.1 MB |
| Tags | CPython 3.9 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
0b0e1109875fca4b8d58bc14581f37d3648f854019101cdee8df03f4ebfa196a
|
|
BLAKE2b-256 checksum How to use checksums |
e655d0de3b8023eaaa83b20014f0cf34e38f01d60ee97900fad9309443c5c97c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
