1 files changed, 95 insertions, 32 deletions

diff --git a/docs/git.md b/docs/git.md
index 89137ffc..ff6c8091 100644
--- a/docs/git.md
+++ b/docs/git.md
@@ -1,66 +1,129 @@
-### G4F - Installation Guide
 
-Follow these steps to install G4F from the source code:
+# G4F - Git Installation Guide
 
-1. **Clone the Repository:**
+This guide provides step-by-step instructions for installing G4F from the source code using Git.
 
-```bash
-git clone https://github.com/xtekky/gpt4free.git
-```
 
-2. **Navigate to the Project Directory:**
+## Table of Contents
 
-```bash
-cd gpt4free
-```
+1. [Prerequisites](#prerequisites)
+2. [Installation Steps](#installation-steps)
+   1. [Clone the Repository](#1-clone-the-repository)
+   2. [Navigate to the Project Directory](#2-navigate-to-the-project-directory)
+   3. [Set Up a Python Virtual Environment](#3-set-up-a-python-virtual-environment-recommended)
+   4. [Activate the Virtual Environment](#4-activate-the-virtual-environment)
+   5. [Install Dependencies](#5-install-dependencies)
+   6. [Verify Installation](#6-verify-installation)
+3. [Usage](#usage)
+4. [Troubleshooting](#troubleshooting)
+5. [Additional Resources](#additional-resources)
 
-3. **(Optional) Create a Python Virtual Environment:**
+---
 
-It's recommended to isolate your project dependencies. You can follow the [Python official documentation](https://docs.python.org/3/tutorial/venv.html) for virtual environments.
+## Prerequisites
 
-```bash
-python3 -m venv venv
-```
+Before you begin, ensure you have the following installed on your system:
+- Git
+- Python 3.7 or higher
+- pip (Python package installer)
 
-4. **Activate the Virtual Environment:**
-
-- On Windows:
+## Installation Steps
 
+### 1. Clone the Repository
+**Open your terminal and run the following command to clone the G4F repository:**
 ```bash
-.\venv\Scripts\activate
+git clone https://github.com/xtekky/gpt4free.git
 ```
 
-- On macOS and Linux:
+### 2. Navigate to the Project Directory
+**Change to the project directory:**
+```bash
+cd gpt4free
+```
 
+### 3. Set Up a Python Virtual Environment (Recommended)
+**It's best practice to use a virtual environment to manage project dependencies:**
 ```bash
-source venv/bin/activate
+python3 -m venv venv
 ```
 
-5. **Install Minimum Requirements:**
+### 4. Activate the Virtual Environment
+**Activate the virtual environment based on your operating system:**
+- **Windows:**
+  ```bash
+  .\venv\Scripts\activate
+  ```
 
-Install the minimum required packages:
+- **macOS and Linux:**
+  ```bash
+  source venv/bin/activate
+  ```
 
+### 5. Install Dependencies
+**You have two options for installing dependencies:**
+
+#### Option A: Install Minimum Requirements
+**For a lightweight installation, use:**
 ```bash
 pip install -r requirements-min.txt
 ```
 
-6. **Or Install All Packages from `requirements.txt`:**
-
-If you prefer, you can install all packages listed in `requirements.txt`:
-
+#### Option B: Install All Packages
+**For a full installation with all features, use:**
 ```bash
 pip install -r requirements.txt
 ```
 
-7. **Start Using the Repository:**
-
+### 6. Verify Installation
 You can now create Python scripts and utilize the G4F functionalities. Here's a basic example:
 
-Create a `test.py` file in the root folder and start using the repository:
-
+**Create a `g4f-test.py` file in the root folder and start using the repository:**
 ```python
 import g4f
 # Your code here
 ```
 
-[Return to Home](/)
\ No newline at end of file
+## Usage
+**After installation, you can start using G4F in your Python scripts. Here's a basic example:**
+```python
+import g4f
+
+# Your G4F code here
+# For example:
+from g4f.client import Client
+
+client = Client()
+
+response = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[
+        {
+            "role": "user",
+            "content": "Say this is a test"
+        }
+    ]
+    # Add any other necessary parameters
+)
+
+print(response.choices[0].message.content)
+```
+
+## Troubleshooting
+**If you encounter any issues during installation or usage:**
+   1. Ensure all prerequisites are correctly installed.
+   2. Check that you're in the correct directory and the virtual environment is activated.
+   3. Try reinstalling the dependencies.
+   4. Consult the [G4F documentation](https://github.com/xtekky/gpt4free) for more detailed information.
+
+## Additional Resources
+   - [G4F GitHub Repository](https://github.com/xtekky/gpt4free)
+   - [Python Virtual Environments Guide](https://docs.python.org/3/tutorial/venv.html)
+   - [pip Documentation](https://pip.pypa.io/en/stable/)
+
+---
+
+**_For more information or support, please visit the [G4F GitHub Issues page](https://github.com/xtekky/gpt4free/issues)._**
+
+
+---  
+[Return to Home](/)