You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+36-11Lines changed: 36 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,16 +25,50 @@
25
25
26
26
## Install & Run AmadeusGPT🎻
27
27
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:
29
31
```python
30
32
pip install 'amadeusgpt[streamlit]'
31
33
```
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
+
32
62
- 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).
33
63
- 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
34
66
```python
35
67
make app
36
68
```
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)
38
72
39
73
## Citation
40
74
@@ -50,15 +84,6 @@ make app
50
84
```
51
85
- 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).
52
86
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`.
0 commit comments