> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poelis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview - Python SDK

> Welcome to the Poelis Python SDK documentation

Welcome to the **Poelis Python SDK** documentation. The SDK reads and updates the same products, items, and properties you see in the Poelis web app, from notebooks and scripts.

For the Public REST API, go [here](/api-reference/overview).

New to Poelis? See the user manual [Overview](/user-manual/overview) and [basic concepts](/user-manual/getting-started#basic-concepts) before working with the SDK.

## SDK capabilities

The Python SDK allows you to:

* **Pull Parameters**: Read a set of parameters from Poelis into a notebook
* **Generate Reports**: Build plots and reports from live engineering data
* **Target a Version**: Keep calculations reproducible by reading a specific product version or the baseline
* **Use Live Values**: Work from Poelis directly in a notebook or script
* **Call from MATLAB**: Use the same package from MATLAB

## The SDK

The Poelis Python SDK is a Python package for notebooks and scripts:

* **Package**: `poelis-sdk`
* **Authentication**: An SDK key bound to the user who created it
* **Navigation**: Workspaces, products, items, and properties by readable ID
* **MATLAB**: The same package, called through the Poelis MATLAB Toolbox

## Quick Links

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/python-sdk/quickstart">
    Install the package, create a client, and read your first property
  </Card>

  <Card title="SDK Keys" icon="key" href="/python-sdk/sdk-keys">
    Create a user-bound key and store it safely
  </Card>

  <Card title="Browse Your Data" icon="code" href="/python-sdk/navigation">
    Dot notation, listings, and readable IDs
  </Card>

  <Card title="Product Versions" icon="layer-group" href="/python-sdk/versions">
    Read draft, baseline, or a published version
  </Card>

  <Card title="Edit Properties" icon="pen" href="/python-sdk/edit-properties">
    Write draft values from Python
  </Card>

  <Card title="Notebooks and Scripts" icon="book" href="/python-sdk/notebooks">
    Explore in a notebook, then pin readable IDs in a script
  </Card>

  <Card title="MATLAB Setup" icon="terminal" href="/python-sdk/matlab">
    Point MATLAB at a Python environment with poelis-sdk installed
  </Card>

  <Card title="Use Poelis from MATLAB" icon="square-terminal" href="/python-sdk/matlab-usage">
    Read values, target a version, and update the draft
  </Card>
</CardGroup>
