> For the complete documentation index, see [llms.txt](https://docs.jua.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jua.ai/python-sdk/installation.md).

# Installation

## Dependencies and Installation

This guide will walk you through setting up the Jua SDK for your project.

### System Requirements

Before you begin, ensure your environment can meet these fundamental needs for the Jua SDK to function correctly:

* **Python:** Version 3.11 or higher.
* **Zarr:** Version 3.0 or newer.

{% hint style="info" %}
Tip: try [uv](https://docs.astral.sh/uv/getting-started/), an extremely fast Python package and project manager.

```bash
uv init && uv add jua
```

{% endhint %}

### Installation Methods

We strongly recommend using a virtual environment to manage your project's dependencies. This prevents conflicts with other Python projects or your system-wide Python installation.

#### Installation using `pip`

1. **Ensure you have Python 3.11 or higher.**\
   You must have a Python 3.11+ interpreter installed and available in your PATH. You can download it from [python.org](https://www.python.org/downloads/) if needed.
2. **Install `jua`:**

   ```bash
   pip install jua
   ```

   This command will download and install `jua` and its dependencies (including a compatible Zarr version) from the Python Package Index (PyPI).

#### Installation using `uv` (optional)

[uv](https://docs.astral.sh/uv/) is an extremely fast Python package installer and resolver. It's designed as a drop-in replacement for `pip` and `pip-tools` and can significantly speed up your workflows.

1. **Set up your project and install `jua`:**\
   Navigate to your desired project directory or create a new one:

   ```bash
   mkdir my-jua-project
   cd my-jua-project
   ```

   Then, initialize a `uv` managed environment and add `jua`:

   ```bash
   uv init
   uv add jua
   ```
2. **Run your Python scripts:**

   ```bash
   uv run your_script_using_jua.py
   ```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.jua.ai/python-sdk/installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.