|
14 | 14 |
|
15 | 15 | # Installation Guide |
16 | 16 |
|
17 | | -Setup Python environment: |
18 | | -``` |
19 | | -git clone https://github.com/probcomp/bayes3d.git |
20 | | -cd bayes3d |
| 17 | +Set up a fresh Python environment: |
| 18 | + |
| 19 | +```bash |
21 | 20 | conda create -n bayes3d python=3.9 |
22 | 21 | conda activate bayes3d |
23 | | -pip install -r requirements.txt |
24 | | -pip install -e . |
25 | 22 | ``` |
26 | 23 |
|
27 | | -Install GenJAX (optional): |
28 | | -``` |
29 | | -pip install git+https://github.com/probcomp/[email protected] |
| 24 | +Install compatible versions JAX and Torch: |
| 25 | + |
| 26 | +```bash |
| 27 | +pip install --upgrade torch==2.2.0 torchvision==0.17.0+cu118 --index-url https://download.pytorch.org/whl/cu118 |
| 28 | +pip install --upgrade jax[cuda11_local]==0.4.20 -f https://storage.googleapis.com/jax-releases/jax_cuda_releases.html |
30 | 29 | ``` |
31 | 30 |
|
32 | | -Install JAX and Torch: |
| 31 | +Bayes3D is built on top of GenJAX, which is currently hosted in a private Python |
| 32 | +package repository. To configure your machine to access GenJAX: |
| 33 | + |
| 34 | +- [File an issue](https://github.com/probcomp/bayes3d/issues/new) asking @sritchie to give you access. |
| 35 | +- [Install the Google Cloud command line tools](https://cloud.google.com/sdk/docs/install). |
| 36 | +- Follow the instructions on the [installation page](https://cloud.google.com/sdk/docs/install) |
| 37 | +- run `gcloud init` as described [in this |
| 38 | + guide](https://cloud.google.com/sdk/docs/initializing) and configure the tool |
| 39 | + with the `probcomp-caliban` project ID. |
| 40 | + |
| 41 | +Then run the following command to configure `pip` to use these new gcloud |
| 42 | +commands: |
| 43 | + |
| 44 | +```bash |
| 45 | +pip install keyring keyrings.google-artifactregistry-auth |
33 | 46 | ``` |
34 | | -pip install --upgrade "jax[cuda11_pip]" -f https://storage.googleapis.com/jax-releases/jax_cuda_releases.html |
35 | | -pip install torch torchvision --upgrade --index-url https://download.pytorch.org/whl/cu118 |
| 47 | + |
| 48 | +Finally, install Bayes3D: |
| 49 | + |
| 50 | +```bash |
| 51 | +pip install --extra-index-url https://us-west1-python.pkg.dev/probcomp-caliban/probcomp/simple/ \ |
| 52 | + git+https://github.com/probcomp/bayes3d.git#egg=bayes3d |
36 | 53 | ``` |
37 | 54 |
|
38 | 55 | Download model and data assets: |
39 | | -``` |
40 | | -bash download.sh |
41 | | -``` |
42 | 56 |
|
| 57 | +```bash |
| 58 | +wget -q -O - https://raw.githubusercontent.com/probcomp/bayes3d/main/download.sh | bash |
| 59 | +``` |
43 | 60 |
|
44 | 61 | ## Test |
45 | | -Run `python demo.py` to test installation setup. |
46 | 62 |
|
| 63 | +Run `python demo.py` to test installation setup. |
47 | 64 |
|
48 | 65 | ## Common issues |
49 | 66 |
|
@@ -86,16 +103,17 @@ sudo apt-get update |
86 | 103 | sudo apt-get install ninja-build |
87 | 104 | ``` |
88 | 105 |
|
89 | | -I did somethi! |
90 | | - |
91 | 106 | To check your CUDA version: |
92 | 107 | ``` |
93 | 108 | nvcc --version |
94 | 109 | ``` |
95 | 110 |
|
96 | 111 |
|
97 | 112 | # GCP Setup |
98 | | -- Start new VM instance (see [link](https://cloud.google.com/compute/docs/instances/create-start-instance)). Select GPU - NVIDIA V100 and Machine Type 8vCPU 4 Core 30GB. |
| 113 | + |
| 114 | +- Start new VM instance (see |
| 115 | + [link](https://cloud.google.com/compute/docs/instances/create-start-instance)). |
| 116 | + Select GPU - NVIDIA V100 and Machine Type 8vCPU 4 Core 30GB. |
99 | 117 |
|
100 | 118 | -From the VM instances page, searched for public image `c2-deeplearning-pytorch-2-0-gpu-v20230925-debian-11-py310`. Increase storage to 1000GB. |
101 | 119 |
|
|
0 commit comments