update uv instructions

Author: William Charlton

docs/intro-running-locally.md

@@ -1,31 +1,33 @@
 ---
 id: running-locally
-title: Running it locally
+title: Running locally/offline
 ---
 
-If you want to run SimWrapper on your own server or laptop, there are a few ways to do so.
+Most users can use simwrapper directly from the website https://simwrapper.app. But many are interested in running a local copy of the site on their own machine, perhaps inside an agency network firewall or in "offline mode" without requiring network access.
+
+If you want to run SimWrapper locally on your own server or laptop, there are a few ways to do so. Once it is installed, it will be available "offline" as well.
 
 ### Install from uv/pip
 
-This is the easiest solution for most of you. SimWrapper is a website, but for ease of of local installation we've also packaged it up as a super simple 'simwrapper' command-line package on the PyPi software repository. You don't need to know Python to use this package.
+This is the easiest solution for most situations. SimWrapper has been packaged as a self-contained command line tool on the PyPi software repository. You don't need to know or use Python to use this package.
 
 **Shortest path to a running local installation:**
 
-Use the [uv software manager](https://docs.astral.sh/uv/) which is the most modern Python packaging ecosystem out there. uv eliminates the problems with virtual environments, messy multiple python versions, etc. It is far, far faster and more error-proof than using pip or other methods.
+Use the [uv software manager](https://docs.astral.sh/uv/). uv is the modern replacement for all previous python software management tools like pip, poetry, virtualenv, etc. It eliminates the problems with virtual environments, messy multiple Python versions, etc. It is far, far faster and more error-proof than using pip or other methods!
 - Install uv first if you don't already have it:
   https://docs.astral.sh/uv/getting-started/installation
-- Run `uv tool install simwrapper` to install simwrapper as a command-line program on your system.
-  Read the output from the install command; you might need to edit your PATH to include the program.
-- Now go to the folder containing the data you want to explore, and run `uv tool run simwrapper`
-- That's it! Your site is running at http://localhost:4999
+- Go to the folder containing the data you want to explore, and run 
+  - `uvx simwrapper run` 
+- There's no step 3! SimWrapper is now running at http://127.0.0.1:4999 or http://localhost:4999
 
-You can upgrade with `uv tool upgrade simwrapper`
+`uvx` is a combined installer/command runner that will auto install the simwrapper tool from https://pypi.org/project/simwrapper/ on first run. Each time it runs, it will check for the latest version and update automatically. In offline mode it runs the most recent version that it has already installed.
+- Read the [uv docs](https://docs.astral.sh/uv/) for many other uv capabilities such as `uv tool install simwrapper` and managing your pip dependencies and python versions! 
 
 **pip**
 
 You can also use pip directly, with `pip install simwrapper`. If you go this route, you should
 probably create a virtualenv (venv) and make sure you have a recent version of Python. These extra
-steps can be a real pain, especially because the tool has many datascience dependencies which are
+steps can be a real pain, especially because SimWrapper has many data science dependencies which are
 difficult to install. Please use `uv` instead, as above :-)