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

# Installation

If you just want to install `encord-agents` in your current environment, you can run:

```shell theme={"dark"}
python -m pip install encord-agents
```

Optionally include additional dependencies used for working with visual files such as Images, Videos, Image Groups / Sequences by running:

```shell theme={"dark"}
python -m pip install "encord-agents[vision]"
```

<Tip>
  Installing the `vision` extras is advised for most users. These dependencies optimize performance when handling visual data formats.

  If you are building serverless deployments (for example: AWS Lambda) or working with non-visual data (labels, priorities, text, PDFs, or audio), you may skip the vision extras to minimize bundle size.
</Tip>

<Warning>Encord Agents requires `python >= 3.10`. If you do not have Python 3.10, we recommend using[`pyenv`](https://github.com/pyenv/pyenv) to manage your Python versions.</Warning>

***

## Using an Isolated Environment (Recommended)

We recommend installing the Encord agents library in an isolated environment. There are several options available.

### Venv

1. Create a new virtual environment. In this example, we name it `agents-venv` but you can choose any name you see fit.

```shell theme={"dark"}
python -m venv agents-venv
```

2. Next, activate your virtual environment. This ensures that any modules you install remain isolated and that all previously installed modules in the environment are available for use in Python.

```shell theme={"dark"}
source agents-venv/bin/activate
```

3. Once activated, the environment name is displayed before the cursor in your terminal.

```shell title="example" theme={"dark"}
(agents-venv) $
```

4. Install the `encord-agents` library.

```shell theme={"dark"}
python -m pip install encord-agents
```

### Poetry

If you already have a Poetry project, you can add `encord-agents` to that project:

```shell theme={"dark"}
poetry add encord-agents
```

### Conda

1. Create a conda environment.

```
conda create -n agents python>=3.10
```

2. We suggest activating your conda environment.

```shell theme={"dark"}
conda activate agents
```

3. Once activated, the environment name is displayed before the cursor in your terminal.

```shell title="example" theme={"dark"}
(agents) $
```

4. Install the `encord-agents` library.

```shell theme={"dark"}
python -m pip install encord-agents
```

## Dependencies

The dependencies for `encord-agents` are kept lightweight, with the only relatively large dependencies being `opencv-python` and `numpy`. To see the full list of dependencies, see [here](https://github.com/encord-team/encord-agents/blob/main/pyproject.toml).