> 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
