Install

Audience: builders trying Ophiolite locally
Status: Preview

Ophiolite is still repo-first. The current install path is from source while the packaged SDK path is being prepared.

Before installing, check the system requirements.

Current prerequisites

• Rust toolchain
• Python 3.10+
• Git

Build the CLI

git clone https://github.com/scrooijmans/ophiolite.git
cd ophiolite
cargo build -p ophiolite-cli

Install the Python package

python -m pip install -e .\python

The install exposes the ophiolite_sdk import surface, the user-facing ophiolite console script, and the compatibility ophiolite-automation console script.

Verify the install

Run the install doctor first. It checks the native CLI, platform, writable cache, local project runtime, operation catalog, bundled sample data, and license placeholder state.

ophiolite doctor

The current preview build reports a license warning until commercial activation is implemented. Other failures should be treated as install issues.

You can also inspect the activation prototype directly:

ophiolite auth status

For preview testing with a local certificate JSON file:

ophiolite auth import .\license.json

Inspect the operation catalog

cargo run --quiet --manifest-path Cargo.toml -p ophiolite-cli -- operation-catalog

Verify Python

from ophiolite_sdk import Project

project = Project.create("demo-project")
print(project.summary())

Current caveat

The public install story is real, but still early. Packaged wheels, activation, signed artifacts, and the Workbench installer are not yet live. Some project-first ingest and richer workflow APIs remain narrower in public Python and CLI surfaces than they are in the Rust core.

Next: 10-minute quickstart