> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/n4ze3m/page-assist/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Page Assist on Chrome, Firefox, Edge, or build from source for the latest features.

# Installation

Page Assist is available for all major browsers. Choose your preferred installation method below.

## Install from browser stores

The easiest way to install Page Assist is directly from your browser's extension store.

<Tabs>
  <Tab title="Chrome">
    Install Page Assist from the Chrome Web Store:

    1. Visit the [Chrome Web Store page](https://chrome.google.com/webstore/detail/page-assist/jfgfiigpkhlkbnfnbobbkinehhfdhndo)
    2. Click **Add to Chrome**
    3. Confirm by clicking **Add extension** in the popup

    Page Assist will be installed and ready to use. The extension icon will appear in your toolbar.

    <Note>
      Chrome installation also works for other Chromium-based browsers like Brave and Vivaldi.
    </Note>
  </Tab>

  <Tab title="Firefox">
    Install Page Assist from Firefox Add-ons:

    1. Visit the [Firefox Add-ons page](https://addons.mozilla.org/en-US/firefox/addon/page-assist/)
    2. Click **Add to Firefox**
    3. Confirm by clicking **Add** in the popup
    4. Grant the requested permissions

    Page Assist will be installed and ready to use.

    <Note>
      Firefox installation also works for Firefox-based browsers like LibreWolf and Zen Browser.
    </Note>
  </Tab>

  <Tab title="Edge">
    Install Page Assist from the Edge Add-ons store:

    1. Visit the [Edge Add-ons page](https://microsoftedge.microsoft.com/addons/detail/page-assist-a-web-ui-fo/ogkogooadflifpmmidmhjedogicnhooa)
    2. Click **Get**
    3. Confirm by clicking **Add extension** in the popup

    Page Assist will be installed and ready to use.
  </Tab>
</Tabs>

## Install from source

Build and install Page Assist from source to get the latest features or contribute to development.

### Prerequisites

Before building from source, you need:

* **Bun** - A fast JavaScript runtime and package manager ([Installation guide](https://bun.sh/))
* **AI Provider** - At least one of:
  * [Ollama](https://ollama.com) (recommended for beginners)
  * [LM Studio](https://lmstudio.ai/)
  * Any OpenAI-compatible API endpoint

<Note>
  If you encounter issues with Bun, you can use `npm` as an alternative.
</Note>

### Build steps

<Steps>
  <Step title="Clone the repository">
    ```bash theme={null}
    git clone https://github.com/n4ze3m/page-assist.git
    cd page-assist
    ```
  </Step>

  <Step title="Install dependencies">
    ```bash theme={null}
    bun install
    ```

    This will install all required dependencies for the project.
  </Step>

  <Step title="Build the extension">
    ```bash theme={null}
    bun run build
    ```

    By default, this builds for Chrome, Edge, and Firefox. The built extensions will be in the `build` directory.

    You can also build for a specific browser:

    ```bash theme={null}
    # Chrome only
    bun run build:chrome

    # Firefox only
    bun run build:firefox

    # Edge only
    bun run build:edge
    ```
  </Step>

  <Step title="Load the extension in your browser">
    <Tabs>
      <Tab title="Chrome/Edge">
        1. Open the Extension Management page:
           * Chrome: Navigate to `chrome://extensions`
           * Edge: Navigate to `edge://extensions`
        2. Enable **Developer Mode** by clicking the toggle in the top right
        3. Click **Load unpacked**
        4. Select the `build/chrome-mv3` directory (or `build/edge-mv3` for Edge)

        The extension is now loaded and ready to use!
      </Tab>

      <Tab title="Firefox">
        1. Navigate to `about:addons`
        2. Click the **Extensions** tab
        3. Click the gear icon and select **Debug Add-ons**
        4. Click **Load Temporary Add-on**
        5. Navigate to the `build/firefox-mv2` directory and select the `manifest.json` file

        <Warning>
          Temporary add-ons in Firefox are removed when you close the browser. You'll need to reload them each session.
        </Warning>
      </Tab>
    </Tabs>
  </Step>
</Steps>

### Development mode

For active development, you can run the extension in watch mode:

```bash theme={null}
# Chrome
bun dev

# Firefox
bun dev:firefox

# Edge
bun dev:edge
```

This starts a development server that automatically rebuilds when you make changes to the source files.

## Next steps

Now that Page Assist is installed, you need to set up an AI provider and start chatting. Continue to the [Quickstart](/quickstart) guide.