aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorTim Hall <tim.hall@arm.com>2020-06-23 09:52:07 +0100
committerTim Hall <tim.hall@arm.com>2020-06-23 09:55:48 +0100
commite76a53308a0f45878fa1c4f686e5db582e87f0d9 (patch)
treef40d4a5b5d692ee00b4ed8e0e1007a1d11d8e615 /README.md
parente4fd48078f1f3e840ddda1a78d483547760f2287 (diff)
downloadethos-u-vela-e76a53308a0f45878fa1c4f686e5db582e87f0d9.tar.gz
doc: Add PyPi information to README.md
- Added PyPi installation info - Added source code download/cloning info - Updated development status in setup.py Signed-off-by: Tim Hall <tim.hall@arm.com> Change-Id: I5c2f7dfe19a222f008b5f825c58d0fec14792bc1
Diffstat (limited to 'README.md')
-rw-r--r--README.md50
1 files changed, 47 insertions, 3 deletions
diff --git a/README.md b/README.md
index 19496398..99fb9291 100644
--- a/README.md
+++ b/README.md
@@ -43,9 +43,33 @@ And optionally:
## Installation
-Before running, the Vela package must be installed along with all its
-dependencies. To do this, first change to the directory that contains this
-README.md file. Then use the command:
+Vela is available to install as a package from
+[PyPi](https://pypi.org/project/ethos-u-vela/), or as
+source code from
+[ML Platform](https://git.mlplatform.org/ml/ethos-u/ethos-u-vela.git/about/).
+Both methods will automatically install all the required dependencies.
+
+### PyPi
+
+Install Vela from PyPi using the following command:
+
+```bash
+pip3 install ethos-u-vela
+```
+
+### ML Platform
+
+First obtain the source code by either downloading the desired TGZ file from:
+<https://review.mlplatform.org/plugins/gitiles/ml/ethos-u/ethos-u-vela>
+
+Or by cloning the git repository:
+
+```bash
+git clone https://git.mlplatform.org/ml/ethos-u/ethos-u-vela.git
+```
+
+Once you have the source code, Vela can be installed using the following
+command:
```bash
pip3 install -U setuptools>=40.1.0
@@ -58,6 +82,26 @@ Or, if you use `pipenv`:
pipenv install .
```
+### Advanced Installation for Developers
+
+If you plan to modify the Vela codebase then it is recommended to install Vela
+as an editable package to avoid the need to re-install after every modification.
+This is done by adding the `-e` option to the above install commands like so:
+
+```bash
+pip3 install -e .
+```
+
+Or, if you use `pipenv`:
+
+```bash
+pipenv install -e .
+```
+
+If you plan to contribute to the Vela project (highly encouraged!!!) then it is
+recommended to install Vela along with the pre-commit tools (see
+[Vela Testing](TESTING.md) for more details).
+
## Running
Vela is run with an input `.tflite` file passed on the command line. This file