docs: Add Python environment setup and requirements.txt

This commit adds:
- A new 'Python Environment Setup' section to README.md with venv and Conda instructions.
- A top-level requirements.txt file consolidating all project dependencies including verification tools, linters, and documentation generators.
- System-level dependency requirements for building SciPy and other tools.

Signed-off-by: Miguel Osorio <miguelosorio@google.com>

Author: moidx

README.md

@@ -42,8 +42,37 @@ Files under the [tools](tools/) directory may be available under a different lic
 
 - Verilator **(4.106 or later)** must be installed on the system if running with Verilator
 - If adding/removing instructions, [`espresso`](https://github.com/chipsalliance/espresso/tree/master) must be installed (used by `tools/coredecode`). Remember to checkout on `3.x` branch.
-- RISCV tool chain (based on gcc version 8.3 or higher) must be
-installed so that it can be used to prepare RISCV binaries to run.
+- RISCV tool chain (based on gcc version 8.3 or higher) must be installed so that it can be used to prepare RISCV binaries to run.
+- [**Verible**](https://github.com/chipsalliance/verible) is used for SystemVerilog linting and formatting.
+- **Python 3.10+** is required for verification, documentation, and linting.
+
+### Python Environment Setup
+
+It is recommended to use a virtual environment (venv) or Conda to manage Python dependencies.
+
+#### Using `venv`
+```bash
+# Create a virtual environment
+python3 -m venv .venv
+
+# Activate it
+source .venv/bin/activate
+
+# Install all project dependencies
+pip install -r requirements.txt
+```
+
+#### Using `Conda`
+```bash
+# Create a conda environment
+conda create -n veer-el2 python=3.12
+
+# Activate it
+conda activate veer-el2
+
+# Install dependencies
+pip install -r requirements.txt
+```
 
 ## Quickstart guide
 

requirements.txt

@@ -0,0 +1,31 @@
+# Build and Workflow Tools
+nox
+meson
+
+# Linters
+isort
+black
+flake8
+
+# Documentation
+Sphinx>=8.0.2,<9
+# Sphinx utilities
+https://github.com/antmicro/antmicro-sphinx-utils/archive/main.zip
+
+# Verification - Core
+# Note: Custom cocotb might be required for some flows
+# ./third_party/cocotb
+cocotb==1.8.0
+cocotb-bus==0.2.1
+cocotb-coverage==1.1.0
+cocotb-test==0.2.4
+pyuvm==2.9.1
+
+# Verification - Testing & Reporting
+pytest==7.4.1
+pytest-html==3.2.0
+pytest-timeout==2.1.0
+pytest-md==0.2.0
+
+# Scientific/Math (used in some block tests)
+scipy==1.13.1