concrete/docs/user/basics/installing.md

# Installing

## Python package

To install **Concrete** from PyPi, run the following:

```shell
pip install concrete-numpy
```

```{note}
Note that **concrete-numpy** has `pygraphviz` as an optional dependency to draw graphs.
```

```{WARNING}
`pygraphviz` requires `graphviz` packages being installed on your OS, see <a href="https://pygraphviz.github.io/documentation/stable/install.html">https://pygraphviz.github.io/documentation/stable/install.html</a>
```

```{DANGER}
`graphviz` packages are binary packages that won't automatically be installed by pip.
Do check <a href="https://pygraphviz.github.io/documentation/stable/install.html">https://pygraphviz.github.io/documentation/stable/install.html</a> for instructions on how to install `graphviz` for `pygraphviz`.
```

You can install the extra python dependencies for drawing with:

```shell
pip install concrete-numpy[full]
# you may need to force reinstallation
pip install --force-reinstall concrete-numpy[full]
```

## Docker image

You can also get the **concrete-numpy** docker image by either pulling the latest docker image or a specific version:

```shell
docker pull zamafhe/concrete-numpy:latest
# or
docker pull zamafhe/concrete-numpy:v0.2.0
```

The image can be used with docker volumes, [see the docker documentation here](https://docs.docker.com/storage/volumes/).

You can then use this image with the following command:

```shell
# Without local volume:
docker run --rm -it -p 8888:8888 zamafhe/concrete-numpy:v0.2.0

# With local volume to save notebooks on host:
docker run --rm -it -p 8888:8888 -v /host/path:/data zamafhe/concrete-numpy:v0.2.0
```

This will launch a **Concrete** enabled jupyter server in the docker, that you can access from your browser.

Alternatively, you can just open a shell in the docker with or without volumes:

```shell
docker run --rm -it zamafhe/concrete-numpy:v0.2.0 /bin/bash
```