[329] extracted hw requirements to separate files and created links

Author: marta-tomzik

FAQ.md

@@ -335,19 +335,7 @@ TODO: Update with mailing list details once these are created. Related issue
 
 ### What are the software and hardware requirements for using InstructLab?
 
-The local training is the most hardware intensive part of this process. Your hardware determines how fast/slow training
-the model locally will take.
-
-To run and train InstructLab locally, you must meet the following requirements:
-
-- A supported operating system
-  - A Linux-based operating system
-  - An Apple Silicon M1, M2, or M3 system
-  - A Windows system with WSL (Windows Subsystem for Linux)
-- Python 3.9 or later, including the development headers
-- Approximately 10GB of free disk space to get through the `ilab generate` step
-- Approximately 60GB of free disk space is needed to run the entire process locally on Apple hardware
-- About 32 GB RAM
+Check out the [HARDWARE REQUIREMENTS](HW_REQS.md)
 
 ## Glossary
 

HW_REQS.md

@@ -0,0 +1,16 @@
+## 📋 Hardware requirements
+
+The local training is the most hardware intensive part of this process. Your hardware determines how fast/slow training the model locally will take.
+To run and train InstructLab locally, you must meet the following requirements:
+
+1. We anticipate support for more operating systems in the future. For now the supported systems are: 
+    - A Linux-based operating system (tested on Fedora)
+    - An Apple Silicon M1, M2, or M3 system
+    - A Windows system with WSL (Windows Subsystem for Linux) .
+2. C++ compiler
+3. Python 3.10 or Python 3.11
+4. Approximately 60GB disk space (entire process)
+
+> **NOTE:** Python 3.12 is currently not supported, because some dependencies don't work on Python 3.12, yet.
+<!-- -->
+> **NOTE:** When installing the `ilab` CLI on macOS, you may have to run the `xcode-select --install` command, installing the required packages previously listed.

QUICK_START_GUIDE.md

@@ -17,11 +17,7 @@ the `cli`, please see [the ilab CLI README](https://github.com/instructlab/instr
 
 ## 📋 Requirements
 
-- **🍎 Apple M1/M2/M3 Mac or 🐧 Linux system** (tested on Fedora). We anticipate support for more operating systems in
-  the future.
-- C++ compiler
-- Python 3.9+
-- Approximately 60GB disk space (entire process)
+Check out the [HARDWARE REQUIREMENTS](HW_REQS.md)
 
 ## ✅ Getting started
 

README.md

@@ -191,6 +191,7 @@ If you would like to see the detailed LICENSE click, see [LICENSE](LICENSE).
 - [LICENSE](LICENSE)
 - [README](README.md)
 - [CONTRIBUTING](CONTRIBUTING.md)
+- [HARDWARE REQUIREMENTS](HW_REQS.md)
 - [MAINTAINERS](MAINTAINERS.md)
 - [SECURITY](SECURITY.md)
 - [CHANGELOG](CHANGELOG.md)