Skip to content

Commit 7f08ab0

Browse files
authored
Update README.md
1 parent 612d30b commit 7f08ab0

File tree

1 file changed

+36
-11
lines changed

1 file changed

+36
-11
lines changed

README.md

Lines changed: 36 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -25,16 +25,50 @@
2525

2626
## Install & Run AmadeusGPT🎻
2727

28-
- AmadeusGPT is a Python package hosted on `pypi`. You can create a virtual env (conda, etc, see below*) or Docker and run:
28+
### Install with `pypi`
29+
30+
- AmadeusGPT is a Python package hosted on `pypi`. You can create a virtual env (conda, etc, see below*) and run:
2931
```python
3032
pip install 'amadeusgpt[streamlit]'
3133
```
34+
Note that in order to access our demo video and keypoint files, you will need to clone the repo.
35+
36+
### Install from the source
37+
38+
We have prepared 3 bash installation scripts. Make sure you edit the path of conda / forge to your in the installation scripts.
39+
40+
```bash
41+
# Recommended if you are running AmadeusGPT without gpus. The installation is light-weight and you can only use it with movie files and keypoint output (.h5) from DeepLabCut.
42+
bash install_minimal.sh
43+
44+
conda activate amadeusgpt-minimal
45+
```
46+
47+
```bash
48+
# Recommended if you are running on linux with gpus (We will add Windows and MacsOS support in the future).
49+
bash install_gpu.sh
50+
51+
conda activate amadeusgpt-gpu
52+
```
53+
54+
```bash
55+
#For MacOS users, if you are only playing with very small video files.
56+
bash install_cpu.sh
57+
58+
conda activate amadeusgpt-cpu
59+
```
60+
### Setup OpenAI Key to use AmadeusGPT
61+
3262
- Please note that you need an [openAI API key](https://platform.openai.com/account/api-keys), which you can easily create [here](https://platform.openai.com/account/api-keys).
3363
- If you want the **Streamlit Demo on your computer**, you will also need demo files that are supplied in our repo (see below**), so please git clone the repo and navigate into the `AmadeusGPT` directory. Then in your conda env/terminal run `pip install 'amadeusgpt[streamlit]'` as described above. Then, to launch the Demo App execute in the terminal:
64+
65+
### Try AmadeusGPT with local web app
3466
```python
3567
make app
3668
```
37-
- You can use AmadeusGPT directly in python: iPython, Jupyter Notebooks, Google Colab, etc. For a quick start, see our `\examples` directory that hosts demo data and a Jupyter Notebook! Enjoy!
69+
70+
### Try AmadeusGPT with our example notebooks
71+
We provide example notebooks at [Notebooks](notebook)
3872

3973
## Citation
4074

@@ -50,15 +84,6 @@ make app
5084
```
5185
- arXiv preprint version **[AmadeusGPT: a natural language interface for interactive animal behavioral analysis](https://arxiv.org/abs/2307.04858)** by [Shaokai Ye](https://github.com/yeshaokai), [Jessy Lauer](https://github.com/jeylau), [Mu Zhou](https://github.com/zhoumu53), [Alexander Mathis](https://github.com/AlexEMG) & [Mackenzie W. Mathis](https://github.com/MMathisLab).
5286

53-
### Install tips
54-
- *Make a new conda env: `conda create --name amadeusGPT python=3.9` then run `conda activate amadeusGPT` or you can also use our supplied conda if you git cloned the repo (navigate into the conda directory): `conda env create -f amadesuGPT.yml` then pip install amadeusGPT once created/launched.
55-
- **Git clone this repo: so please open a terminal, we recommend to download into Documents (so type `cd Documents`) and run `git clone https://github.com/AdaptiveMotorControlLab/AmadeusGPT.git` Then go into the dir (`cd AmadeusGPT`)
56-
- If you want to use SAM, you need to download the weights. Otherwise you will see the following message in the app: `Cannot find SAM checkpoints. Skipping SAM`. Download them and add to "static" directory: wget https://dl.fbaipublicfiles.com/segment_anything/sam_vit_b_01ec64.pth
57-
58-
### Install trouble shooting:
59-
- If you hit an error during installing on an M1/M2 Macbook with installing HDF5, run `conda install h5py` in your conda env.
60-
- If you launch the app and get an ffmpeg error, `RuntimeError: No ffmpeg exe could be found. Install ffmpeg on your system, or set the IMAGEIO_FFMPEG_EXE environment variable.` try running `conda install ffmpeg`.
61-
- If you have an M1/M2 chip and use CEBRA within AmadeusGPT, and you get this error: `RuntimeError: Device type MPS is not supported for torch.Generator() api` run `pip install --upgrade torch`.
6287

6388
## License
6489

0 commit comments

Comments
 (0)