> For the complete documentation index, see [llms.txt](https://docs.marpledata.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.marpledata.com/docs/marple-db/datastreams/scripts.md).

# Scripts

Enhance your data using automated Python scripts

Use Python scripts that run after ingest to create new signals and add dataset metadata.

Go to **Process → Scripts** to define and test your custom scripts. Add scripts to the ingestion pipeline of a datastream under **Datastream → Configure → Pipeline**.

Scripts run at the end of the ingestion pipeline for every new dataset in the datastream.

<figure><img src="https://3590686807-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwEBNWlmdcxXBXd7oyqyR%2Fuploads%2F8MorWKHUdK6hwLylw61k%2Fimage.png?alt=media&amp;token=1ff4d1b8-5fcb-4ebb-ba0e-db4b26ce49a5" alt=""><figcaption></figcaption></figure>

#### Script library

The script library gives you an overview of all scripts in your workspace. Each script has several settings available:

* **General** — Set the script's name and description, or delete the script.
* **Editor** — Edit the script definition.
* **History** — Browse the script's version history.
* **Runs** — View an overview of all runs of this script across all datasets.

<figure><img src="https://3590686807-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwEBNWlmdcxXBXd7oyqyR%2Fuploads%2F2u7S6I3hxNRp1u20DaWR%2Fimage.png?alt=media&amp;token=98291d4a-bb2a-4555-a991-6b1717a5964c" alt=""><figcaption></figcaption></figure>

#### Script specifics

Scripts run in a Python sandbox on Python 3.13. In addition to the Python standard library, the following packages are available for use in your scripts:

* `marpledata` (Read our [SDK docs](https://marpledata.gitlab.io/marple-sdk/index.html) for more info)
* `numpy`
* `pandas`
* `pyarrow`
* `scipy`
* `requests`
* `polars`

Each script can run for a maximum of **15 minutes**.

#### Test a script

**Via Marple DB**

To test a script, select a datastream and a dataset, then press **Run**. Be careful: this executes the script for real; it is not a dry run.

**Locally**

To iterate faster, develop your script locally in an IDE of your choice. See the example in our SDK docs for a faster local development workflow: [Processing scripts tutorial](https://marpledata.gitlab.io/marple-sdk/tutorials.html#processing-scripts).

#### Example scripts

The script library includes several example scripts to help you get started. Use one as a starting point and tailor it to your specific needs.

<figure><img src="https://3590686807-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwEBNWlmdcxXBXd7oyqyR%2Fuploads%2FgttAaqSSLpOIaKLmjaLW%2Fimage.png?alt=media&amp;token=db89a3ed-be96-4ab0-9cc8-9d0c6e4f07d9" alt=""><figcaption></figcaption></figure>

#### License limits

Your license includes a set amount of compute minutes for running scripts each month. You can check your usage against your license limits under **Settings → License**. If you're approaching your limit, contact us at <sales@marpledata.com>.