Skip to content

Commit 763fc0e

Browse files
authored
Add troubleshooting section to pip install issues with outdated pip version (#6956)
### What * half of #6931 * still unclear where the reported black screen on windows comes from ### Checklist * [x] I have read and agree to [Contributor Guide](https://github.com/rerun-io/rerun/blob/main/CONTRIBUTING.md) and the [Code of Conduct](https://github.com/rerun-io/rerun/blob/main/CODE_OF_CONDUCT.md) * [x] I've included a screenshot or gif (if applicable) * [x] I have tested the web demo (if applicable): * Using examples from latest `main` build: [rerun.io/viewer](https://rerun.io/viewer/pr/6956?manifest_url=https://app.rerun.io/version/main/examples_manifest.json) * Using full set of examples from `nightly` build: [rerun.io/viewer](https://rerun.io/viewer/pr/6956?manifest_url=https://app.rerun.io/version/nightly/examples_manifest.json) * [x] The PR title and labels are set such as to maximize their usefulness for the next release's CHANGELOG * [x] If applicable, add a new check to the [release checklist](https://github.com/rerun-io/rerun/blob/main/tests/python/release_checklist)! * [x] If have noted any breaking changes to the log API in `CHANGELOG.md` and the migration guide - [PR Build Summary](https://build.rerun.io/pr/6956) - [Recent benchmark results](https://build.rerun.io/graphs/crates.html) - [Wasm size tracking](https://build.rerun.io/graphs/sizes.html) To run all checks from `main`, comment on the PR with `@rerun-bot full-check`.
1 parent 463de38 commit 763fc0e

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

docs/content/getting-started/troubleshooting.md

+15
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,21 @@ Since the Mesa driver on WSL dispatches to the Windows host graphics driver, it
6363
For example, [line rendering issues](https://github.com/rerun-io/rerun/issues/6749) have been observed when running from WSL with an
6464
outdated AMD driver on the Windows host.
6565

66+
## `pip install` issues
67+
68+
If you see the following when running `pip install rerun-sdk` or `pip install rerun-notebook` on a supported platform:
69+
70+
```sh
71+
ERROR: Could not find a version that satisfies the requirement rerun-sdk (from versions: none)
72+
ERROR: No matching distribution found for rerun-sdk
73+
```
74+
75+
Then this is likely because you're running a version of pip that is too old.
76+
You can check the version of pip with `pip --version`.
77+
If you're running a version of pip 20 or older, you should upgrade it with `pip install --upgrade pip`.
78+
⚠️ depending on your system configuration this may upgrade the pip installation aliased by `pip3` instead of `pip`.
79+
80+
6681
## Startup issues
6782

6883
If Rerun is having trouble starting, you can try resetting its memory with:

0 commit comments

Comments
 (0)