Document Python console scripts and instrumented runtime. (#15518)
As discussed/requested [on Discord
here](https://discord.com/channels/689900678990135345/760577505840463893/1172269453480837120).
New sections on [Python
bindings](https://iree.dev/reference/bindings/python/):
New tip on
[profiling-with-tracy](https://iree.dev/developers/performance/profiling-with-tracy/):
diff --git a/docs/website/docs/developers/performance/profiling-with-tracy.md b/docs/website/docs/developers/performance/profiling-with-tracy.md
index 0df38e1..85ef3ee 100644
--- a/docs/website/docs/developers/performance/profiling-with-tracy.md
+++ b/docs/website/docs/developers/performance/profiling-with-tracy.md
@@ -187,6 +187,19 @@
cmake --build .
```
+!!! tip - "Tip - python bindings"
+
+ The `iree-runtime` Python package includes instrumented tools too. Set the
+ `IREE_PY_RUNTIME=tracy` environment variable to use them:
+
+ ```console
+ $ python -m pip install iree-runtime
+ $ IREE_PY_RUNTIME=tracy iree-run-module ...
+ ```
+
+ See [this section](../../../reference/bindings/python#profiling) in the
+ Python bindings documentation for more details.
+
### Additional steps for Sampling
In order for Sampling features to work, make sure that binaries contain debug
diff --git a/docs/website/docs/reference/bindings/python.md b/docs/website/docs/reference/bindings/python.md
index 74333be..d033474 100644
--- a/docs/website/docs/reference/bindings/python.md
+++ b/docs/website/docs/reference/bindings/python.md
@@ -149,9 +149,42 @@
print("Results:", results)
```
-### Samples
+### :octicons-code-16: Samples
Check out the samples in IREE's
[samples/colab/ directory](https://github.com/openxla/iree/tree/main/samples/colab)
and the [iree-samples repository](https://github.com/iree-org/iree-samples) for
examples using the Python APIs.
+
+### :material-console: Console scripts
+
+The Python packages include console scripts for most of IREE's native tools
+like `iree-compile` and `iree-run-module`. After installing a package from
+pip, these should be added to your path automatically:
+
+```console
+$ python -m pip install iree-runtime
+$ which iree-run-module
+
+/projects/.venv/Scripts/iree-run-module
+```
+
+## :material-chart-line: Profiling
+
+The tools in the `iree-runtime` package support variants:
+
+| Variant name | Description |
+| ------------ | ----------- |
+default | Standard runtime tools
+tracy | Runtime tools instrumented using the [Tracy](https://github.com/wolfpld/tracy) profiler
+
+Switch between variants of the installed tools using the `IREE_PY_RUNTIME`
+environment variable:
+
+```bash
+IREE_PY_RUNTIME=tracy iree-run-module ...
+```
+
+See the developer documentation page on
+[Profiling with Tracy](../../developers/performance/profiling-with-tracy.md)
+for information on using Tracy.
