> ## Documentation Index
> Fetch the complete documentation index at: https://docs.easyuse.yolain.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

<Steps>
  <Step title="Install Node Package">
    <AccordionGroup>
      <Accordion title="Install via Git Command">
        #### 1. Install Git

        If Git is not installed on your computer, please install Git first. Git is a distributed version control system used to track changes in files. You can download the Git installer suitable for your operating system from the [Git official website](https://git-scm.com/downloads).

        #### 2. Clone EasyUse to Local

        <Tabs>
          <Tab title="Windows">
            * Navigate to the `ComfyUI/custom_nodes` folder
            * In the search box above the folder, type `cmd` and press Enter to launch the command line tool
            * Enter the following command in the command line tool to download the EasyUse node package

            ```shell theme={null}
            git clone https://github.com/yolain/ComfyUI-Easy-Use
            ```
          </Tab>

          <Tab title="Linux (Cloud Platform)">
            * Navigate to the `ComfyUI/custom_nodes` folder
            * Find the command line/terminal tool in the right panel
            * Enter the following command to download the EasyUse node package

            ```shell theme={null}
            git clone https://github.com/yolain/ComfyUI-Easy-Use
            ```
          </Tab>

          <Tab title="MacOS">
            * Run Terminal from `Applications/Utilities` or `Spotlight Search`
            * Find the `ComfyUI/custom_nodes` folder, press `Option` + `Command` + `C` to copy the path
            * Enter the following command to download the EasyUse node package

            ```shell theme={null}
            # Paste the path after cd
            cd path
            git clone https://github.com/yolain/ComfyUI-Easy-Use
            ```
          </Tab>
        </Tabs>
      </Accordion>

      <Accordion title="Install via ComfyUI Manager">
        * After running ComfyUI, click `Manager` at the top of the web interface to find `Custom Nodes Manager`
        * Search for `ComfyUI Easy Use` and click `Install`
        * Restart ComfyUI to apply the changes
      </Accordion>

      <Accordion title="Install via Third-Party Launcher">
        * Run a third-party launcher, such as `Aki Launcher`
        * Search for `ComfyUI Easy Use` in the launcher's node management and click `Install`
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Install Required Dependencies">
    <Note>Some cloud platforms (Linux environments) use Miniconda. If you need to update dependencies, please refer to the third option.</Note>

    <AccordionGroup>
      <Accordion title="Official Desktop Version">
        No additional dependencies are required, as all necessary dependencies are already included in the official version.
      </Accordion>

      <Accordion title="System Python or ComfyUI_windows_portable or Integrated Package">
        <Tabs>
          <Tab title="Windows">
            * Navigate to the `ComfyUI/custom_nodes/ComfyUI-Easy-Use` folder
            * Run the `install.bat` file to install dependencies
          </Tab>

          <Tab title="Linux/MacOS">
            * Run Terminal from `Applications/Utilities` or `Spotlight Search`
            * Find the `ComfyUI/custom_nodes` folder, press `Option` + `Command` + `C` to copy the path
            * Enter the following command to install dependencies

            ```shell theme={null}
            # Paste the path after cd
            cd path
            sh ./install.sh
            ```
          </Tab>
        </Tabs>
      </Accordion>

      <Accordion title="Miniconda / Anaconda">
        <Tabs>
          <Tab title="Windows">
            * Navigate to the `ComfyUI/custom_nodes` folder
            * In the search box above the folder, type `cmd` and press Enter to launch the command line tool
            * Enter the following command to activate the conda virtual environment and install dependencies

            ```shell theme={null}
              # Assuming the current virtual environment name is comfyui
              conda activate comfyui
              pip install -r requirements.txt
            ```
          </Tab>

          <Tab title="Linux/MacOS">
            * Run Terminal from `Applications/Utilities` or `Spotlight Search`
            * Find the `ComfyUI/custom_nodes` folder, press `Option` + `Command` + `C` to copy the path
            * Enter the following command to activate the conda virtual environment and install dependencies

            ```shell theme={null}
              # Assuming the current virtual environment name is comfyui
              conda activate comfyui
              pip install -r requirements.txt
            ```
          </Tab>
        </Tabs>
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Resolve Dependency Conflicts (Optional)">
    If EasyUse still fails to load after completing the first two steps and running ComfyUI, it is usually due to dependency conflicts. You can try the following methods to troubleshoot the issue:

    `1. Check ComfyUI Run Logs`

    * After running ComfyUI, you can find the `comfyui.log` and `comfyui.prev.log` files in the root directory. Open them with a text editor to check for error messages related to Easy-Use (the same method applies to other node packages).

    <Frame caption="1-1. Open the comfyui.log file in the root directory with a text editor">
      <img src="https://mintcdn.com/yolain/zALn-Ga4wzNzoIjg/images/get-started/win_install_dep.jpg?fit=max&auto=format&n=zALn-Ga4wzNzoIjg&q=85&s=e7cfe90aebd84015c7b07ad3170b56cf" width="1280" height="720" data-path="images/get-started/win_install_dep.jpg" />
    </Frame>

    <br />

    <Frame caption="1-2. This section only shows the startup results of various node packages. You can see that EasyUse failed to load, but the reason is not visible">
      <img src="https://mintcdn.com/yolain/zALn-Ga4wzNzoIjg/images/get-started/win_install_dep_2.jpg?fit=max&auto=format&n=zALn-Ga4wzNzoIjg&q=85&s=778fb7b421860a16dd51a8f24d8425c4" width="1280" height="720" data-path="images/get-started/win_install_dep_2.jpg" />
    </Frame>

    <br />

    <Frame caption="1-3. Search for easy-use to find related error reasons, and copy the error content">
      <img src="https://mintcdn.com/yolain/zALn-Ga4wzNzoIjg/images/get-started/win_install_dep_3.jpg?fit=max&auto=format&n=zALn-Ga4wzNzoIjg&q=85&s=03472c015377690e41bf242b4e7a5d2b" width="1280" height="720" data-path="images/get-started/win_install_dep_3.jpg" />
    </Frame>

    `2. Search for Related Issues on GitHub or Ask GPT or Ask the Developer on GitHub`

    <Frame caption="2-1. Search for related issues on GitHub">
      <img src="https://mintcdn.com/yolain/zALn-Ga4wzNzoIjg/images/get-started/win_install_dep_4.jpg?fit=max&auto=format&n=zALn-Ga4wzNzoIjg&q=85&s=8dcca6f3b49124bff6d432b84c96bb5a" width="1280" height="720" data-path="images/get-started/win_install_dep_4.jpg" />
    </Frame>

    <br />

    <Frame caption="2-2. Found a solution, need to update the `peft` dependency">
      <img src="https://mintcdn.com/yolain/zALn-Ga4wzNzoIjg/images/get-started/win_install_dep_5.jpg?fit=max&auto=format&n=zALn-Ga4wzNzoIjg&q=85&s=8e0956d74fe0b14d6558124b0f6f24bf" width="1280" height="720" data-path="images/get-started/win_install_dep_5.jpg" />
    </Frame>
  </Step>
</Steps>