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

# Chrome Extension

> Generate and edit AI images directly in your browser with the Lumenfall Chrome Extension.

The [Lumenfall AI Image Studio](https://chromewebstore.google.com/detail/lumenfall-ai-image-studio/ebmnoplgfdpoidaaoombkjcmfbifapdj) Chrome extension brings image generation and editing into a browser side panel. Access all Lumenfall models without leaving the page you're on.

## What it does

* **Generate images** from text prompts using any model in the Lumenfall catalog.
* **Edit images** by right-clicking any image on the web and choosing "Edit with Lumenfall", or by dragging images into the side panel.
* **Brainstorm illustrations** — extract text from the current page and generate contextual images.
* **Gallery** — all generated images are saved locally for later download, copy, or re-editing.

The extension communicates only with the Lumenfall API. No analytics, tracking, or third-party services are involved. See our [Privacy Policy](https://lumenfall.ai/privacy) for details on how the API handles your data.

## Installation

Install the extension from the [Chrome Web Store](https://chromewebstore.google.com/detail/lumenfall-ai-image-studio/ebmnoplgfdpoidaaoombkjcmfbifapdj).

Once installed, click the Lumenfall icon in the toolbar or press **Ctrl+Shift+L** (Mac: **Cmd+Shift+L**) to open the side panel.

## Setup

1. Create a free account at [lumenfall.ai](https://lumenfall.ai).
2. Generate an API key from your [dashboard](https://lumenfall.ai/app/api_keys).
3. Open the extension and paste the key in **Settings**.

Models load automatically once a valid key is set. Your API key is stored locally on your device and is never synced or transmitted anywhere other than the Lumenfall API.

## Permissions

The extension requests minimal permissions at install time. Broad host access (`https://*/*`) is **not** requested upfront — instead, Chrome prompts you the first time the extension needs to fetch an image from a specific site (e.g. when you right-click "Edit with Lumenfall" or drag an image in). You can revoke these per-site permissions at any time in `chrome://extensions`.

| Permission         | Why it's needed                                                                             |
| ------------------ | ------------------------------------------------------------------------------------------- |
| `storage`          | Store your API key, preferences, cached models, and gallery locally.                        |
| `unlimitedStorage` | Gallery images are stored as data URLs which can exceed Chrome's default 10 MB quota.       |
| `activeTab`        | Access the current tab to extract page text (Brainstorm) and inject the drag & drop helper. |
| `scripting`        | Inject content scripts on demand for text extraction and image overlays.                    |
| `contextMenus`     | Add the "Edit with Lumenfall" right-click menu on images.                                   |
| `sidePanel`        | Display the extension as a Chrome side panel.                                               |

## Build your own

The extension is open source and designed to be a starting point for building your own Lumenfall-powered tools.

<Card title="GitHub Repository" icon="github" href="https://github.com/lumenfall-ai/lumenfall-chrome-extension">
  Clone the repo, swap in your own UI, and ship a custom Chrome extension backed by the Lumenfall API.
</Card>

The project is vanilla HTML/CSS/JS with no build dependencies for development. Load it as an unpacked extension in Chrome and start hacking:

```bash theme={null}
git clone https://github.com/lumenfall-ai/lumenfall-chrome-extension.git
cd lumenfall-chrome-extension
```

1. Open `chrome://extensions` and enable **Developer mode**.
2. Click **Load unpacked** and select the repo directory.
3. Open the side panel and add your API key.

For production builds (Web Store submission):

```bash theme={null}
bun run scripts/build.ts        # → dist/ + lumenfall-chrome.zip
bun run scripts/build.ts --dev  # → dist/ with localhost enabled
```

## Next steps

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore the full API documentation.
  </Card>

  <Card title="Available models" icon="cube" href="/models">
    See all available image generation models.
  </Card>
</CardGroup>