# Ophiolite documentation

> Exact versions of subsurface data, shared under your rules: guides, operation and reference.

SDK: ophiolite @ afc8d4289ae589cc094445ccb3c307b41d8412a5
Install: pip install "ophiolite @ git+https://github.com/tuna-soup/ophiolite-sdk@afc8d4289ae589cc094445ccb3c307b41d8412a5"

## Start

- [Current availability](https://ophiolite.dev/docs/availability/)
- [Welcome to Ophiolite](https://ophiolite.dev/docs/)

## Concepts

- [How the product architecture fits](https://ophiolite.dev/docs/concepts/architecture/)
- [Ophiolite component boundaries](https://ophiolite.dev/docs/concepts/components/)
- [Scientific lineage and AI datasets](https://ophiolite.dev/docs/concepts/lineage-ai/)
- [Publication, live updates and recovery](https://ophiolite.dev/docs/concepts/live-updates/)
- [Data ownership and independent use](https://ophiolite.dev/docs/concepts/ownership/)
- [Scientific assets and revisions](https://ophiolite.dev/docs/concepts/scientific-assets/)
- [Lineage, audit, telemetry and analytics](https://ophiolite.dev/docs/concepts/telemetry/)

## Guides

- [Project access and exact scientific assets](https://ophiolite.dev/docs/guides/access-and-assets/): Create scoped projects, review effective access and inspect scientific revisions.
- [Account security and recovery](https://ophiolite.dev/docs/guides/account-security/): Passkeys, account recovery and the boundaries between identity and scientific access.
- [Let an agent work for you](https://ophiolite.dev/docs/guides/agents/): Register an agent with narrower permissions, daily limits and an expiry, approve each change it proposes, and recover its work after a lost answer.
- [Prepare data for your own AI](https://ophiolite.dev/docs/guides/ai-readiness/): Decide who may use which data for AI, export a training-ready corpus with reproducible splits, and search inside your deployment without anything leaving it.
- [Archive, restore and keep local copies](https://ophiolite.dev/docs/guides/asset-lifecycle/): Workspace raster lifecycle and recovery in QGIS.
- [Build on Ophiolite](https://ophiolite.dev/docs/guides/build-on-ophiolite/): Where an application or an agent starts - a key, the SDK, the command line, the API description and a recipe per journey.
- [Review and exchange scientific contributions](https://ophiolite.dev/docs/guides/collaboration-pilot/): Qualified collaboration workflows and their current limits.
- [Collections and snapshots](https://ophiolite.dev/docs/guides/collections-and-snapshots/): Organize project datasets and choose when an exact snapshot needs review.
- [Administer a PostgreSQL connection](https://ophiolite.dev/docs/guides/connection-administration/): Configure, test, rotate and recover an approved read-only well-header source.
- [Coordinates, CRS and map alignment](https://ophiolite.dev/docs/guides/coordinates/)
- [Deployment choices](https://ophiolite.dev/docs/guides/deployment-choices/): Choose evaluation, private pilot or customer-operated deployment.
- [Publish a result you computed in Python](https://ophiolite.dev/docs/guides/derive-and-publish/): Read exact data, compute a surface or any supported type locally, and publish it with its parents and method.
- [Publish new LAS curves from local Python](https://ophiolite.dev/docs/guides/derived-curves/): Manually prepare, calculate, review and publish aligned derived curves.
- [Fault sticks and seismic volumes](https://ophiolite.dev/docs/guides/faults-and-seismic/): Upload OpendTect fault sticks and SEG-Y volumes, look at sections with exact picks, read slices in Python and take them offline.
- [Formation tops in another application](https://ophiolite.dev/docs/guides/formation-tops-in-another-application/): Read well tops you may read at their exact version and hand them to another application as a CSV file.
- [Record an advanced Python calculation](https://ophiolite.dev/docs/guides/independent-applications/): Configure a LAS curve in Workspace, calculate locally and publish a separate portable result.
- [Keep in step with Workspace](https://ophiolite.dev/docs/guides/keep-in-step-with-workspace/): Keep a local copy of what you may read in a project current, and learn what changed since you last looked.
- [Managed upstream sources](https://ophiolite.dev/docs/guides/managed-sources/): Review and follow selected file or OSDU source revisions without transferring their authority.
- [Connect your own source from scratch](https://ophiolite.dev/docs/guides/manual-source-setup/): Deployment administrator setup for files, SQLite, PostgreSQL and OSDU, followed by project mapping in Workspace.
- [OpendTect GR interchange](https://ophiolite.dev/docs/guides/opendtect/): Import a supported curve into a native log and publish bounded edits as a separate LAS.
- [Operation history and application observations](https://ophiolite.dev/docs/guides/operation-history/)
- [Read data in your own Python](https://ophiolite.dev/docs/guides/ophiolite-cli/): Use the supported 0.x SDK for permitted exact reads, local analysis and explicit publication over preview contracts.
- [Operate a customer-run pilot](https://ophiolite.dev/docs/guides/pilot-operations/): Install, sign in, upgrade, back up, restore and leave — the bounded pilot procedure and who is responsible for what.
- [Take exact curves with you](https://ophiolite.dev/docs/guides/portable-exit/): Export exact revisions into a portable bundle and read it later without an account, a server or a network.
- [QGIS live maps: controls and troubleshooting](https://ophiolite.dev/docs/guides/qgis-troubleshooting/)
- [Browse Workspace assets from QGIS](https://ophiolite.dev/docs/guides/qgis-workspace/)
- [Read curves in Python](https://ophiolite.dev/docs/guides/read-curves-in-python/): Find a well log you may read, read one curve at its exact version into a DataFrame, and keep the version you read.
- [Review and share an exact package](https://ophiolite.dev/docs/guides/reviewed-releases/): Capture permitted file and SQL revisions, inspect findings, approve for a purpose and independently download.
- [Run scripts in your deployment (operators)](https://ophiolite.dev/docs/guides/runners/): Enable sandboxed runner jobs, what each job may and may not do, limits, recovery after a restart, cancellation and cleanup.
- [Scientific context and native QGIS results](https://ophiolite.dev/docs/guides/scientific-context/): Review source meaning and return native QGIS outputs without silent reinterpretation.
- [Upload a LAS and work locally in Python](https://ophiolite.dev/docs/guides/self-service-las/): Retain an exact LAS, share read and reuse permissions, and run the Alice–Bob handoff using downloadable scripts.
- [Share data with colleagues](https://ophiolite.dev/docs/guides/sharing-and-collaboration/): Contribute files as an ordinary project member, share and revoke access safely, limit who can ever see an original, and follow updates in your inbox.
- [Sign in and manage an organization](https://ophiolite.dev/docs/guides/sign-in/)
- [Understand source qualification](https://ophiolite.dev/docs/guides/source-qualification/): Inspect source mappings, fidelity evidence and history limits without confusing them with scientific approval.
- [Well tops, trajectories and horizon grids](https://ophiolite.dev/docs/guides/tops-trajectories-horizons/): Upload tops, deviation surveys and horizon grids beside well logs, inspect them, read them in Python and take them offline.
- [Import a surface and follow its calculations](https://ophiolite.dev/docs/guides/visual-workspace/): Workspace, bounded scalar frames and QGIS in the current development pilot.
- [Wells and wellbores](https://ophiolite.dev/docs/guides/wells-and-wellbores/): Say which well and wellbore your data belongs to, with evidence; navigate from a wellbore to its exact data in the browser, in Python and offline.
- [Wells on a map](https://ophiolite.dev/docs/guides/wells-on-a-map/): Show the wells you may read on a web map, zoom to their extent and ask for the wells in a box.
- [Open local data and publish a curve](https://ophiolite.dev/docs/guides/workbench-data-actions/)
- [Invite, grant access and import data](https://ophiolite.dev/docs/guides/workspace-foundations/): Reviewed private-pilot Workspace workflows and their boundaries.
- [Edit and subscribe to well updates](https://ophiolite.dev/docs/guides/workspace-updates/)
- [Navigate Ophiolite Workspace](https://ophiolite.dev/docs/guides/workspace/)

## Operate

- [Leave with your data](https://ophiolite.dev/docs/operate/exit/): Export exact versions as a portable bundle and use them without any Ophiolite server.
- [Install](https://ophiolite.dev/docs/operate/install/): Run Ophiolite on one Linux host with Docker Compose — the configuration file, two secret files and the first administrator.
- [Who controls what](https://ophiolite.dev/docs/operate/ownership/): The ownership matrix for customer-operated and privately managed deployments — storage, compute, models, access, operations and exit.
- [Recovery and moves](https://ophiolite.dev/docs/operate/recovery/): Back up, restore into a new deployment, and move a project to another deployment with its people mapped.
- [Telemetry and logs](https://ophiolite.dev/docs/operate/telemetry/): What Ophiolite sends (nothing) and where its logs are.
- [Upgrade](https://ophiolite.dev/docs/operate/upgrade/): Move to a newer release with one command; what the release gate refuses and why a downgrade is not supported.

## Reference

- [Activity and customer export API](https://ophiolite.dev/docs/reference/activity/)
- [Application HTTP contract](https://ophiolite.dev/docs/reference/application-api/): Experimental bindings, exact curve inputs and portable publication.
- [Asset lifecycle API](https://ophiolite.dev/docs/reference/asset-lifecycle/): Reversible archive and restore with exact revisions.
- [Experimental automation API](https://ophiolite.dev/docs/reference/automation-api/): Project-scoped automation credentials and the pilot CLI.
- [Browser identity boundary](https://ophiolite.dev/docs/reference/browser-identity/)
- [Collaboration API contracts](https://ophiolite.dev/docs/reference/collaboration-api/): Revision review, original retention and bounded connector publication (gateway routes since 2026.10.1).
- [Collection and snapshot contracts](https://ophiolite.dev/docs/reference/collections-and-snapshots/): Personal collection API and optional review lifecycle for retained packages.
- [Component boundaries and numerical library](https://ophiolite.dev/docs/reference/component-boundaries/)
- [Conformance results](https://ophiolite.dev/docs/reference/conformance/): What the public scientific, server and agent conformance suites tested for each set of component versions, with skipped environments and commands.
- [Connector capabilities](https://ophiolite.dev/docs/reference/connector-capabilities/): What each source and application route reads or writes, how changes are found, what is lost and how it was checked.
- [Desktop connector identity API (experimental)](https://ophiolite.dev/docs/reference/connector-identity/)
- [Connector semantics v1](https://ophiolite.dev/docs/reference/connector-semantics/): Pilot source mapping and fidelity reports, compatibility and policy boundaries.
- [How to read connector support](https://ophiolite.dev/docs/reference/connector-support/)
- [Errors](https://ophiolite.dev/docs/reference/errors/): Every error code the Ophiolite API answers with, and what to do about it.
- [Publishing, subscriptions and exact reads](https://ophiolite.dev/docs/reference/live-api/)
- [Managed source API](https://ophiolite.dev/docs/reference/managed-sources/): Experimental source selection, revision and export contracts.
- [Project administration and revision history](https://ophiolite.dev/docs/reference/project-administration/)
- [Project events and synchronisation](https://ophiolite.dev/docs/reference/project-events/): One ordered log per project, filtered by what each reader may see now; pull it, stream it, and keep a local copy current with a checkpoint.
- [Python SDK and repository tools](https://ophiolite.dev/docs/reference/python-tools/)
- [Reviewed release API and storage](https://ophiolite.dev/docs/reference/reviewed-releases/): Experimental retained package authorization, lifecycle, portability and recovery contract.
- [Scalar-map data contract](https://ophiolite.dev/docs/reference/scalar-map-contract/)
- [Scientific assets and reusable results](https://ophiolite.dev/docs/reference/scientific-assets/): Discover exact scientific assets, preserve LAS meaning, and reuse permitted Python results.
- [Scientific context API](https://ophiolite.dev/docs/reference/scientific-context/): Pilot project policies, asset declarations and reviewed native results.
- [Scientific exchange profiles and catalog API](https://ophiolite.dev/docs/reference/scientific-exchange/): Exact references, curve/map contracts and independent validation.
- [Python and TypeScript SDK](https://ophiolite.dev/docs/reference/sdk/): Supported 0.x scientific clients over versioned preview contracts, with exact reads, local Python and explicit publication recovery.
- [Visual map API](https://ophiolite.dev/docs/reference/visual-map-api/): Bounded development gateway contracts for shared surfaces.
- [Workspace organization and access API](https://ophiolite.dev/docs/reference/workspace-control/)
- [Workspace update streams API](https://ophiolite.dev/docs/reference/workspace-updates/)

## Tutorials

- [Follow a change. Pin a comparison.](https://ophiolite.dev/docs/tutorials/follow-pin/)
- [Read scientific values independently](https://ophiolite.dev/docs/tutorials/independent-reading/)
- [Try a public elevation map in QGIS](https://ophiolite.dev/docs/tutorials/public-crs/)
- [Read a source-contract demo independently](https://ophiolite.dev/docs/tutorials/source-contract-demo/): Download synthetic LAS and SQL data and verify a no-op and edited result with ordinary Python.