fix(docs): add section with known errors
This commit is contained in:
parent
fc988e4b5b
commit
067a9b3981
20
README.md
20
README.md
|
@ -56,6 +56,7 @@ This is still an early project and the instructions are a little rough, but it w
|
||||||
- [Using the web interface](#using-the-web-interface)
|
- [Using the web interface](#using-the-web-interface)
|
||||||
- [Running from containers](#running-from-containers)
|
- [Running from containers](#running-from-containers)
|
||||||
- [Customizing the config](#customizing-the-config)
|
- [Customizing the config](#customizing-the-config)
|
||||||
|
- [Known errors and solutions](#known-errors-and-solutions)
|
||||||
|
|
||||||
## Setup
|
## Setup
|
||||||
|
|
||||||
|
@ -368,3 +369,22 @@ custom config using:
|
||||||
```shell
|
```shell
|
||||||
> podman run -p 8000:80 --rm -v ~/onnx-web-config.json:/usr/share/nginx/html/config.json:ro docker.io/ssube/onnx-web-gui:main-nginx-bullseye
|
> podman run -p 8000:80 --rm -v ~/onnx-web-config.json:/usr/share/nginx/html/config.json:ro docker.io/ssube/onnx-web-gui:main-nginx-bullseye
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Known errors and solutions
|
||||||
|
|
||||||
|
- `Error: name 'cmd' is not defined` while setting up the virtual environment:
|
||||||
|
- install venv through apt: `sudo apt install python3-venv`
|
||||||
|
- see https://www.mail-archive.com/debian-bugs-dist@lists.debian.org/msg1884072.html
|
||||||
|
- command not found `python` or `pip`:
|
||||||
|
- some systems differentiate between Python 2 and 3, and reserve the `python` command for 2
|
||||||
|
- connection refused:
|
||||||
|
- make sure the API and GUI are both running
|
||||||
|
- make sure you are using the correct hostname or IP address
|
||||||
|
- open the appropriate firewall ports:
|
||||||
|
- TCP/5000 for the API
|
||||||
|
- TCP/3000 or TCP/8000 for the GUI (3000 is the dev server)
|
||||||
|
- CUDA errors:
|
||||||
|
- make sure you are using CUDA 11.x
|
||||||
|
- https://onnxruntime.ai/docs/execution-providers/CUDA-ExecutionProvider.html#requirements
|
||||||
|
- numpy invalid combination of arguments:
|
||||||
|
- make sure to export ONNX models using the same packages and versions that you use while running the API
|
||||||
|
|
Loading…
Reference in New Issue