diff options
author | Tim Hall <tim.hall@arm.com> | 2020-06-23 09:52:07 +0100 |
---|---|---|
committer | Tim Hall <tim.hall@arm.com> | 2020-06-23 09:55:48 +0100 |
commit | e76a53308a0f45878fa1c4f686e5db582e87f0d9 (patch) | |
tree | f40d4a5b5d692ee00b4ed8e0e1007a1d11d8e615 /README.md | |
parent | e4fd48078f1f3e840ddda1a78d483547760f2287 (diff) | |
download | ethos-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.md | 50 |
1 files changed, 47 insertions, 3 deletions
@@ -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 |