Skip to content
YosoiDocs

Install

Rust projects need Rust 1.99 or newer. Python projects need Python 3.12 through 3.15. The Python package includes its native extension and depends on Pydantic.

Free-threaded Python 3.14 and 3.15 builds are supported.

Yosoi is published on crates.io and PyPI. Python wheels vary by operating system, architecture and interpreter ABI.

cargo add yosoi
uv add yosoi

The Surface and optional-browser guides require Yosoi 0.4.0 or newer. See the 0.4.0 release notes for version-specific commands and breaking changes when upgrading from 0.3.0.

Read Concepts, send a Request, or produce a typed record with Contracts.

For shell workflows, install the CLI. The default browser engine needs compatible regular Chrome or Chromium; see Browser. Choosing a browser covers optional Firefox and Moli support.

For a browser service in a container, see Docker setup.