Updated README file with instructions for running scripts

Author: Roturgo

README.md

@@ -1,15 +1,15 @@
 # mandelbrot-scripts
 Mandelbrot checksum scripts for benchmarking Python 3.14's free-threaded interpreter
 
-**Background:**
+### Background:
 
 These scripts implement a CPU-intensive workload for calculating a checksum for a [Mandelbrot set](https://en.wikipedia.org/wiki/Mandelbrot_set).
 
-**Purpose:**
+### Purpose:
 
 These scripts were used to benchmark Python 3.14's new free-threaded interpreter against the classic GIL-enabled build for a CPU-bound workload.
 
-**Files:**
+### Files:
 
 Several versions of the benchmarking scripts were created to test out a sequential implementation, a multi-processing implementation, and a threaded implementation. A Bash driver script to automate testing and CPU cooldown cycles is also provided. 
 
@@ -19,10 +19,32 @@ The respective files are:
 * **mandelbrot_threading.py** --> an implementation using Python's standard threading library
 * **run_tests.sh** --> a Bash script to automate testing of each Python script against the GIL-enabled Python 3.14 interpreter as well as the free-threaded Python 3.14 interpreter
 
-**Running the Code:**
+### Running the Code:
 
-1. Ensure that your test system has [uv installed](https://docs.astral.sh/uv/getting-started/installation/)
-2. Clone this repo:
+1. Clone this repo:
 ``` bash
 git clone https://github.com/Roturgo/mandelbrot-scripts.git
 ```
+2. Change to the mandelbrot-scripts directory
+``` bash
+cd mandelbrot-scripts
+```
+3. Ensure that your test system has [uv installed](https://docs.astral.sh/uv/getting-started/installation/)
+4. Install the GIL-enabled and free-threaded interpreters
+``` bash
+uv python install cpython-3.14.0
+uv python install cpython-3.14.0t
+```
+5. (Optional) Verify successful installation
+``` bash
+uv python list
+```
+6. Sync and activate a python virtual environment to ensure installed python interpreters are in your shell's $PATH
+``` bash
+uv sync -U
+source .venv/bin/activate
+```
+7. Run the Bash script to automate testing and cooldown cycles
+``` bash
+bash ./run_tests.sh
+```