Installation
Make sure you have python3.9 and git VCS installed on your system.
To install the correct version of python you can use pyenv, brew (mac only) or simply download it.
From PyPi
Install encord-active in your favorite Python environment with the following commands:
$ python3.9 -m venv ea-venv
$ # On Linux/MacOS
$ source ea-venv/bin/activate
$ # On Windows
$ ea-venv\Scripts\activate
(ea-venv)$ python -m pip install encord-active
Coco extras
If you intend to work on coco related things you'll have to install extra dependencies this way:
(ea-venv)$ python -m pip install encord-active[coco]
You might need to install xcode-select if you are on Mac or C++ build tools if you are on Windows.
Check the Installation
To check that Encord Active is installed, run:
$ encord-active --help
This must be run in the same virtual environment where you installed your package.
The --help option provides some context to what you can do with encord-active.
To learn more about how to use the command line interface, see the Command Line Interface section.
Docker
We also provide a docker image which works exactly the same as the cli.
docker run -it --rm -p 8501:8501 -p 8000:8000 -v ${PWD}:/data encord/encord-active <command>
This will mount your current working directory, so everything that happens inside the docker container will persist after it is done.
SSH key
If you intend to use Encord Active with an Encord Annotate project you'll need to mount a volume with your SSH key as well.
docker run -it --rm -p 8501:8501 -p 8000:8000 -v ${PWD}:/data -v ${HOME}/.ssh:/root/.ssh encord/encord-active
Then, when asked for your SSH key, you can point to ~/.ssh/<your-key-file>