fix install docs

Author: veithly

docs/getting-started/installation.md

@@ -2,7 +2,7 @@
 
 ## Prerequisites
 
-- Python 3.10 or higher
+- Python 3.11 or higher
 - Git
 - Virtual environment (recommended)
 
@@ -11,19 +11,26 @@
 ### 1. Clone the Repository
 
 ```bash
-git clone https://github.com/SpoonOS/spoon-core.git
+git clone https://github.com/XSpoonAi/spoon-core.git
 cd spoon-core
 ```
 
 ### 2. Create Virtual Environment
 
 ```bash
+# macOS/Linux
+python3 -m venv spoon-env
+source spoon-env/bin/activate
+
+# Windows (PowerShell)
 python -m venv spoon-env
-source spoon-env/bin/activate  # Linux/macOS
-# or
-spoon-env\Scripts\activate     # Windows
+.\spoon-env\Scripts\Activate.ps1
 ```
 
+> 💡 On newer Apple Silicon Macs the `python` shim may not point to Python 3.
+> Use `python3` for all commands unless you have explicitly configured `python`
+> to target Python 3.10 or later.
+
 ### 3. Install Dependencies
 
 ```bash
@@ -51,7 +58,7 @@ async def test_installation():
         llm_provider="openai",  # or your preferred provider
         model_name="gpt-4.1"  # Framework default
     )
-    
+
     # Framework provides automatic validation and error handling
     return "✅ SpoonOS framework installed successfully!"
 
@@ -73,19 +80,11 @@ You should see success messages indicating the framework is ready.
 The SpoonOS framework includes built-in validation that automatically:
 
 - Checks API key configuration
-- Validates provider connectivity  
+- Validates provider connectivity
 - Ensures proper dependency installation
 - Provides clear error messages if issues are found
 
-## Alternative: CLI Interface
-
-You can also test using the CLI interface:
-
-```bash
-python main.py
-```
-
 ## Next Steps
 
 - [Configuration](./configuration.md) - Set up API keys and configuration
-- [Quick Start](./quick-start.md) - Build your first agent
+- [Quick Start](./quick-start.md) - Build your first agent