diff --git a/README.md b/README.md
index 3fd7cee..f44d7fc 100644
--- a/README.md
+++ b/README.md
@@ -51,14 +51,27 @@ CogSol is designed to provide a Django-like development experience for building
 
 ## Installation
 
-### From Source
-
 ```bash
+# Option A: Install from source
 git clone <repository-url> cogsol-framework
 cd cogsol-framework
+
+# Create and activate a virtual environment
+python -m venv .venv
+# Windows:
+.venv\Scripts\activate
+# macOS/Linux:
+source .venv/bin/activate
+
+# Install dependencies
 pip install -e .
+
+# Option B: Install from PyPI
+pip install cogsol-framework
 ```
 
+Using a local `.venv` keeps project dependencies isolated and prevents conflicts with global Python packages.
+
 ### Requirements
 
 - Python 3.9+
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 2db7f72..e862cdd 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -56,8 +56,8 @@ source .venv/bin/activate
 # Install dependencies
 pip install -e .
 
-# Option B: Install from PyPI (when available)
-pip install cogsol
+# Option B: Install from PyPI
+pip install cogsol-framework
 ```
 
 Using a local `.venv` keeps project dependencies isolated and prevents conflicts with global Python packages.