Skip to content

Commit eac2882

Browse files
authored
Update README.md
1 parent 270b733 commit eac2882

File tree

1 file changed

+38
-24
lines changed

1 file changed

+38
-24
lines changed

README.md

Lines changed: 38 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -61,25 +61,25 @@ We have developed the package with extensibility in mind. This library is still
6161

6262
### Supported Configurations:
6363

64-
| Explainer | OS | Python version |
65-
| ---------------| ------------------------------| -------------- |
66-
| cofrnet | macOS, Ubuntu, Windows | 3.10 |
67-
| contrastive | macOS, Ubuntu, Windows | 3.6 |
68-
| dipvae | macOS, Ubuntu, Windows | 3.10 |
69-
| gce | macOS, Ubuntu, Windows | 3.10 |
70-
| imd | macOS, Ubuntu | 3.10 |
71-
| lime | macOS, Ubuntu, Windows | 3.10 |
72-
| matching | macOS, Ubuntu, Windows | 3.10 |
73-
| nncontrastive | macOS, Ubuntu, Windows | 3.10 |
74-
| profwt | macOS, Ubuntu, Windows | 3.6 |
75-
| protodash | macOS, Ubuntu, Windows | 3.10 |
76-
| rbm | macOS, Ubuntu, Windows | 3.10 |
77-
| rule_induction | macOS, Ubuntu, Windows | 3.10 |
78-
| shap | macOS, Ubuntu, Windows | 3.6 |
79-
| ted | macOS, Ubuntu, Windows | 3.10 |
80-
| tsice | macOS, Ubuntu, Windows | 3.10 |
81-
| tslime | macOS, Ubuntu, Windows | 3.10 |
82-
| tssaliency | macOS, Ubuntu, Windows | 3.10 |
64+
| Installation keyword | Explainer(s) | OS | Python version |
65+
| ---------------|---------------| ------------------------------| -------------- |
66+
| cofrnet |cofrnet | macOS, Ubuntu, Windows | 3.10 |
67+
| contrastive |cem, cem_maf | macOS, Ubuntu, Windows | 3.6 |
68+
| dipvae | dipvae| macOS, Ubuntu, Windows | 3.10 |
69+
| gce | gce | macOS, Ubuntu, Windows | 3.10 |
70+
| imd | imd | macOS, Ubuntu | 3.10 |
71+
| lime | lime| macOS, Ubuntu, Windows | 3.10 |
72+
| matching | matching| macOS, Ubuntu, Windows | 3.10 |
73+
| nncontrastive | nncontrastive | macOS, Ubuntu, Windows | 3.10 |
74+
| profwt | profwt | macOS, Ubuntu, Windows | 3.6 |
75+
| protodash | protodash | macOS, Ubuntu, Windows | 3.10 |
76+
| rbm | brcg, glrm | macOS, Ubuntu, Windows | 3.10 |
77+
| rule_induction | ripper | macOS, Ubuntu, Windows | 3.10 |
78+
| shap | shap | macOS, Ubuntu, Windows | 3.6 |
79+
| ted | ted | macOS, Ubuntu, Windows | 3.10 |
80+
| tsice | tsice | macOS, Ubuntu, Windows | 3.10 |
81+
| tslime | tslime | macOS, Ubuntu, Windows | 3.10 |
82+
| tssaliency | tssaliency | macOS, Ubuntu, Windows | 3.10 |
8383

8484

8585
### (Optional) Create a virtual environment
@@ -130,11 +130,11 @@ their respective folders as described in
130130
Then, navigate to the root directory of the project which contains `setup.py` file and run:
131131

132132
```bash
133-
(aix360)$ pip install -e .[<algo1>, <algo2>, ...]
133+
(aix360)$ pip install -e .[<algo1>,<algo2>, ...]
134134
```
135-
The above command installs packages required by specific algorithms. Here `<algo>` keyword refers to one or more explainability algorithms. For instance to install packages needed by BRCG, DIPVAE, and TSICE algorithms, one could use
135+
The above command installs packages required by specific algorithms. Here `<algo>` refers to the installation keyword in [table](https://github.com/Trusted-AI/AIX360/edit/master/README.md#supported-configurations) above. For instance to install packages needed by BRCG, DIPVAE, and TSICE algorithms, one could use
136136
```bash
137-
(aix360)$ pip install -e .[rbm, dipvae, tsice]
137+
(aix360)$ pip install -e .[rbm,dipvae,tsice]
138138
```
139139
The default command `pip install .` installs [default dependencies](https://github.com/Trusted-AI/AIX360/blob/462c4d575bfc71c5cbfd32ceacdb3df96a8dc2d1/setup.py#L9) alone.
140140

@@ -149,13 +149,27 @@ If you face any issues, please try upgrading pip and setuptools and uninstall an
149149

150150
## PIP Installation of AI Explainability 360
151151

152-
If you would like to quickly start using the AI explainability 360 toolkit without cloning this repository, then you can install the [aix360 pypi package](https://pypi.org/project/aix360/) as follows.
152+
If you would like to quickly start using the AI explainability 360 toolkit without explicitly cloning this repository, you can use one of these options:
153153

154+
* Install v0.3.0 via repository link
155+
```bash
156+
(your environment)$ pip install -e git+https://github.com/Trusted-AI/AIX360.git#egg=aix360[<algo1>,<algo2>,...]
157+
```
158+
For example, use `pip install -e git+https://github.com/Trusted-AI/AIX360.git#egg=aix360[rbm,dipvae,tsice]` to install BRCG, DIPVAE, and TSICE. You may need to install `cmake` if its not already installed in your environment using `conda install cmake`.
159+
160+
* Install previous version v0.2.1 via [pypi](https://pypi.org/project/aix360/)
154161
```bash
155162
(your environment)$ pip install aix360
156163
```
164+
v0.2.1 includes fewer explainability algorithms. The pip installable package of v0.3.0 will be made available on [pypi](https://pypi.org/project/aix360/) soon.
165+
166+
If you follow either of these two options, you will need to download the notebooks available in the [examples](./examples) folder separately.
167+
168+
## Dealing with installation errors
169+
170+
AI Explainability 360 toolkit is tested on Windows, MacOS, and Linux [here](https://github.com/Trusted-AI/AIX360/blob/master/.github/workflows/Build.yml). However, if you still face installation issues due to package dependencies, please try installing the corresponding package via conda (e.g. conda install package-name) and then install the toolkit by following the usual steps. For example, if you face issues related to pygraphviz during installation, use `conda install pygraphviz` and then install the toolkit.
157171

158-
This will install v0.2.1 which includes a subset of algorithms. This will be updated soon. If you follow this approach, you will need to download the notebooks available in the [examples](./examples) folder separately.
172+
Please use the right python environment based on the [table](https://github.com/Trusted-AI/AIX360/edit/master/README.md#supported-configurations) above.
159173

160174
## Running in Docker
161175

0 commit comments

Comments
 (0)