diff --git a/.dockerignore b/.dockerignore
index 3f674f978db..602ffade5d3 100644
--- a/.dockerignore
+++ b/.dockerignore
@@ -1,9 +1,11 @@
*
!invokeai
!pyproject.toml
+!uv.lock
!docker/docker-entrypoint.sh
!LICENSE
+**/dist
**/node_modules
**/__pycache__
-**/*.egg-info
\ No newline at end of file
+**/*.egg-info
diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs
index c6b833cf589..5c04dc964ef 100644
--- a/.git-blame-ignore-revs
+++ b/.git-blame-ignore-revs
@@ -1,2 +1,5 @@
b3dccfaeb636599c02effc377cdd8a87d658256c
218b6d0546b990fc449c876fb99f44b50c4daa35
+182580ff6970caed400be178c5b888514b75d7f2
+8e9d5c1187b0d36da80571ce4c8ba9b3a37b6c46
+99aac5870e1092b182e6c5f21abcaab6936a4ad1
\ No newline at end of file
diff --git a/.gitattributes b/.gitattributes
index 4c9fc0120e5..6cf175e7c5a 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -2,4 +2,6 @@
# Only affects text files and ignores other file types.
# For more info see: https://www.aleksandrhovhannisyan.com/blog/crlf-vs-lf-normalizing-line-endings-in-git/
* text=auto
-docker/** text eol=lf
\ No newline at end of file
+docker/** text eol=lf
+tests/test_model_probe/stripped_models/** filter=lfs diff=lfs merge=lfs -text
+tests/model_identification/stripped_models/** filter=lfs diff=lfs merge=lfs -text
diff --git a/.github/AGENTS.md b/.github/AGENTS.md
new file mode 100644
index 00000000000..9f701a7e33d
--- /dev/null
+++ b/.github/AGENTS.md
@@ -0,0 +1,24 @@
+# Agent Instructions
+
+## Package Management
+
+This project uses **pnpm** exclusively for package management in the frontend (`invokeai/frontend/web/`).
+
+- ✅ Use `pnpm` commands (e.g., `pnpm install`, `pnpm run`)
+- ❌ Never use `npm` or `yarn` commands
+- ❌ Never suggest creating or using `package-lock.json` or `yarn.lock`
+- ✅ The lock file is `pnpm-lock.yaml`
+
+Use the following pnpm commands for typical operations:
+
+- pnpm -C invokeai/frontend/web install
+- pnpm -C invokeai/frontend/web build
+- pnpm -C invokeai/frontend/web lint:tsc
+- pnpm -C invokeai/frontend/web lint:dpdm
+- pnpm -C invokeai/frontend/web lint:eslint
+- pnpm -C invokeai/frontend/web lint:prettier
+
+## Project Structure
+
+- Backend: Python in `invokeai/`
+- Frontend: TypeScript/React in `invokeai/frontend/web/` (uses pnpm)
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index b979196cc1b..f62b8c90f11 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -1,32 +1,30 @@
# continuous integration
-/.github/workflows/ @lstein @blessedcoolant @hipsterusername @ebr
+/.github/workflows/ @lstein @blessedcoolant
-# documentation
-/docs/ @lstein @blessedcoolant @hipsterusername @Millu
-/mkdocs.yml @lstein @blessedcoolant @hipsterusername @Millu
+# documentation - anyone with write privileges can review
+/docs/
# nodes
-/invokeai/app/ @Kyle0654 @blessedcoolant @psychedelicious @brandonrising @hipsterusername
+/invokeai/app/ @blessedcoolant @lstein @dunkeroni @JPPhoto
# installation and configuration
-/pyproject.toml @lstein @blessedcoolant @hipsterusername
-/docker/ @lstein @blessedcoolant @hipsterusername @ebr
-/scripts/ @ebr @lstein @hipsterusername
-/installer/ @lstein @ebr @hipsterusername
-/invokeai/assets @lstein @ebr @hipsterusername
-/invokeai/configs @lstein @hipsterusername
-/invokeai/version @lstein @blessedcoolant @hipsterusername
+/pyproject.toml @lstein @blessedcoolant
+/docker/ @lstein @blessedcoolant
+/scripts/ @lstein @blessedcoolant
+/installer/ @lstein @blessedcoolant
+/invokeai/assets @lstein @blessedcoolant
+/invokeai/configs @lstein @blessedcoolant
+/invokeai/version @lstein @blessedcoolant
# web ui
-/invokeai/frontend @blessedcoolant @psychedelicious @lstein @maryhipp @hipsterusername
-/invokeai/backend @blessedcoolant @psychedelicious @lstein @maryhipp @hipsterusername
+/invokeai/frontend @blessedcoolant @lstein @dunkeroni
# generation, model management, postprocessing
-/invokeai/backend @damian0815 @lstein @blessedcoolant @gregghelt2 @StAlKeR7779 @brandonrising @ryanjdick @hipsterusername
+/invokeai/backend @lstein @blessedcoolant @dunkeroni @JPPhoto @Pfannkuchensack
# front ends
-/invokeai/frontend/CLI @lstein @hipsterusername
-/invokeai/frontend/install @lstein @ebr @hipsterusername
-/invokeai/frontend/merge @lstein @blessedcoolant @hipsterusername
-/invokeai/frontend/training @lstein @blessedcoolant @hipsterusername
-/invokeai/frontend/web @psychedelicious @blessedcoolant @maryhipp @hipsterusername
+/invokeai/frontend/CLI @lstein
+/invokeai/frontend/install @lstein
+/invokeai/frontend/merge @lstein @blessedcoolant
+/invokeai/frontend/training @lstein @blessedcoolant
+/invokeai/frontend/web @blessedcoolant @lstein @dunkeroni @Pfannkuchensack
diff --git a/.github/ISSUE_TEMPLATE/BUG_REPORT.yml b/.github/ISSUE_TEMPLATE/BUG_REPORT.yml
index 26e1579f73a..d49271b7d45 100644
--- a/.github/ISSUE_TEMPLATE/BUG_REPORT.yml
+++ b/.github/ISSUE_TEMPLATE/BUG_REPORT.yml
@@ -21,6 +21,20 @@ body:
- label: I have searched the existing issues
required: true
+ - type: dropdown
+ id: install_method
+ attributes:
+ label: Install method
+ description: How did you install Invoke?
+ multiple: false
+ options:
+ - "Invoke's Launcher"
+ - 'Stability Matrix'
+ - 'Pinokio'
+ - 'Manual'
+ validations:
+ required: true
+
- type: markdown
attributes:
value: __Describe your environment__
@@ -76,8 +90,8 @@ body:
attributes:
label: Version number
description: |
- The version of Invoke you have installed. If it is not the latest version, please update and try again to confirm the issue still exists. If you are testing main, please include the commit hash instead.
- placeholder: ex. 3.6.1
+ The version of Invoke you have installed. If it is not the [latest version](https://github.com/invoke-ai/InvokeAI/releases/latest), please update and try again to confirm the issue still exists. If you are testing main, please include the commit hash instead.
+ placeholder: ex. v6.0.2
validations:
required: true
@@ -85,17 +99,17 @@ body:
id: browser-version
attributes:
label: Browser
- description: Your web browser and version.
+ description: Your web browser and version, if you do not use the Launcher's provided GUI.
placeholder: ex. Firefox 123.0b3
validations:
- required: true
+ required: false
- type: textarea
id: python-deps
attributes:
- label: Python dependencies
+ label: System Information
description: |
- If the problem occurred during image generation, click the gear icon at the bottom left corner, click "About", click the copy button and then paste here.
+ Click the gear icon at the bottom left corner, then click "About". Click the copy button and then paste here.
validations:
required: false
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 306483bfaaf..6febd0917db 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,7 +1,7 @@
blank_issues_enabled: false
contact_links:
- name: Project-Documentation
- url: https://invoke-ai.github.io/InvokeAI/
+ url: https://invoke.ai/
about: Should be your first place to go when looking for manuals/FAQs regarding our InvokeAI Toolkit
- name: Discord
url: https://discord.gg/ZmtBAhwWhy
diff --git a/.github/actions/install-frontend-deps/action.yml b/.github/actions/install-frontend-deps/action.yml
index 32b49872494..1e6d3e6be80 100644
--- a/.github/actions/install-frontend-deps/action.yml
+++ b/.github/actions/install-frontend-deps/action.yml
@@ -3,15 +3,15 @@ description: Installs frontend dependencies with pnpm, with caching
runs:
using: 'composite'
steps:
- - name: setup node 18
- uses: actions/setup-node@v4
+ - name: setup node 22
+ uses: actions/setup-node@v6
with:
- node-version: '18'
+ node-version: '22'
- name: setup pnpm
- uses: pnpm/action-setup@v2
+ uses: pnpm/action-setup@v6
with:
- version: 8
+ version: 10
run_install: false
- name: get pnpm store directory
@@ -20,7 +20,7 @@ runs:
echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
- name: setup cache
- uses: actions/cache@v4
+ uses: actions/cache@v5
with:
path: ${{ env.STORE_PATH }}
key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 6c8fee470e9..84633de6ce1 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -8,7 +8,7 @@
## QA Instructions
-
+
## Merge Plan
@@ -18,4 +18,6 @@
- [ ] _The PR has a short but descriptive title, suitable for a changelog_
- [ ] _Tests added / updated (if applicable)_
+- [ ] _❗Changes to a redux slice have a corresponding migration_
- [ ] _Documentation added / updated (if applicable)_
+- [ ] _Updated `What's New` copy (if doing a release after this PR)_
diff --git a/.github/workflows/build-container.yml b/.github/workflows/build-container.yml
index a8bfaa540c1..b5bd8637acd 100644
--- a/.github/workflows/build-container.yml
+++ b/.github/workflows/build-container.yml
@@ -13,6 +13,12 @@ on:
tags:
- 'v*.*.*'
workflow_dispatch:
+ inputs:
+ push-to-registry:
+ description: Push the built image to the container registry
+ required: false
+ type: boolean
+ default: false
permissions:
contents: write
@@ -39,27 +45,36 @@ jobs:
steps:
- name: Free up more disk space on the runner
# https://github.com/actions/runner-images/issues/2840#issuecomment-1284059930
+ # the /mnt dir has 70GBs of free space
+ # /dev/sda1 74G 28K 70G 1% /mnt
+ # According to some online posts the /mnt is not always there, so checking before setting docker to use it
run: |
echo "----- Free space before cleanup"
df -h
sudo rm -rf /usr/share/dotnet
sudo rm -rf "$AGENT_TOOLSDIRECTORY"
- sudo swapoff /mnt/swapfile
- sudo rm -rf /mnt/swapfile
+ if [ -f /mnt/swapfile ]; then
+ sudo swapoff /mnt/swapfile
+ sudo rm -rf /mnt/swapfile
+ fi
+ if [ -d /mnt ]; then
+ sudo chmod -R 777 /mnt
+ echo '{"data-root": "/mnt/docker-root"}' | sudo tee /etc/docker/daemon.json
+ sudo systemctl restart docker
+ fi
echo "----- Free space after cleanup"
df -h
- name: Checkout
- uses: actions/checkout@v3
+ uses: actions/checkout@v6
- name: Docker meta
id: meta
- uses: docker/metadata-action@v4
+ uses: docker/metadata-action@v6
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
images: |
ghcr.io/${{ github.repository }}
- ${{ env.DOCKERHUB_REPOSITORY }}
tags: |
type=ref,event=branch
type=ref,event=tag
@@ -71,50 +86,33 @@ jobs:
latest=${{ matrix.gpu-driver == 'cuda' && github.ref == 'refs/heads/main' }}
suffix=-${{ matrix.gpu-driver }},onlatest=false
- - name: Set up QEMU
- uses: docker/setup-qemu-action@v2
-
- name: Set up Docker Buildx
- uses: docker/setup-buildx-action@v2
+ uses: docker/setup-buildx-action@v4
with:
platforms: ${{ env.PLATFORMS }}
- name: Login to GitHub Container Registry
if: github.event_name != 'pull_request'
- uses: docker/login-action@v2
+ uses: docker/login-action@v4
with:
registry: ghcr.io
username: ${{ github.repository_owner }}
password: ${{ secrets.GITHUB_TOKEN }}
- # - name: Login to Docker Hub
- # if: github.event_name != 'pull_request' && vars.DOCKERHUB_REPOSITORY != ''
- # uses: docker/login-action@v2
- # with:
- # username: ${{ secrets.DOCKERHUB_USERNAME }}
- # password: ${{ secrets.DOCKERHUB_TOKEN }}
-
- name: Build container
timeout-minutes: 40
id: docker_build
- uses: docker/build-push-action@v4
+ uses: docker/build-push-action@v7
with:
context: .
file: docker/Dockerfile
platforms: ${{ env.PLATFORMS }}
- push: ${{ github.ref == 'refs/heads/main' || github.ref_type == 'tag' }}
+ build-args: |
+ GPU_DRIVER=${{ matrix.gpu-driver }}
+ push: ${{ github.ref == 'refs/heads/main' || github.ref_type == 'tag' || github.event.inputs.push-to-registry }}
tags: ${{ steps.meta.outputs.tags }}
labels: ${{ steps.meta.outputs.labels }}
- cache-from: |
- type=gha,scope=${{ github.ref_name }}-${{ matrix.gpu-driver }}
- type=gha,scope=main-${{ matrix.gpu-driver }}
- cache-to: type=gha,mode=max,scope=${{ github.ref_name }}-${{ matrix.gpu-driver }}
-
- # - name: Docker Hub Description
- # if: github.ref == 'refs/heads/main' || github.ref == 'refs/tags/*' && vars.DOCKERHUB_REPOSITORY != ''
- # uses: peter-evans/dockerhub-description@v3
- # with:
- # username: ${{ secrets.DOCKERHUB_USERNAME }}
- # password: ${{ secrets.DOCKERHUB_TOKEN }}
- # repository: ${{ vars.DOCKERHUB_REPOSITORY }}
- # short-description: ${{ github.event.repository.description }}
+ # cache-from: |
+ # type=gha,scope=${{ github.ref_name }}-${{ matrix.gpu-driver }}
+ # type=gha,scope=main-${{ matrix.gpu-driver }}
+ # cache-to: type=gha,mode=max,scope=${{ github.ref_name }}-${{ matrix.gpu-driver }}
diff --git a/.github/workflows/build-installer.yml b/.github/workflows/build-installer.yml
deleted file mode 100644
index b517751960c..00000000000
--- a/.github/workflows/build-installer.yml
+++ /dev/null
@@ -1,45 +0,0 @@
-# Builds and uploads the installer and python build artifacts.
-
-name: build installer
-
-on:
- workflow_dispatch:
- workflow_call:
-
-jobs:
- build-installer:
- runs-on: ubuntu-latest
- timeout-minutes: 5 # expected run time: <2 min
- steps:
- - name: checkout
- uses: actions/checkout@v4
-
- - name: setup python
- uses: actions/setup-python@v5
- with:
- python-version: '3.10'
- cache: pip
- cache-dependency-path: pyproject.toml
-
- - name: install pypa/build
- run: pip install --upgrade build
-
- - name: setup frontend
- uses: ./.github/actions/install-frontend-deps
-
- - name: create installer
- id: create_installer
- run: ./create_installer.sh
- working-directory: installer
-
- - name: upload python distribution artifact
- uses: actions/upload-artifact@v4
- with:
- name: dist
- path: ${{ steps.create_installer.outputs.DIST_PATH }}
-
- - name: upload installer artifact
- uses: actions/upload-artifact@v4
- with:
- name: installer
- path: ${{ steps.create_installer.outputs.INSTALLER_PATH }}
diff --git a/.github/workflows/build-wheel.yml b/.github/workflows/build-wheel.yml
new file mode 100644
index 00000000000..546d1b07088
--- /dev/null
+++ b/.github/workflows/build-wheel.yml
@@ -0,0 +1,38 @@
+# Builds and uploads python build artifacts.
+
+name: build wheel
+
+on:
+ workflow_dispatch:
+ workflow_call:
+
+jobs:
+ build-installer:
+ runs-on: ubuntu-latest
+ timeout-minutes: 5 # expected run time: <2 min
+ steps:
+ - name: checkout
+ uses: actions/checkout@v6
+
+ - name: setup python
+ uses: actions/setup-python@v6
+ with:
+ python-version: '3.12'
+ cache: pip
+ cache-dependency-path: pyproject.toml
+
+ - name: install pypa/build
+ run: pip install --upgrade build
+
+ - name: setup frontend
+ uses: ./.github/actions/install-frontend-deps
+
+ - name: build wheel
+ id: build_wheel
+ run: ./scripts/build_wheel.sh
+
+ - name: upload python distribution artifact
+ uses: actions/upload-artifact@v7
+ with:
+ name: dist
+ path: ${{ steps.build_wheel.outputs.DIST_PATH }}
diff --git a/.github/workflows/clean-caches.yml b/.github/workflows/clean-caches.yml
index e5acdeab1b9..73d742f3041 100644
--- a/.github/workflows/clean-caches.yml
+++ b/.github/workflows/clean-caches.yml
@@ -10,7 +10,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: Check out code
- uses: actions/checkout@v3
+ uses: actions/checkout@v6
- name: Cleanup
run: |
diff --git a/.github/workflows/close-inactive-issues.yml b/.github/workflows/close-inactive-issues.yml
index 9636911b2e9..40f75cebb88 100644
--- a/.github/workflows/close-inactive-issues.yml
+++ b/.github/workflows/close-inactive-issues.yml
@@ -14,7 +14,7 @@ jobs:
issues: write
pull-requests: write
steps:
- - uses: actions/stale@v8
+ - uses: actions/stale@v10
with:
days-before-issue-stale: ${{ env.DAYS_BEFORE_ISSUE_STALE }}
days-before-issue-close: ${{ env.DAYS_BEFORE_ISSUE_CLOSE }}
@@ -23,6 +23,7 @@ jobs:
close-issue-message: "Due to inactivity, this issue was automatically closed. If you are still experiencing the issue, please recreate the issue."
days-before-pr-stale: -1
days-before-pr-close: -1
+ only-labels: "bug"
exempt-issue-labels: "Active Issue"
repo-token: ${{ secrets.GITHUB_TOKEN }}
operations-per-run: 500
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
new file mode 100644
index 00000000000..0e9c5774ba3
--- /dev/null
+++ b/.github/workflows/deploy-docs.yml
@@ -0,0 +1,149 @@
+name: 'docs'
+
+on:
+ push:
+ branches:
+ - 'main'
+ pull_request:
+ types:
+ - 'ready_for_review'
+ - 'opened'
+ - 'synchronize'
+ workflow_dispatch:
+ inputs:
+ deploy_target:
+ description: 'Deploy target (custom = invoke.ai, ghpages = invoke-ai.github.io/InvokeAI)'
+ type: choice
+ options:
+ - custom
+ - ghpages
+ default: custom
+
+permissions:
+ contents: read
+ pull-requests: read
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref || github.run_id }}
+ cancel-in-progress: true
+
+jobs:
+ changes:
+ runs-on: ubuntu-latest
+ outputs:
+ docs: ${{ steps.manual.outputs.docs || steps.filter.outputs.docs }}
+ steps:
+ - name: checkout
+ uses: actions/checkout@v6
+ with:
+ fetch-depth: 0
+
+ - name: mark manual run
+ if: github.event_name == 'workflow_dispatch'
+ id: manual
+ run: echo "docs=true" >> "$GITHUB_OUTPUT"
+
+ - name: detect docs-related changes
+ if: github.event_name != 'workflow_dispatch'
+ id: filter
+ uses: dorny/paths-filter@v3
+ with:
+ filters: |
+ docs:
+ - '.github/workflows/deploy-docs.yml'
+ - 'docs/**'
+ - 'scripts/generate_docs_json.py'
+ - 'invokeai/app/**'
+ - 'invokeai/backend/**'
+ - 'pyproject.toml'
+ - 'uv.lock'
+
+ check-and-build:
+ needs: changes
+ if: |
+ github.event_name == 'workflow_dispatch' ||
+ (github.event_name == 'pull_request' &&
+ github.event.pull_request.draft == false &&
+ needs.changes.outputs.docs == 'true') ||
+ (github.event_name == 'push' && needs.changes.outputs.docs == 'true')
+ runs-on: ubuntu-22.04
+ timeout-minutes: 20
+ steps:
+ - name: checkout
+ uses: actions/checkout@v6
+
+ # Python (needed for generate-docs-data)
+ - name: setup uv
+ uses: astral-sh/setup-uv@v8.1.0
+ with:
+ version: '0.11.12'
+ enable-cache: true
+ python-version: '3.11'
+
+ - name: setup python
+ uses: actions/setup-python@v6
+ with:
+ python-version: '3.11'
+
+ # generate_docs_json.py only needs the invokeai package importable
+ # (pydantic + invokeai.app/backend). Skip the [test] extra to keep CI fast.
+ - name: install python dependencies
+ run: uv sync --frozen
+
+ # Node (needed for docs build)
+ - name: setup node
+ uses: actions/setup-node@v6
+ with:
+ node-version: '22'
+
+ - name: setup pnpm
+ uses: pnpm/action-setup@v6
+ with:
+ version: 10
+ run_install: false
+
+ - name: install docs dependencies
+ run: pnpm install --prefer-frozen-lockfile
+ working-directory: docs
+
+ # Checks
+ - name: verify generated docs data
+ run: pnpm run check-docs-data
+ working-directory: docs
+
+ - name: build docs
+ run: pnpm build
+ working-directory: docs
+ env:
+ DEPLOY_TARGET: ${{ github.event_name == 'workflow_dispatch' && inputs.deploy_target || 'custom' }}
+ ENABLE_ANALYTICS: ${{ github.ref == 'refs/heads/main' && (github.event_name != 'workflow_dispatch' || inputs.deploy_target == 'custom') }}
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: verify deploy output
+ run: pnpm run check-deploy-output
+ working-directory: docs
+ env:
+ DEPLOY_TARGET: ${{ github.event_name == 'workflow_dispatch' && inputs.deploy_target || 'custom' }}
+
+ # Upload artifact for deploy (main branch only)
+ - name: upload pages artifact
+ if: github.ref == 'refs/heads/main'
+ uses: actions/upload-pages-artifact@v5
+ with:
+ path: docs/dist
+
+ deploy:
+ if: github.ref == 'refs/heads/main'
+ needs: check-and-build
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ pages: write
+ id-token: write
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - name: deploy to GitHub Pages
+ id: deployment
+ uses: actions/deploy-pages@v5
diff --git a/.github/workflows/frontend-checks.yml b/.github/workflows/frontend-checks.yml
index da19b74ebcc..b36fbeb650b 100644
--- a/.github/workflows/frontend-checks.yml
+++ b/.github/workflows/frontend-checks.yml
@@ -39,12 +39,28 @@ jobs:
runs-on: ubuntu-latest
timeout-minutes: 10 # expected run time: <2 min
steps:
- - uses: actions/checkout@v4
+ - uses: actions/checkout@v6
+
+ - name: Fail if package-lock.json is added/modified (pnpm only)
+ shell: bash
+ working-directory: .
+ run: |
+ set -euo pipefail
+ git fetch --no-tags --prune --depth=1 origin "${{ github.base_ref }}"
+ if git diff --name-only "origin/${{ github.base_ref }}...HEAD" | grep -E '(^|/)package-lock\.json$'; then
+ echo "::error::package-lock.json was added or modified. This repo uses pnpm only."
+ exit 1
+ fi
- name: check for changed frontend files
if: ${{ inputs.always_run != true }}
id: changed-files
- uses: tj-actions/changed-files@v42
+ # Pinned to the _hash_ for v45.0.9 to prevent supply-chain attacks.
+ # See:
+ # - CVE-2025-30066
+ # - https://www.stepsecurity.io/blog/harden-runner-detection-tj-actions-changed-files-action-is-compromised
+ # - https://github.com/tj-actions/changed-files/issues/2463
+ uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96
with:
files_yaml: |
frontend:
diff --git a/.github/workflows/frontend-tests.yml b/.github/workflows/frontend-tests.yml
index 086cff7b3d4..abb1fb8419f 100644
--- a/.github/workflows/frontend-tests.yml
+++ b/.github/workflows/frontend-tests.yml
@@ -39,12 +39,17 @@ jobs:
runs-on: ubuntu-latest
timeout-minutes: 10 # expected run time: <2 min
steps:
- - uses: actions/checkout@v4
+ - uses: actions/checkout@v6
- name: check for changed frontend files
if: ${{ inputs.always_run != true }}
id: changed-files
- uses: tj-actions/changed-files@v42
+ # Pinned to the _hash_ for v45.0.9 to prevent supply-chain attacks.
+ # See:
+ # - CVE-2025-30066
+ # - https://www.stepsecurity.io/blog/harden-runner-detection-tj-actions-changed-files-action-is-compromised
+ # - https://github.com/tj-actions/changed-files/issues/2463
+ uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96
with:
files_yaml: |
frontend:
diff --git a/.github/workflows/label-pr.yml b/.github/workflows/label-pr.yml
index 1a98512190a..b7689b12021 100644
--- a/.github/workflows/label-pr.yml
+++ b/.github/workflows/label-pr.yml
@@ -10,9 +10,9 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: checkout
- uses: actions/checkout@v4
+ uses: actions/checkout@v6
- name: label PRs
- uses: actions/labeler@v5
+ uses: actions/labeler@v6
with:
configuration-path: .github/pr_labels.yml
diff --git a/.github/workflows/lfs-checks.yml b/.github/workflows/lfs-checks.yml
new file mode 100644
index 00000000000..a3b845025a8
--- /dev/null
+++ b/.github/workflows/lfs-checks.yml
@@ -0,0 +1,30 @@
+# Checks that large files and LFS-tracked files are properly checked in with pointer format.
+# Uses https://github.com/ppremk/lfs-warning to detect LFS issues.
+
+name: 'lfs checks'
+
+on:
+ push:
+ branches:
+ - 'main'
+ pull_request:
+ types:
+ - 'ready_for_review'
+ - 'opened'
+ - 'synchronize'
+ merge_group:
+ workflow_dispatch:
+
+jobs:
+ lfs-check:
+ runs-on: ubuntu-latest
+ timeout-minutes: 5
+ permissions:
+ # Required to label and comment on the PRs
+ pull-requests: write
+ steps:
+ - name: checkout
+ uses: actions/checkout@v6
+
+ - name: check lfs files
+ uses: ppremk/lfs-warning@v3.3
diff --git a/.github/workflows/mkdocs-material.yml b/.github/workflows/mkdocs-material.yml
deleted file mode 100644
index 419d87f37bb..00000000000
--- a/.github/workflows/mkdocs-material.yml
+++ /dev/null
@@ -1,49 +0,0 @@
-# This is a mostly a copy-paste from https://github.com/squidfunk/mkdocs-material/blob/master/docs/publishing-your-site.md
-
-name: mkdocs
-
-on:
- push:
- branches:
- - main
- workflow_dispatch:
-
-permissions:
- contents: write
-
-jobs:
- deploy:
- if: github.event.pull_request.draft == false
- runs-on: ubuntu-latest
- env:
- REPO_URL: '${{ github.server_url }}/${{ github.repository }}'
- REPO_NAME: '${{ github.repository }}'
- SITE_URL: 'https://${{ github.repository_owner }}.github.io/InvokeAI'
-
- steps:
- - name: checkout
- uses: actions/checkout@v4
-
- - name: setup python
- uses: actions/setup-python@v5
- with:
- python-version: '3.10'
- cache: pip
- cache-dependency-path: pyproject.toml
-
- - name: set cache id
- run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
-
- - name: use cache
- uses: actions/cache@v4
- with:
- key: mkdocs-material-${{ env.cache_id }}
- path: .cache
- restore-keys: |
- mkdocs-material-
-
- - name: install dependencies
- run: python -m pip install ".[docs]"
-
- - name: build & deploy
- run: mkdocs gh-deploy --force
diff --git a/.github/workflows/openapi-checks.yml b/.github/workflows/openapi-checks.yml
new file mode 100644
index 00000000000..a3512c581c9
--- /dev/null
+++ b/.github/workflows/openapi-checks.yml
@@ -0,0 +1,115 @@
+# Runs OpenAPI schema quality checks.
+# Checked-in OpenAPI schema should match the generated server schema.
+#
+# Checks for changes to files before running the checks.
+# If always_run is true, always runs the checks.
+
+name: 'openapi checks'
+
+on:
+ push:
+ branches:
+ - 'main'
+ pull_request:
+ types:
+ - 'ready_for_review'
+ - 'opened'
+ - 'synchronize'
+ merge_group:
+ workflow_dispatch:
+ inputs:
+ always_run:
+ description: 'Always run the checks'
+ required: true
+ type: boolean
+ default: true
+ workflow_call:
+ inputs:
+ always_run:
+ description: 'Always run the checks'
+ required: true
+ type: boolean
+ default: true
+
+jobs:
+ openapi-checks:
+ env:
+ # uv requires a venv by default - but for this, we can simply use the system python
+ UV_SYSTEM_PYTHON: 1
+ runs-on: ubuntu-22.04
+ timeout-minutes: 15 # expected run time: <5 min
+ steps:
+ - name: checkout
+ uses: actions/checkout@v4
+
+ - name: Free up more disk space on the runner
+ # https://github.com/actions/runner-images/issues/2840#issuecomment-1284059930
+ run: |
+ echo "----- Free space before cleanup"
+ df -h
+ sudo rm -rf /usr/share/dotnet
+ sudo rm -rf "$AGENT_TOOLSDIRECTORY"
+ if [ -f /mnt/swapfile ]; then
+ sudo swapoff /mnt/swapfile
+ sudo rm -rf /mnt/swapfile
+ fi
+ echo "----- Free space after cleanup"
+ df -h
+
+ - name: check for changed files
+ if: ${{ inputs.always_run != true }}
+ id: changed-files
+ # Pinned to the _hash_ for v45.0.9 to prevent supply-chain attacks.
+ # See:
+ # - CVE-2025-30066
+ # - https://www.stepsecurity.io/blog/harden-runner-detection-tj-actions-changed-files-action-is-compromised
+ # - https://github.com/tj-actions/changed-files/issues/2463
+ uses: tj-actions/changed-files@a284dc1814e3fd07f2e34267fc8f81227ed29fb8
+ with:
+ files_yaml: |
+ src:
+ - 'pyproject.toml'
+ - 'invokeai/**'
+
+ - name: setup uv
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ uses: astral-sh/setup-uv@v5
+ with:
+ version: '0.6.10'
+ enable-cache: true
+ python-version: '3.11'
+
+ - name: setup python
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ uses: actions/setup-python@v5
+ with:
+ python-version: '3.11'
+
+ - name: install dependencies
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ env:
+ UV_INDEX: ${{ matrix.extra-index-url }}
+ run: uv pip install --editable .
+
+ - name: install frontend dependencies
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ uses: ./.github/actions/install-frontend-deps
+
+ - name: copy schema
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ run: cp invokeai/frontend/web/openapi.json invokeai/frontend/web/openapi_orig.json
+ shell: bash
+
+ - name: generate schema
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ run: cd invokeai/frontend/web && uv run ../../../scripts/generate_openapi_schema.py > openapi.json && pnpm prettier --write openapi.json
+ shell: bash
+
+ - name: compare files
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ run: |
+ if ! diff invokeai/frontend/web/openapi.json invokeai/frontend/web/openapi_orig.json; then
+ echo "Files are different!";
+ exit 1;
+ fi
+ shell: bash
diff --git a/.github/workflows/python-checks.yml b/.github/workflows/python-checks.yml
index 94232e15768..b08bc611cec 100644
--- a/.github/workflows/python-checks.yml
+++ b/.github/workflows/python-checks.yml
@@ -34,16 +34,24 @@ on:
jobs:
python-checks:
+ env:
+ # uv requires a venv by default - but for this, we can simply use the system python
+ UV_SYSTEM_PYTHON: 1
runs-on: ubuntu-latest
timeout-minutes: 5 # expected run time: <1 min
steps:
- name: checkout
- uses: actions/checkout@v4
+ uses: actions/checkout@v6
- name: check for changed python files
if: ${{ inputs.always_run != true }}
id: changed-files
- uses: tj-actions/changed-files@v42
+ # Pinned to the _hash_ for v45.0.9 to prevent supply-chain attacks.
+ # See:
+ # - CVE-2025-30066
+ # - https://www.stepsecurity.io/blog/harden-runner-detection-tj-actions-changed-files-action-is-compromised
+ # - https://github.com/tj-actions/changed-files/issues/2463
+ uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96
with:
files_yaml: |
python:
@@ -52,25 +60,23 @@ jobs:
- '!invokeai/frontend/web/**'
- 'tests/**'
- - name: setup python
+ - name: setup uv
if: ${{ steps.changed-files.outputs.python_any_changed == 'true' || inputs.always_run == true }}
- uses: actions/setup-python@v5
+ uses: astral-sh/setup-uv@v8.1.0
with:
- python-version: '3.10'
- cache: pip
- cache-dependency-path: pyproject.toml
+ version: '0.6.10'
+ enable-cache: true
- - name: install ruff
+ - name: check pypi classifiers
if: ${{ steps.changed-files.outputs.python_any_changed == 'true' || inputs.always_run == true }}
- run: pip install ruff
- shell: bash
+ run: uv run --no-project scripts/check_classifiers.py ./pyproject.toml
- name: ruff check
if: ${{ steps.changed-files.outputs.python_any_changed == 'true' || inputs.always_run == true }}
- run: ruff check --output-format=github .
+ run: uv tool run ruff@0.11.2 check --output-format=github .
shell: bash
- name: ruff format
if: ${{ steps.changed-files.outputs.python_any_changed == 'true' || inputs.always_run == true }}
- run: ruff format --check .
+ run: uv tool run ruff@0.11.2 format --check .
shell: bash
diff --git a/.github/workflows/python-tests.yml b/.github/workflows/python-tests.yml
index 8805989a69b..67351c2b387 100644
--- a/.github/workflows/python-tests.yml
+++ b/.github/workflows/python-tests.yml
@@ -39,28 +39,19 @@ jobs:
strategy:
matrix:
python-version:
- - '3.10'
- '3.11'
+ - '3.12'
platform:
- - linux-cuda-11_7
- - linux-rocm-5_2
- linux-cpu
- macos-default
- windows-cpu
include:
- - platform: linux-cuda-11_7
- os: ubuntu-22.04
- github-env: $GITHUB_ENV
- - platform: linux-rocm-5_2
- os: ubuntu-22.04
- extra-index-url: 'https://download.pytorch.org/whl/rocm5.2'
- github-env: $GITHUB_ENV
- platform: linux-cpu
- os: ubuntu-22.04
+ os: ubuntu-24.04
extra-index-url: 'https://download.pytorch.org/whl/cpu'
github-env: $GITHUB_ENV
- platform: macos-default
- os: macOS-12
+ os: macOS-14
github-env: $GITHUB_ENV
- platform: windows-cpu
os: windows-2022
@@ -70,14 +61,21 @@ jobs:
timeout-minutes: 15 # expected run time: 2-6 min, depending on platform
env:
PIP_USE_PEP517: '1'
+
steps:
- name: checkout
- uses: actions/checkout@v4
+ # https://github.com/nschloe/action-cached-lfs-checkout
+ uses: nschloe/action-cached-lfs-checkout@385a8ecc719e50b8c71af6ab01a624b486b7c3bc
- name: check for changed python files
if: ${{ inputs.always_run != true }}
id: changed-files
- uses: tj-actions/changed-files@v42
+ # Pinned to the _hash_ for v45.0.9 to prevent supply-chain attacks.
+ # See:
+ # - CVE-2025-30066
+ # - https://www.stepsecurity.io/blog/harden-runner-detection-tj-actions-changed-files-action-is-compromised
+ # - https://github.com/tj-actions/changed-files/issues/2463
+ uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96
with:
files_yaml: |
python:
@@ -86,21 +84,20 @@ jobs:
- '!invokeai/frontend/web/**'
- 'tests/**'
- - name: setup python
+ - name: setup uv
if: ${{ steps.changed-files.outputs.python_any_changed == 'true' || inputs.always_run == true }}
- uses: actions/setup-python@v5
+ uses: astral-sh/setup-uv@v8.1.0
with:
+ version: '0.6.10'
+ enable-cache: true
python-version: ${{ matrix.python-version }}
- cache: pip
- cache-dependency-path: pyproject.toml
- name: install dependencies
if: ${{ steps.changed-files.outputs.python_any_changed == 'true' || inputs.always_run == true }}
env:
- PIP_EXTRA_INDEX_URL: ${{ matrix.extra-index-url }}
- run: >
- pip3 install --editable=".[test]"
+ UV_INDEX: ${{ matrix.extra-index-url }}
+ run: uv sync --no-progress --locked --extra test
- name: run pytest
if: ${{ steps.changed-files.outputs.python_any_changed == 'true' || inputs.always_run == true }}
- run: pytest
+ run: uv run --no-sync pytest
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 0f09c0b245d..30e87b53dcb 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -20,7 +20,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: checkout
- uses: actions/checkout@v4
+ uses: actions/checkout@v6
- name: check python version
uses: samuelcolvin/check-python-version@v4
@@ -49,7 +49,7 @@ jobs:
always_run: true
build:
- uses: ./.github/workflows/build-installer.yml
+ uses: ./.github/workflows/build-wheel.yml
publish-testpypi:
runs-on: ubuntu-latest
@@ -70,7 +70,7 @@ jobs:
id-token: write
steps:
- name: download distribution from build job
- uses: actions/download-artifact@v4
+ uses: actions/download-artifact@v8
with:
name: dist
path: dist/
@@ -99,7 +99,7 @@ jobs:
id-token: write
steps:
- name: download distribution from build job
- uses: actions/download-artifact@v4
+ uses: actions/download-artifact@v8
with:
name: dist
path: dist/
diff --git a/.github/workflows/typegen-checks.yml b/.github/workflows/typegen-checks.yml
new file mode 100644
index 00000000000..1f1f0b1042e
--- /dev/null
+++ b/.github/workflows/typegen-checks.yml
@@ -0,0 +1,115 @@
+# Runs typegen schema quality checks.
+# Frontend types should match the server.
+#
+# Checks for changes to files before running the checks.
+# If always_run is true, always runs the checks.
+
+name: 'typegen checks'
+
+on:
+ push:
+ branches:
+ - 'main'
+ pull_request:
+ types:
+ - 'ready_for_review'
+ - 'opened'
+ - 'synchronize'
+ merge_group:
+ workflow_dispatch:
+ inputs:
+ always_run:
+ description: 'Always run the checks'
+ required: true
+ type: boolean
+ default: true
+ workflow_call:
+ inputs:
+ always_run:
+ description: 'Always run the checks'
+ required: true
+ type: boolean
+ default: true
+
+jobs:
+ typegen-checks:
+ env:
+ # uv requires a venv by default - but for this, we can simply use the system python
+ UV_SYSTEM_PYTHON: 1
+ runs-on: ubuntu-22.04
+ timeout-minutes: 15 # expected run time: <5 min
+ steps:
+ - name: checkout
+ uses: actions/checkout@v6
+
+ - name: Free up more disk space on the runner
+ # https://github.com/actions/runner-images/issues/2840#issuecomment-1284059930
+ run: |
+ echo "----- Free space before cleanup"
+ df -h
+ sudo rm -rf /usr/share/dotnet
+ sudo rm -rf "$AGENT_TOOLSDIRECTORY"
+ if [ -f /mnt/swapfile ]; then
+ sudo swapoff /mnt/swapfile
+ sudo rm -rf /mnt/swapfile
+ fi
+ echo "----- Free space after cleanup"
+ df -h
+
+ - name: check for changed files
+ if: ${{ inputs.always_run != true }}
+ id: changed-files
+ # Pinned to the _hash_ for v45.0.9 to prevent supply-chain attacks.
+ # See:
+ # - CVE-2025-30066
+ # - https://www.stepsecurity.io/blog/harden-runner-detection-tj-actions-changed-files-action-is-compromised
+ # - https://github.com/tj-actions/changed-files/issues/2463
+ uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96
+ with:
+ files_yaml: |
+ src:
+ - 'pyproject.toml'
+ - 'invokeai/**'
+
+ - name: setup uv
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ uses: astral-sh/setup-uv@v8.1.0
+ with:
+ version: '0.6.10'
+ enable-cache: true
+ python-version: '3.11'
+
+ - name: setup python
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ uses: actions/setup-python@v6
+ with:
+ python-version: '3.11'
+
+ - name: install dependencies
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ env:
+ UV_INDEX: ${{ matrix.extra-index-url }}
+ run: uv pip install --editable .
+
+ - name: install frontend dependencies
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ uses: ./.github/actions/install-frontend-deps
+
+ - name: copy schema
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ run: cp invokeai/frontend/web/src/services/api/schema.ts invokeai/frontend/web/src/services/api/schema_orig.ts
+ shell: bash
+
+ - name: generate schema
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ run: cd invokeai/frontend/web && uv run ../../../scripts/generate_openapi_schema.py | pnpm typegen
+ shell: bash
+
+ - name: compare files
+ if: ${{ steps.changed-files.outputs.src_any_changed == 'true' || inputs.always_run == true }}
+ run: |
+ if ! diff invokeai/frontend/web/src/services/api/schema.ts invokeai/frontend/web/src/services/api/schema_orig.ts; then
+ echo "Files are different!";
+ exit 1;
+ fi
+ shell: bash
diff --git a/.github/workflows/uv-lock-checks.yml b/.github/workflows/uv-lock-checks.yml
new file mode 100644
index 00000000000..d57163165fb
--- /dev/null
+++ b/.github/workflows/uv-lock-checks.yml
@@ -0,0 +1,68 @@
+# Check the `uv` lockfile for consistency with `pyproject.toml`.
+#
+# If this check fails, you should run `uv lock` to update the lockfile.
+
+name: 'uv lock checks'
+
+on:
+ push:
+ branches:
+ - 'main'
+ pull_request:
+ types:
+ - 'ready_for_review'
+ - 'opened'
+ - 'synchronize'
+ merge_group:
+ workflow_dispatch:
+ inputs:
+ always_run:
+ description: 'Always run the checks'
+ required: true
+ type: boolean
+ default: true
+ workflow_call:
+ inputs:
+ always_run:
+ description: 'Always run the checks'
+ required: true
+ type: boolean
+ default: true
+
+jobs:
+ uv-lock-checks:
+ env:
+ # uv requires a venv by default - but for this, we can simply use the system python
+ UV_SYSTEM_PYTHON: 1
+ runs-on: ubuntu-latest
+ timeout-minutes: 5 # expected run time: <1 min
+ steps:
+ - name: checkout
+ uses: actions/checkout@v6
+
+ - name: check for changed python files
+ if: ${{ inputs.always_run != true }}
+ id: changed-files
+ # Pinned to the _hash_ for v45.0.9 to prevent supply-chain attacks.
+ # See:
+ # - CVE-2025-30066
+ # - https://www.stepsecurity.io/blog/harden-runner-detection-tj-actions-changed-files-action-is-compromised
+ # - https://github.com/tj-actions/changed-files/issues/2463
+ uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96
+ with:
+ files_yaml: |
+ uvlock-pyprojecttoml:
+ - 'pyproject.toml'
+ - 'uv.lock'
+
+ - name: setup uv
+ if: ${{ steps.changed-files.outputs.uvlock-pyprojecttoml_any_changed == 'true' || inputs.always_run == true }}
+ uses: astral-sh/setup-uv@v8.1.0
+ with:
+ version: '0.6.10'
+ enable-cache: true
+
+ - name: check lockfile
+ if: ${{ steps.changed-files.outputs.uvlock-pyprojecttoml_any_changed == 'true' || inputs.always_run == true }}
+ run: uv lock --locked # this will exit with 1 if the lockfile is not consistent with pyproject.toml
+ shell: bash
diff --git a/.gitignore b/.gitignore
index 29d27d78ed5..cc037f09abd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -79,9 +79,6 @@ instance/
# Scrapy stuff:
.scrapy
-# Sphinx documentation
-docs/_build/
-
# PyBuilder
.pybuilder/
target/
@@ -145,9 +142,6 @@ ENV/
# Rope project settings
.ropeproject
-# mkdocs documentation
-/site
-
# mypy
.mypy_cache/
.dmypy.json
@@ -179,7 +173,9 @@ cython_debug/
# Scratch folder
.scratch/
+worktrees/
.vscode/
+.zed/
# source installer files
installer/*zip
@@ -188,3 +184,9 @@ installer/install.sh
installer/update.bat
installer/update.sh
installer/InvokeAI-Installer/
+.aider*
+
+.claude/
+
+# Weblate configuration file
+weblate.ini
diff --git a/.nvmrc b/.nvmrc
new file mode 100644
index 00000000000..517f38666b4
--- /dev/null
+++ b/.nvmrc
@@ -0,0 +1 @@
+v22.14.0
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 6cff07a959b..f128557bc08 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -4,21 +4,29 @@ repos:
hooks:
- id: black
name: black
- stages: [commit]
+ stages: [pre-commit]
language: system
entry: black
types: [python]
- id: flake8
name: flake8
- stages: [commit]
+ stages: [pre-commit]
language: system
entry: flake8
types: [python]
- id: isort
name: isort
- stages: [commit]
+ stages: [pre-commit]
language: system
entry: isort
- types: [python]
\ No newline at end of file
+ types: [python]
+
+ - id: uvlock
+ name: uv lock
+ stages: [pre-commit]
+ language: system
+ entry: uv lock
+ files: ^pyproject\.toml$
+ pass_filenames: false
\ No newline at end of file
diff --git a/Makefile b/Makefile
index e858a89e2b3..9830f7167fc 100644
--- a/Makefile
+++ b/Makefile
@@ -11,24 +11,29 @@ help:
@echo "mypy Run mypy using the config in pyproject.toml to identify type mismatches and other coding errors"
@echo "mypy-all Run mypy ignoring the config in pyproject.tom but still ignoring missing imports"
@echo "test Run the unit tests."
- @echo "update-config-docstring Update the app's config docstring so mkdocs can autogenerate it correctly."
- @echo "frontend-install Install the pnpm modules needed for the front end"
- @echo "frontend-build Build the frontend in order to run on localhost:9090"
+ @echo "frontend-install Install the pnpm modules needed for the frontend"
+ @echo "frontend-build Build the frontend for localhost:9090"
+ @echo "frontend-test Run the frontend test suite once"
@echo "frontend-dev Run the frontend in developer mode on localhost:5173"
+ @echo "frontend-openapi Generate the OpenAPI schema"
@echo "frontend-typegen Generate types for the frontend from the OpenAPI schema"
- @echo "installer-zip Build the installer .zip file for the current version"
+ @echo "frontend-lint Run frontend checks and fixable lint/format steps"
+ @echo "wheel Build the wheel for the current version"
@echo "tag-release Tag the GitHub repository with the current version (use at release time only!)"
@echo "openapi Generate the OpenAPI schema for the app, outputting to stdout"
+ @echo "docs-install Install the pnpm modules needed for the docs site"
+ @echo "docs-dev Serve the astro starlight docs site with live reload"
+ @echo "docs-build Build the docs site for production"
+ @echo "docs-preview Preview the docs site locally"
# Runs ruff, fixing any safely-fixable errors and formatting
ruff:
- ruff check . --fix
- ruff format .
+ cd invokeai && uv tool run ruff@0.11.2 format
# Runs ruff, fixing all errors it can fix and formatting
ruff-unsafe:
ruff check . --fix --unsafe-fixes
- ruff format .
+ ruff format
# Runs mypy, using the config in pyproject.toml
mypy:
@@ -43,10 +48,6 @@ mypy-all:
test:
pytest ./tests
-# Update config docstring
-update-config-docstring:
- python scripts/update_config_docstring.py
-
# Install the pnpm modules needed for the front end
frontend-install:
rm -rf invokeai/frontend/web/node_modules
@@ -56,21 +57,52 @@ frontend-install:
frontend-build:
cd invokeai/frontend/web && pnpm build
+# Run the frontend test suite once
+frontend-test:
+ cd invokeai/frontend/web && pnpm run test:run
+
# Run the frontend in dev mode
frontend-dev:
cd invokeai/frontend/web && pnpm dev
+# Generate the OpenAPI Schema for the app
+frontend-openapi:
+ cd invokeai/frontend/web && \
+ python ../../../scripts/generate_openapi_schema.py > openapi.json && \
+ pnpm prettier --write openapi.json
+
frontend-typegen:
cd invokeai/frontend/web && python ../../../scripts/generate_openapi_schema.py | pnpm typegen
-# Installer zip file
-installer-zip:
- cd installer && ./create_installer.sh
+frontend-lint:
+ cd invokeai/frontend/web/src && \
+ pnpm lint:tsc && \
+ pnpm lint:dpdm && \
+ pnpm lint:eslint --fix && \
+ pnpm lint:prettier --write
+
+# Tag the release
+wheel:
+ cd scripts && ./build_wheel.sh
# Tag the release
tag-release:
- cd installer && ./tag_release.sh
+ cd scripts && ./tag_release.sh
# Generate the OpenAPI Schema for the app
openapi:
python scripts/generate_openapi_schema.py
+
+# Install the pnpm modules needed for the docs site
+docs-install:
+ cd docs && pnpm install
+
+# Serve the astro starlight docs site w/ live reload
+docs-dev:
+ cd docs && pnpm run dev
+
+docs-build:
+ cd docs && DEPLOY_TARGET='custom' pnpm run build
+
+docs-preview:
+ cd docs && pnpm run preview
diff --git a/README.md b/README.md
index 41de4882ee3..afc0211bd91 100644
--- a/README.md
+++ b/README.md
@@ -4,38 +4,33 @@
# Invoke - Professional Creative AI Tools for Visual Media
-#### To learn more about Invoke, or implement our Business solutions, visit [invoke.com]
-
[![discord badge]][discord link] [![latest release badge]][latest release link] [![github stars badge]][github stars link] [![github forks badge]][github forks link] [![CI checks on main badge]][CI checks on main link] [![latest commit to main badge]][latest commit to main link] [![github open issues badge]][github open issues link] [![github open prs badge]][github open prs link] [![translation status badge]][translation status link]
Invoke is a leading creative engine built to empower professionals and enthusiasts alike. Generate and create stunning visual media using the latest AI-driven technologies. Invoke offers an industry leading web-based UI, and serves as the foundation for multiple commercial products.
-[Installation and Updates][installation docs] - [Documentation and Tutorials][docs home] - [Bug Reports][github issues] - [Contributing][contributing docs]
-
-
+- Free to use under a commercially-friendly license
+- Download and install on compatible hardware
+- Generate, refine, iterate on images, and build workflows
-
-
-Python (and PyTorch) relies on the memory allocator from the C Standard Library (`libc`). On linux, with the GNU C Standard Library implementation (`glibc`), our memory access patterns have been observed to cause severe memory fragmentation.
-
-This fragmentation results in large amounts of memory that has been freed but can't be released back to the OS. Loading models from disk and moving them between CPU/CUDA seem to be the operations that contribute most to the fragmentation.
-
-This memory fragmentation issue can result in OOM crashes during frequent model switching, even if `ram` (the max RAM cache size) is set to a reasonable value (e.g. a OOM crash with `ram=16` on a system with 32GB of RAM).
-
-This problem may also exist on other OSes, and other `libc` implementations. But, at the time of writing, it has only been investigated on linux with `glibc`.
-
-To better understand how the `glibc` memory allocator works, see these references:
-
-- Basics:
-- Details:
-
-Note the differences between memory allocated as chunks in an arena vs. memory allocated with `mmap`. Under `glibc`'s default configuration, most model tensors get allocated as chunks in an arena making them vulnerable to the problem of fragmentation.
-
-[model install docs]: ../installation/050_INSTALLING_MODELS.md
-[system requirements]: ../installation/INSTALL_REQUIREMENTS.md
-[latest release]: https://github.com/invoke-ai/InvokeAI/releases/latest
-[create an issue]: https://github.com/invoke-ai/InvokeAI/issues
-[discord]: https://discord.gg/ZmtBAhwWhy
-[configuration docs]: ../features/CONFIGURATION.md
-[access token]: https://huggingface.co/docs/hub/security-tokens#how-to-manage-user-access-tokens
diff --git a/docs/help/SAMPLER_CONVERGENCE.md b/docs/help/SAMPLER_CONVERGENCE.md
deleted file mode 100644
index 61fdca7b9cc..00000000000
--- a/docs/help/SAMPLER_CONVERGENCE.md
+++ /dev/null
@@ -1,151 +0,0 @@
----
-title: Sampler Convergence
----
-
-# :material-palette-advanced: *Sampler Convergence*
-
-As features keep increasing, making the right choices for your needs can become increasingly difficult. What sampler to use? And for how many steps? Do you change the CFG value? Do you use prompt weighting? Do you allow variations?
-
-Even once you have a result, do you blend it with other images? Pass it through `img2img`? With what strength? Do you use inpainting to correct small details? Outpainting to extend cropped sections?
-
-The purpose of this series of documents is to help you better understand these tools, so you can make the best out of them. Feel free to contribute with your own findings!
-
-In this document, we will talk about sampler convergence.
-
-Looking for a short version? Here's a TL;DR in 3 tables.
-
-!!! note "Remember"
-
- - Results converge as steps (`-s`) are increased (except for `K_DPM_2_A` and `K_EULER_A`). Often at ≥ `-s100`, but may require ≥ `-s700`).
- - Producing a batch of candidate images at low (`-s8` to `-s30`) step counts can save you hours of computation.
- - `K_HEUN` and `K_DPM_2` converge in less steps (but are slower).
- - `K_DPM_2_A` and `K_EULER_A` incorporate a lot of creativity/variability.
-
-
-
-!!! tip "suggestions"
-
- For most use cases, `K_LMS`, `K_HEUN` and `K_DPM_2` are the best choices (the latter 2 run 0.5x as quick, but tend to converge 2x as quick as `K_LMS`). At very low steps (≤ `-s8`), `K_HEUN` and `K_DPM_2` are not recommended. Use `K_LMS` instead.
-
- For variability, use `K_EULER_A` (runs 2x as quick as `K_DPM_2_A`).
-
----
-
-### *Sampler results*
-
-Let's start by choosing a prompt and using it with each of our 8 samplers, running it for 10, 20, 30, 40, 50 and 100 steps.
-
-Anime. `"an anime girl" -W512 -H512 -C7.5 -S3031912972`
-
-
-
-### *Sampler convergence*
-
-Immediately, you can notice results tend to converge -that is, as `-s` (step) values increase, images look more and more similar until there comes a point where the image no longer changes.
-
-You can also notice how `DDIM` and `PLMS` eventually tend to converge to K-sampler results as steps are increased.
-Among K-samplers, `K_HEUN` and `K_DPM_2` seem to require the fewest steps to converge, and even at low step counts they are good indicators of the final result. And finally, `K_DPM_2_A` and `K_EULER_A` seem to do a bit of their own thing and don't keep much similarity with the rest of the samplers.
-
-### *Batch generation speedup*
-
-This realization is very useful because it means you don't need to create a batch of 100 images (`-n100`) at `-s100` to choose your favorite 2 or 3 images.
-You can produce the same 100 images at `-s10` to `-s30` using a K-sampler (since they converge faster), get a rough idea of the final result, choose your 2 or 3 favorite ones, and then run `-s100` on those images to polish some details.
-The latter technique is 3-8x as quick.
-
-!!! example
-
- At 60s per 100 steps.
-
- A) 60s * 100 images = 6000s (100 images at `-s100`, manually picking 3 favorites)
-
- B) 6s *100 images + 60s* 3 images = 780s (100 images at `-s10`, manually picking 3 favorites, and running those 3 at `-s100` to polish details)
-
- The result is __1 hour and 40 minutes__ for Variant A, vs __13 minutes__ for Variant B.
-
-### *Topic convergance*
-
-Now, these results seem interesting, but do they hold for other topics? How about nature? Food? People? Animals? Let's try!
-
-Nature. `"valley landscape wallpaper, d&d art, fantasy, painted, 4k, high detail, sharp focus, washed colors, elaborate excellent painted illustration" -W512 -H512 -C7.5 -S1458228930`
-
-
-
-With nature, you can see how initial results are even more indicative of final result -more so than with characters/people. `K_HEUN` and `K_DPM_2` are again the quickest indicators, almost right from the start. Results also converge faster (e.g. `K_HEUN` converged at `-s21`).
-
-Food. `"a hamburger with a bowl of french fries" -W512 -H512 -C7.5 -S4053222918`
-
-
-
-Again, `K_HEUN` and `K_DPM_2` take the fewest number of steps to be good indicators of the final result. `K_DPM_2_A` and `K_EULER_A` seem to incorporate a lot of creativity/variability, capable of producing rotten hamburgers, but also of adding lettuce to the mix. And they're the only samplers that produced an actual 'bowl of fries'!
-
-Animals. `"grown tiger, full body" -W512 -H512 -C7.5 -S3721629802`
-
-
-
-`K_HEUN` and `K_DPM_2` once again require the least number of steps to be indicative of the final result (around `-s30`), while other samplers are still struggling with several tails or malformed back legs.
-
-It also takes longer to converge (for comparison, `K_HEUN` required around 150 steps to converge). This is normal, as producing human/animal faces/bodies is one of the things the model struggles the most with. For these topics, running for more steps will often increase coherence within the composition.
-
-People. `"Ultra realistic photo, (Miranda Bloom-Kerr), young, stunning model, blue eyes, blond hair, beautiful face, intricate, highly detailed, smooth, art by artgerm and greg rutkowski and alphonse mucha, stained glass" -W512 -H512 -C7.5 -S2131956332`. This time, we will go up to 300 steps.
-
-
-
-Observing the results, it again takes longer for all samplers to converge (`K_HEUN` took around 150 steps), but we can observe good indicative results much earlier (see: `K_HEUN`). Conversely, `DDIM` and `PLMS` are still undergoing moderate changes (see: lace around her neck), even at `-s300`.
-
-In fact, as we can see in this other experiment, some samplers can take 700+ steps to converge when generating people.
-
-
-
-Note also the point of convergence may not be the most desirable state (e.g. I prefer an earlier version of the face, more rounded), but it will probably be the most coherent arms/hands/face attributes-wise. You can always merge different images with a photo editing tool and pass it through `img2img` to smoothen the composition.
-
-### *Sampler generation times*
-
-Once we understand the concept of sampler convergence, we must look into the performance of each sampler in terms of steps (iterations) per second, as not all samplers run at the same speed.
-
-
-
-Combining our results with the steps per second of each sampler, three choices come out on top: `K_LMS`, `K_HEUN` and `K_DPM_2` (where the latter two run 0.5x as quick but tend to converge 2x as quick as `K_LMS`). For creativity and a lot of variation between iterations, `K_EULER_A` can be a good choice (which runs 2x as quick as `K_DPM_2_A`).
-
-Additionally, image generation at very low steps (≤ `-s8`) is not recommended for `K_HEUN` and `K_DPM_2`. Use `K_LMS` instead.
-
-{ width=600}
-
-### *Three key points*
-
-Finally, it is relevant to mention that, in general, there are 3 important moments in the process of image formation as steps increase:
-
-* The (earliest) point at which an image becomes a good indicator of the final result (useful for batch generation at low step values, to then improve the quality/coherence of the chosen images via running the same prompt and seed for more steps).
-
-* The (earliest) point at which an image becomes coherent, even if different from the result if steps are increased (useful for batch generation at low step values, where quality/coherence is improved via techniques other than increasing the steps -e.g. via inpainting).
-
-* The point at which an image fully converges.
-
-Hence, remember that your workflow/strategy should define your optimal number of steps, even for the same prompt and seed (for example, if you seek full convergence, you may run `K_LMS` for `-s200` in the case of the red-haired girl, but `K_LMS` and `-s20`-taking one tenth the time- may do as well if your workflow includes adding small details, such as the missing shoulder strap, via `img2img`).
diff --git a/docs/help/diffusion.md b/docs/help/diffusion.md
deleted file mode 100644
index 7182a51d67f..00000000000
--- a/docs/help/diffusion.md
+++ /dev/null
@@ -1,27 +0,0 @@
-Taking the time to understand the diffusion process will help you to understand how to more effectively use InvokeAI.
-
-There are two main ways Stable Diffusion works - with images, and latents.
-
-Image space represents images in pixel form that you look at. Latent space represents compressed inputs. It’s in latent space that Stable Diffusion processes images. A VAE (Variational Auto Encoder) is responsible for compressing and encoding inputs into latent space, as well as decoding outputs back into image space.
-
-To fully understand the diffusion process, we need to understand a few more terms: UNet, CLIP, and conditioning.
-
-A U-Net is a model trained on a large number of latent images with with known amounts of random noise added. This means that the U-Net can be given a slightly noisy image and it will predict the pattern of noise needed to subtract from the image in order to recover the original.
-
-CLIP is a model that tokenizes and encodes text into conditioning. This conditioning guides the model during the denoising steps to produce a new image.
-
-The U-Net and CLIP work together during the image generation process at each denoising step, with the U-Net removing noise in such a way that the result is similar to images in the U-Net’s training set, while CLIP guides the U-Net towards creating images that are most similar to the prompt.
-
-
-When you generate an image using text-to-image, multiple steps occur in latent space:
-1. Random noise is generated at the chosen height and width. The noise’s characteristics are dictated by seed. This noise tensor is passed into latent space. We’ll call this noise A.
-2. Using a model’s U-Net, a noise predictor examines noise A, and the words tokenized by CLIP from your prompt (conditioning). It generates its own noise tensor to predict what the final image might look like in latent space. We’ll call this noise B.
-3. Noise B is subtracted from noise A in an attempt to create a latent image consistent with the prompt. This step is repeated for the number of sampler steps chosen.
-4. The VAE decodes the final latent image from latent space into image space.
-
-Image-to-image is a similar process, with only step 1 being different:
-1. The input image is encoded from image space into latent space by the VAE. Noise is then added to the input latent image. Denoising Strength dictates how many noise steps are added, and the amount of noise added at each step. A Denoising Strength of 0 means there are 0 steps and no noise added, resulting in an unchanged image, while a Denoising Strength of 1 results in the image being completely replaced with noise and a full set of denoising steps are performance. The process is then the same as steps 2-4 in the text-to-image process.
-
-Furthermore, a model provides the CLIP prompt tokenizer, the VAE, and a U-Net (where noise prediction occurs given a prompt and initial noise tensor).
-
-A noise scheduler (eg. DPM++ 2M Karras) schedules the subtraction of noise from the latent image across the sampler steps chosen (step 3 above). Less noise is usually subtracted at higher sampler steps.
diff --git a/docs/help/gettingStartedWithAI.md b/docs/help/gettingStartedWithAI.md
deleted file mode 100644
index 617bd604010..00000000000
--- a/docs/help/gettingStartedWithAI.md
+++ /dev/null
@@ -1,97 +0,0 @@
-# Getting Started with AI Image Generation
-
-New to image generation with AI? You’re in the right place!
-
-This is a high level walkthrough of some of the concepts and terms you’ll see as you start using InvokeAI. Please note, this is not an exhaustive guide and may be out of date due to the rapidly changing nature of the space.
-
-## Using InvokeAI
-
-### **Prompt Crafting**
-
-- Prompts are the basis of using InvokeAI, providing the models directions on what to generate. As a general rule of thumb, the more detailed your prompt is, the better your result will be.
-
- *To get started, here’s an easy template to use for structuring your prompts:*
-
-- Subject, Style, Quality, Aesthetic
- - **Subject:** What your image will be about. E.g. “a futuristic city with trains”, “penguins floating on icebergs”, “friends sharing beers”
- - **Style:** The style or medium in which your image will be in. E.g. “photograph”, “pencil sketch”, “oil paints”, or “pop art”, “cubism”, “abstract”
- - **Quality:** A particular aspect or trait that you would like to see emphasized in your image. E.g. "award-winning", "featured in {relevant set of high quality works}", "professionally acclaimed". Many people often use "masterpiece".
- - **Aesthetics:** The visual impact and design of the artwork. This can be colors, mood, lighting, setting, etc.
-- There are two prompt boxes: *Positive Prompt* & *Negative Prompt*.
- - A **Positive** Prompt includes words you want the model to reference when creating an image.
- - Negative Prompt is for anything you want the model to eliminate when creating an image. It doesn’t always interpret things exactly the way you would, but helps control the generation process. Always try to include a few terms - you can typically use lower quality image terms like “blurry” or “distorted” with good success.
-- Some examples prompts you can try on your own:
- - A detailed oil painting of a tranquil forest at sunset with vibrant+ colors and soft, golden light filtering through the trees
- - friends sharing beers in a busy city, realistic colored pencil sketch, twilight, masterpiece, bright, lively
-
-### Generation Workflows
-
-- Invoke offers a number of different workflows for interacting with models to produce images. Each is extremely powerful on its own, but together provide you an unparalleled way of producing high quality creative outputs that align with your vision.
- - **Text to Image:** The text to image tab focuses on the key workflow of using a prompt to generate a new image. It includes other features that help control the generation process as well.
- - **Image to Image:** With image to image, you provide an image as a reference (called the “initial image”), which provides more guidance around color and structure to the AI as it generates a new image. This is provided alongside the same features as Text to Image.
- - **Unified Canvas:** The Unified Canvas is an advanced AI-first image editing tool that is easy to use, but hard to master. Drag an image onto the canvas from your gallery in order to regenerate certain elements, edit content or colors (known as inpainting), or extend the image with an exceptional degree of consistency and clarity (called outpainting).
-
-### Improving Image Quality
-
-- Fine tuning your prompt - the more specific you are, the closer the image will turn out to what is in your head! Adding more details in the Positive Prompt or Negative Prompt can help add / remove pieces of your image to improve it - You can also use advanced techniques like upweighting and downweighting to control the influence of certain words. [Learn more here](https://invoke-ai.github.io/InvokeAI/features/PROMPTS/#prompt-syntax-features).
- - **Tip: If you’re seeing poor results, try adding the things you don’t like about the image to your negative prompt may help. E.g. distorted, low quality, unrealistic, etc.**
-- Explore different models - Other models can produce different results due to the data they’ve been trained on. Each model has specific language and settings it works best with; a model’s documentation is your friend here. Play around with some and see what works best for you!
-- Increasing Steps - The number of steps used controls how much time the model is given to produce an image, and depends on the “Scheduler” used. The schedule controls how each step is processed by the model. More steps tends to mean better results, but will take longer - We recommend at least 30 steps for most
-- Tweak and Iterate - Remember, it’s best to change one thing at a time so you know what is working and what isn't. Sometimes you just need to try a new image, and other times using a new prompt might be the ticket. For testing, consider turning off the “random” Seed - Using the same seed with the same settings will produce the same image, which makes it the perfect way to learn exactly what your changes are doing.
-- Explore Advanced Settings - InvokeAI has a full suite of tools available to allow you complete control over your image creation process - Check out our [docs if you want to learn more](https://invoke-ai.github.io/InvokeAI/features/).
-
-
-## Terms & Concepts
-
-If you're interested in learning more, check out [this presentation](https://docs.google.com/presentation/d/1IO78i8oEXFTZ5peuHHYkVF-Y3e2M6iM5tCnc-YBfcCM/edit?usp=sharing) from one of our maintainers (@lstein).
-
-### Stable Diffusion
-
-Stable Diffusion is deep learning, text-to-image model that is the foundation of the capabilities found in InvokeAI. Since the release of Stable Diffusion, there have been many subsequent models created based on Stable Diffusion that are designed to generate specific types of images.
-
-### Prompts
-
-Prompts provide the models directions on what to generate. As a general rule of thumb, the more detailed your prompt is, the better your result will be.
-
-### Models
-
-Models are the magic that power InvokeAI. These files represent the output of training a machine on understanding massive amounts of images - providing them with the capability to generate new images using just a text description of what you’d like to see. (Like Stable Diffusion!)
-
-Invoke offers a simple way to download several different models upon installation, but many more can be discovered online, including at https://models.invoke.ai
-
-Each model can produce a unique style of output, based on the images it was trained on - Try out different models to see which best fits your creative vision!
-
-- *Models that contain “inpainting” in the name are designed for use with the inpainting feature of the Unified Canvas*
-
-### Scheduler
-
-Schedulers guide the process of removing noise (de-noising) from data. They determine:
-
-1. The number of steps to take to remove the noise.
-2. Whether the steps are random (stochastic) or predictable (deterministic).
-3. The specific method (algorithm) used for de-noising.
-
-Experimenting with different schedulers is recommended as each will produce different outputs!
-
-### Steps
-
-The number of de-noising steps each generation through.
-
-Schedulers can be intricate and there's often a balance to strike between how quickly they can de-noise data and how well they can do it. It's typically advised to experiment with different schedulers to see which one gives the best results. There has been a lot written on the internet about different schedulers, as well as exploring what the right level of "steps" are for each. You can save generation time by reducing the number of steps used, but you'll want to make sure that you are satisfied with the quality of images produced!
-
-### Low-Rank Adaptations / LoRAs
-
-Low-Rank Adaptations (LoRAs) are like a smaller, more focused version of models, intended to focus on training a better understanding of how a specific character, style, or concept looks.
-
-### Textual Inversion Embeddings
-
-Textual Inversion Embeddings, like LoRAs, assist with more easily prompting for certain characters, styles, or concepts. However, embeddings are trained to update the relationship between a specific word (known as the “trigger”) and the intended output.
-
-### ControlNet
-
-ControlNets are neural network models that are able to extract key features from an existing image and use these features to guide the output of the image generation model.
-
-### VAE
-
-Variational auto-encoder (VAE) is a encode/decode model that translates the "latents" image produced during the image generation procees to the large pixel images that we see.
-
diff --git a/docs/img/favicon.ico b/docs/img/favicon.ico
deleted file mode 100644
index 16a72bebcbb..00000000000
Binary files a/docs/img/favicon.ico and /dev/null differ
diff --git a/docs/index.md b/docs/index.md
deleted file mode 100644
index d55d6a14f8f..00000000000
--- a/docs/index.md
+++ /dev/null
@@ -1,181 +0,0 @@
----
-title: Home
----
-
-
-
-
-
-
-
-
-
-
-
-
-[](https://github.com/invoke-ai/InvokeAI)
-
-[![discord badge]][discord link]
-
-[![latest release badge]][latest release link]
-[![github stars badge]][github stars link]
-[![github forks badge]][github forks link]
-
-
-
-[![github open issues badge]][github open issues link]
-[![github open prs badge]][github open prs link]
-
-[ci checks on dev badge]:
- https://flat.badgen.net/github/checks/invoke-ai/InvokeAI/development?label=CI%20status%20on%20dev&cache=900&icon=github
-[ci checks on dev link]:
- https://github.com/invoke-ai/InvokeAI/actions?query=branch%3Adevelopment
-[ci checks on main badge]:
- https://flat.badgen.net/github/checks/invoke-ai/InvokeAI/main?label=CI%20status%20on%20main&cache=900&icon=github
-[ci checks on main link]:
- https://github.com/invoke-ai/InvokeAI/actions/workflows/test-invoke-conda.yml
-[discord badge]: https://flat.badgen.net/discord/members/ZmtBAhwWhy?icon=discord
-[discord link]: https://discord.gg/ZmtBAhwWhy
-[github forks badge]:
- https://flat.badgen.net/github/forks/invoke-ai/InvokeAI?icon=github
-[github forks link]:
- https://useful-forks.github.io/?repo=lstein%2Fstable-diffusion
-[github open issues badge]:
- https://flat.badgen.net/github/open-issues/invoke-ai/InvokeAI?icon=github
-[github open issues link]:
- https://github.com/invoke-ai/InvokeAI/issues?q=is%3Aissue+is%3Aopen
-[github open prs badge]:
- https://flat.badgen.net/github/open-prs/invoke-ai/InvokeAI?icon=github
-[github open prs link]:
- https://github.com/invoke-ai/InvokeAI/pulls?q=is%3Apr+is%3Aopen
-[github stars badge]:
- https://flat.badgen.net/github/stars/invoke-ai/InvokeAI?icon=github
-[github stars link]: https://github.com/invoke-ai/InvokeAI/stargazers
-
-[latest release badge]:
- https://flat.badgen.net/github/release/invoke-ai/InvokeAI/development?icon=github
-[latest release link]: https://github.com/invoke-ai/InvokeAI/releases
-
-
-
-InvokeAI is an
-implementation of Stable Diffusion, the open source text-to-image and
-image-to-image generator. It provides a streamlined process with various new
-features and options to aid the image generation process. It runs on Windows,
-Mac and Linux machines, and runs on GPU cards with as little as 4 GB of RAM.
-
-
-
-## :octicons-link-24: Quick Links
-
-
-
-
-
-
-
-
-
-
-
-
-
-## :octicons-gift-24: InvokeAI Features
-
-### Installation
- - [Automated Installer](installation/010_INSTALL_AUTOMATED.md)
- - [Manual Installation](installation/020_INSTALL_MANUAL.md)
- - [Docker Installation](installation/040_INSTALL_DOCKER.md)
-
-### The InvokeAI Web Interface
-- [WebUI overview](features/WEB.md)
-- [WebUI hotkey reference guide](features/WEBUIHOTKEYS.md)
-- [WebUI Unified Canvas for Img2Img, inpainting and outpainting](features/UNIFIED_CANVAS.md)
-
-
-
-### Image Management
-- [Image2Image](features/IMG2IMG.md)
-- [Adding custom styles and subjects](features/CONCEPTS.md)
-- [Upscaling and Face Reconstruction](features/POSTPROCESS.md)
-- [Other Features](features/OTHER.md)
-
-
-### Model Management
-- [Installing](installation/050_INSTALLING_MODELS.md)
-- [Model Merging](features/MODEL_MERGING.md)
-- [ControlNet Models](features/CONTROLNET.md)
-- [Style/Subject Concepts and Embeddings](features/CONCEPTS.md)
-- [Watermarking and the Not Safe for Work (NSFW) Checker](features/WATERMARK+NSFW.md)
-
-### Prompt Engineering
-- [Prompt Syntax](features/PROMPTS.md)
-
-### InvokeAI Configuration
-- [Guide to InvokeAI Runtime Settings](features/CONFIGURATION.md)
-- [Database Maintenance and other Command Line Utilities](features/UTILITIES.md)
-
-## :material-target: Troubleshooting
-
-Please check out our **[:material-frequently-asked-questions:
-FAQ](help/FAQ/)** to
-get solutions for common installation problems and other issues.
-
-## :octicons-repo-push-24: Contributing
-
-Anyone who wishes to contribute to this project, whether documentation,
-features, bug fixes, code cleanup, testing, or code reviews, is very much
-encouraged to do so.
-
-[Please take a look at our Contribution documentation to learn more about contributing to InvokeAI.
-](contributing/CONTRIBUTING.md)
-
-## :octicons-person-24: Contributors
-
-This software is a combined effort of various people from across the world.
-[Check out the list of all these amazing people](other/CONTRIBUTORS.md). We
-thank them for their time, hard work and effort.
-
-## :octicons-question-24: Support
-
-For support, please use this repository's GitHub Issues tracking service. Feel
-free to send me an email if you use and like the script.
-
-Original portions of the software are Copyright (c) 2022-23
-by [The InvokeAI Team](https://github.com/invoke-ai).
-
diff --git a/docs/installation/010_INSTALL_AUTOMATED.md b/docs/installation/010_INSTALL_AUTOMATED.md
deleted file mode 100644
index 3c6c90afdcf..00000000000
--- a/docs/installation/010_INSTALL_AUTOMATED.md
+++ /dev/null
@@ -1,107 +0,0 @@
-# Automatic Install & Updates
-
-**The same packaged installer file can be used for both new installs and updates.**
-Using the installer for updates will leave everything you've added since installation, and just update the core libraries used to run Invoke.
-Simply use the same path you installed to originally.
-
-Both release and pre-release versions can be installed using the installer. It also supports install through a wheel if needed.
-
-Be sure to review the [installation requirements] and ensure your system has everything it needs to install Invoke.
-
-## Getting the Latest Installer
-
-Download the `InvokeAI-installer-vX.Y.Z.zip` file from the [latest release] page. It is at the bottom of the page, under **Assets**.
-
-After unzipping the installer, you should have a `InvokeAI-Installer` folder with some files inside, including `install.bat` and `install.sh`.
-
-## Running the Installer
-
-!!! tip
-
- Windows users should first double-click the `WinLongPathsEnabled.reg` file to prevent a failed installation due to long file paths.
-
-Double-click the install script:
-
-=== "Windows"
-
- ```sh
- install.bat
- ```
-
-=== "Linux/macOS"
-
- ```sh
- install.sh
- ```
-
-!!! info "Running the Installer from the commandline"
-
- You can also run the install script from cmd/powershell (Windows) or terminal (Linux/macOS).
-
-!!! warning "Untrusted Publisher (Windows)"
-
- You may get a popup saying the file comes from an `Untrusted Publisher`. Click `More Info` and `Run Anyway` to get past this.
-
-The installation process is simple, with a few prompts:
-
-- Select the version to install. Unless you have a specific reason to install a specific version, select the default (the latest version).
-- Select location for the install. Be sure you have enough space in this folder for the base application, as described in the [installation requirements].
-- Select a GPU device.
-
-!!! info "Slow Installation"
-
- The installer needs to download several GB of data and install it all. It may appear to get stuck at 99.9% when installing `pytorch` or during a step labeled "Installing collected packages".
-
- If it is stuck for over 10 minutes, something has probably gone wrong and you should close the window and restart.
-
-## Running the Application
-
-Find the install location you selected earlier. Double-click the launcher script to run the app:
-
-=== "Windows"
-
- ```sh
- invoke.bat
- ```
-
-=== "Linux/macOS"
-
- ```sh
- invoke.sh
- ```
-
-Choose the first option to run the UI. After a series of startup messages, you'll see something like this:
-
-```
-Uvicorn running on http://127.0.0.1:9090 (Press CTRL+C to quit)
-```
-
-Copy the URL into your browser and you should see the UI.
-
-## First-time Setup
-
-You will need to [install some models] before you can generate.
-
-Check the [configuration docs] for details on configuring the application.
-
-## Updating
-
-Updating is exactly the same as installing - download the latest installer, choose the latest version and off you go.
-
-!!! info "Dependency Resolution Issues"
-
- We've found that pip's dependency resolution can cause issues when upgrading packages. One very common problem was pip "downgrading" torch from CUDA to CPU, but things broke in other novel ways.
-
- The installer doesn't have this kind of problem, so we use it for updating as well.
-
-## Installation Issues
-
-If you have installation issues, please review the [FAQ]. You can also [create an issue] or ask for help on [discord].
-
-[installation requirements]: INSTALL_REQUIREMENTS.md
-[FAQ]: ../help/FAQ.md
-[install some models]: 050_INSTALLING_MODELS.md
-[configuration docs]: ../features/CONFIGURATION.md
-[latest release]: https://github.com/invoke-ai/InvokeAI/releases/latest
-[create an issue]: https://github.com/invoke-ai/InvokeAI/issues
-[discord]: https://discord.gg/ZmtBAhwWhy
diff --git a/docs/installation/020_INSTALL_MANUAL.md b/docs/installation/020_INSTALL_MANUAL.md
deleted file mode 100644
index 059834eb453..00000000000
--- a/docs/installation/020_INSTALL_MANUAL.md
+++ /dev/null
@@ -1,119 +0,0 @@
-# Manual Install
-
-!!! warning "This is for Advanced Users"
-
- **Python experience is mandatory.**
-
-## Introduction
-
-InvokeAI is distributed as a python package on PyPI, installable with `pip`. There are a few things that are handled by the installer and launcher that you'll need to manage manually, described in this guide.
-
-### Requirements
-
-Before you start, go through the [installation requirements](./INSTALL_REQUIREMENTS.md).
-
-### Installation Walkthrough
-
-1. Create a directory to contain your InvokeAI library, configuration
- files, and models. This is known as the "runtime" or "root"
- directory, and often lives in your home directory under the name `invokeai`.
-
- We will refer to this directory as `INVOKEAI_ROOT`. For convenience, create an environment variable pointing to the directory.
-
- === "Linux/macOS"
-
- ```bash
- export INVOKEAI_ROOT=~/invokeai
- mkdir $INVOKEAI_ROOT
- ```
-
- === "Windows (PowerShell)"
-
- ```bash
- Set-Variable -Name INVOKEAI_ROOT -Value $Home/invokeai
- mkdir $INVOKEAI_ROOT
- ```
-
-1. Enter the root (invokeai) directory and create a virtual Python environment within it named `.venv`.
-
- !!! warning "Virtual Environment Location"
-
- While you may create the virtual environment anywhere in the file system, we recommend that you create it within the root directory as shown here. This allows the application to automatically detect its data directories.
-
- If you choose a different location for the venv, then you _must_ set the `INVOKEAI_ROOT` environment variable or specify the root directory using the `--root` CLI arg.
-
- ```terminal
- cd $INVOKEAI_ROOT
- python3 -m venv .venv --prompt InvokeAI
- ```
-
-1. Activate the new environment:
-
- === "Linux/macOS"
-
- ```bash
- source .venv/bin/activate
- ```
-
- === "Windows"
-
- ```ps
- .venv\Scripts\activate
- ```
-
- !!! info "Permissions Error (Windows)"
-
- If you get a permissions error at this point, run this command and try again
-
- `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
-
- The command-line prompt should change to to show `(InvokeAI)` at the beginning of the prompt.
-
- The following steps should be run while inside the `INVOKEAI_ROOT` directory.
-
-1. Make sure that pip is installed in your virtual environment and up to date:
-
- ```bash
- python3 -m pip install --upgrade pip
- ```
-
-1. Install the InvokeAI Package. The base command is `pip install InvokeAI --use-pep517`, but you may need to change this depending on your system and the desired features.
-
- - You may need to provide an [extra index URL](https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-extra-index-url). Select your platform configuration using [this tool on the PyTorch website](https://pytorch.org/get-started/locally/). Copy the `--extra-index-url` string from this and append it to your install command.
-
- !!! example "Install with an extra index URL"
-
- ```bash
- pip install InvokeAI --use-pep517 --extra-index-url https://download.pytorch.org/whl/cu121
- ```
-
- - If you have a CUDA GPU and want to install with `xformers`, you need to add an option to the package name. Note that `xformers` is not necessary. PyTorch includes an implementation of the SDP attention algorithm with the same performance.
-
- !!! example "Install with `xformers`"
-
- ```bash
- pip install "InvokeAI[xformers]" --use-pep517
- ```
-
-1. Deactivate and reactivate your runtime directory so that the invokeai-specific commands become available in the environment:
-
- === "Linux/macOS"
-
- ```bash
- deactivate && source .venv/bin/activate
- ```
-
- === "Windows"
-
- ```ps
- deactivate
- .venv\Scripts\activate
- ```
-
-1. Run the application:
-
- Run `invokeai-web` to start the UI. You must activate the virtual environment before running the app.
-
- !!! warning
-
- If the virtual environment is _not_ inside the root directory, then you _must_ specify the path to the root directory with `--root \path\to\invokeai` or the `INVOKEAI_ROOT` environment variable.
diff --git a/docs/installation/040_INSTALL_DOCKER.md b/docs/installation/040_INSTALL_DOCKER.md
deleted file mode 100644
index 3814b72e80e..00000000000
--- a/docs/installation/040_INSTALL_DOCKER.md
+++ /dev/null
@@ -1,112 +0,0 @@
----
-title: Installing with Docker
----
-
-# :fontawesome-brands-docker: Docker
-
-!!! warning "macOS and AMD GPU Users"
-
- We highly recommend to Install InvokeAI locally using [these instructions](INSTALLATION.md),
- because Docker containers can not access the GPU on macOS.
-
-!!! warning "AMD GPU Users"
-
- Container support for AMD GPUs has been reported to work by the community, but has not received
- extensive testing. Please make sure to set the `GPU_DRIVER=rocm` environment variable (see below), and
- use the `build.sh` script to build the image for this to take effect at build time.
-
-!!! tip "Linux and Windows Users"
-
- For optimal performance, configure your Docker daemon to access your machine's GPU.
- Docker Desktop on Windows [includes GPU support](https://www.docker.com/blog/wsl-2-gpu-support-for-docker-desktop-on-nvidia-gpus/).
- Linux users should install and configure the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html)
-
-## Why containers?
-
-They provide a flexible, reliable way to build and deploy InvokeAI.
-See [Processes](https://12factor.net/processes) under the Twelve-Factor App
-methodology for details on why running applications in such a stateless fashion is important.
-
-The container is configured for CUDA by default, but can be built to support AMD GPUs
-by setting the `GPU_DRIVER=rocm` environment variable at Docker image build time.
-
-Developers on Apple silicon (M1/M2/M3): You
-[can't access your GPU cores from Docker containers](https://github.com/pytorch/pytorch/issues/81224)
-and performance is reduced compared with running it directly on macOS but for
-development purposes it's fine. Once you're done with development tasks on your
-laptop you can build for the target platform and architecture and deploy to
-another environment with NVIDIA GPUs on-premises or in the cloud.
-
-## TL;DR
-
-This assumes properly configured Docker on Linux or Windows/WSL2. Read on for detailed customization options.
-
- ```bash
- # docker compose commands should be run from the `docker` directory
- cd docker
- docker compose up
- ```
-
-## Installation in a Linux container (desktop)
-
-### Prerequisites
-
-#### Install [Docker](https://github.com/santisbon/guides#docker)
-
-On the [Docker Desktop app](https://docs.docker.com/get-docker/), go to
-Preferences, Resources, Advanced. Increase the CPUs and Memory to avoid this
-[Issue](https://github.com/invoke-ai/InvokeAI/issues/342). You may need to
-increase Swap and Disk image size too.
-
-#### Get a Huggingface-Token
-
-Besides the Docker Agent you will need an Account on
-[huggingface.co](https://huggingface.co/join).
-
-After you succesfully registered your account, go to
-[huggingface.co/settings/tokens](https://huggingface.co/settings/tokens), create
-a token and copy it, since you will need in for the next step.
-
-### Setup
-
-Set up your environmnent variables. In the `docker` directory, make a copy of `.env.sample` and name it `.env`. Make changes as necessary.
-
-Any environment variables supported by InvokeAI can be set here - please see the [CONFIGURATION](../features/CONFIGURATION.md) for further detail.
-
-At a minimum, you might want to set the `INVOKEAI_ROOT` environment variable
-to point to the location where you wish to store your InvokeAI models, configuration, and outputs.
-
-
-
-| Environment-Variable | Default value | Description |
-| ----------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `INVOKEAI_ROOT` | `~/invokeai` | **Required** - the location of your InvokeAI root directory. It will be created if it does not exist.
-| `HUGGING_FACE_HUB_TOKEN` | | InvokeAI will work without it, but some of the integrations with HuggingFace (like downloading from models from private repositories) may not work|
-| `GPU_DRIVER` | `cuda` | Optionally change this to `rocm` to build the image for AMD GPUs. NOTE: Use the `build.sh` script to build the image for this to take effect.
-
-
-
-#### Build the Image
-
-Use the standard `docker compose build` command from within the `docker` directory.
-
-If using an AMD GPU:
- a: set the `GPU_DRIVER=rocm` environment variable in `docker-compose.yml` and continue using `docker compose build` as usual, or
- b: set `GPU_DRIVER=rocm` in the `.env` file and use the `build.sh` script, provided for convenience
-
-#### Run the Container
-
-Use the standard `docker compose up` command, and generally the `docker compose` [CLI](https://docs.docker.com/compose/reference/) as usual.
-
-Once the container starts up (and configures the InvokeAI root directory if this is a new installation), you can access InvokeAI at [http://localhost:9090](http://localhost:9090)
-
-## Troubleshooting / FAQ
-
-- Q: I am running on Windows under WSL2, and am seeing a "no such file or directory" error.
-- A: Your `docker-entrypoint.sh` file likely has Windows (CRLF) as opposed to Unix (LF) line endings,
- and you may have cloned this repository before the issue was fixed. To solve this, please change
- the line endings in the `docker-entrypoint.sh` file to `LF`. You can do this in VSCode
- (`Ctrl+P` and search for "line endings"), or by using the `dos2unix` utility in WSL.
- Finally, you may delete `docker-entrypoint.sh` followed by `git pull; git checkout docker/docker-entrypoint.sh`
- to reset the file to its most recent version.
- For more information on this issue, please see the [Docker Desktop documentation](https://docs.docker.com/desktop/troubleshoot/topics/#avoid-unexpected-syntax-errors-use-unix-style-line-endings-for-files-in-containers)
diff --git a/docs/installation/050_INSTALLING_MODELS.md b/docs/installation/050_INSTALLING_MODELS.md
deleted file mode 100644
index 360a5043d39..00000000000
--- a/docs/installation/050_INSTALLING_MODELS.md
+++ /dev/null
@@ -1,52 +0,0 @@
-# Installing Models
-
-## Checkpoint and Diffusers Models
-
-The model checkpoint files (`*.ckpt`) are the Stable Diffusion "secret sauce". They are the product of training the AI on millions of captioned images gathered from multiple sources.
-
-Originally there was only a single Stable Diffusion weights file, which many people named `model.ckpt`.
-
-Today, there are thousands of models, fine tuned to excel at specific styles, genres, or themes.
-
-!!! tip "Model Formats"
-
- We also have two more popular model formats, both created [HuggingFace](https://huggingface.co/):
-
- - `safetensors`: Single file, like `.ckpt` files. Prevents malware from lurking in a model.
- - `diffusers`: Splits the model components into separate files, allowing very fast loading.
-
- InvokeAI supports all three formats. Our backend will convert models to `diffusers` format before running them. This is a transparent process.
-
-## Starter Models
-
-When you first start InvokeAI, you'll see a popup prompting you to install some starter models from the Model Manager. Click the `Starter Models` tab to see the list.
-
-You'll find a collection of popular and high-quality models available for easy download.
-
-Some models carry license terms that limit their use in commercial applications or on public servers. It's your responsibility to adhere to the license terms.
-
-## Other Models
-
-You can install other models using the Model Manager. You'll find tabs for the following install methods:
-
-- **URL or Local Path**: Provide the path to a model on your computer, or a direct link to the model. Some sites require you to use an API token to download models, which you can [set up in the config file].
-- **HuggingFace**: Paste a HF Repo ID to install it. If there are multiple models in the repo, you'll get a list to choose from. Repo IDs look like this: `XpucT/Deliberate`. There is a copy button on each repo to copy the ID.
-- **Scan Folder**: Scan a local folder for models. You can install all of the detected models in one click.
-
-!!! tip "Autoimport"
-
- The dedicated autoimport folder is removed as of v4.0.0. You can do the same thing on the **Scan Folder** tab - paste the folder you'd like to import from and then click `Install All`.
-
-### Diffusers models in HF repo subfolders
-
-HuggingFace repos can be structured in any way. Some model authors include multiple models within the same folder.
-
-In this situation, you may need to provide some additional information to identify the model you want, by adding `:subfolder_name` to the repo ID.
-
-!!! example
-
- Say you have a repo ID `monster-labs/control_v1p_sd15_qrcode_monster`, and the model you want is inside the `v2` subfolder.
-
- Add `:v2` to the repo ID and use that when installing the model: `monster-labs/control_v1p_sd15_qrcode_monster:v2`
-
-[set up in the config file]: ../../features/CONFIGURATION#model-marketplace-api-keys
diff --git a/docs/installation/060_INSTALL_PATCHMATCH.md b/docs/installation/060_INSTALL_PATCHMATCH.md
deleted file mode 100644
index a9646f8b607..00000000000
--- a/docs/installation/060_INSTALL_PATCHMATCH.md
+++ /dev/null
@@ -1,110 +0,0 @@
----
-title: Installing PyPatchMatch
----
-
-# :material-image-size-select-large: Installing PyPatchMatch
-
-pypatchmatch is a Python module for inpainting images. It is not needed to run
-InvokeAI, but it greatly improves the quality of inpainting and outpainting and
-is recommended.
-
-Unfortunately, it is a C++ optimized module and installation can be somewhat
-challenging. This guide leads you through the steps.
-
-## Windows
-
-You're in luck! On Windows platforms PyPatchMatch will install automatically on
-Windows systems with no extra intervention.
-
-## Macintosh
-
-You need to have opencv installed so that pypatchmatch can be built:
-
-```bash
-brew install opencv
-```
-
-The next time you start `invoke`, after successfully installing opencv, pypatchmatch will be built.
-
-## Linux
-
-Prior to installing PyPatchMatch, you need to take the following steps:
-
-### Debian Based Distros
-
-1. Install the `build-essential` tools:
-
- ```sh
- sudo apt update
- sudo apt install build-essential
- ```
-
-2. Install `opencv`:
-
- ```sh
- sudo apt install python3-opencv libopencv-dev
- ```
-
-3. Activate the environment you use for invokeai, either with `conda` or with a
- virtual environment.
-
-4. Install pypatchmatch:
-
- ```sh
- pip install pypatchmatch
- ```
-
-5. Confirm that pypatchmatch is installed. At the command-line prompt enter
- `python`, and then at the `>>>` line type
- `from patchmatch import patch_match`: It should look like the following:
-
- ```py
- Python 3.10.12 (main, Jun 11 2023, 05:26:28) [GCC 11.4.0] on linux
- Type "help", "copyright", "credits" or "license" for more information.
- >>> from patchmatch import patch_match
- Compiling and loading c extensions from "/home/lstein/Projects/InvokeAI/.invokeai-env/src/pypatchmatch/patchmatch".
- rm -rf build/obj libpatchmatch.so
- mkdir: created directory 'build/obj'
- mkdir: created directory 'build/obj/csrc/'
- [dep] csrc/masked_image.cpp ...
- [dep] csrc/nnf.cpp ...
- [dep] csrc/inpaint.cpp ...
- [dep] csrc/pyinterface.cpp ...
- [CC] csrc/pyinterface.cpp ...
- [CC] csrc/inpaint.cpp ...
- [CC] csrc/nnf.cpp ...
- [CC] csrc/masked_image.cpp ...
- [link] libpatchmatch.so ...
- ```
-
-### Arch Based Distros
-
-1. Install the `base-devel` package:
-
- ```sh
- sudo pacman -Syu
- sudo pacman -S --needed base-devel
- ```
-
-2. Install `opencv` and `blas`:
-
- ```sh
- sudo pacman -S opencv blas
- ```
-
- or for CUDA support
-
- ```sh
- sudo pacman -S opencv-cuda blas
- ```
-
-3. Fix the naming of the `opencv` package configuration file:
-
- ```sh
- cd /usr/lib/pkgconfig/
- ln -sf opencv4.pc opencv.pc
- ```
-
-[**Next, Follow Steps 4-6 from the Debian Section above**](#linux)
-
-If you see no errors you're ready to go!
diff --git a/docs/installation/INSTALLATION.md b/docs/installation/INSTALLATION.md
deleted file mode 100644
index 267376f197c..00000000000
--- a/docs/installation/INSTALLATION.md
+++ /dev/null
@@ -1,48 +0,0 @@
-# Installation and Updating Overview
-
-Before installing, review the [installation requirements] to ensure your system is set up properly.
-
-See the [FAQ] for frequently-encountered installation issues.
-
-If you need more help, join our [discord] or [create an issue].
-
-
Automatic Install & Updates
-
-✅ The automatic install is the best way to run InvokeAI. Check out the [installation guide] to get started.
-
-⬆️ The same installer is also the best way to update InvokeAI - Simply rerun it for the same folder you installed to.
-
-The installation process simply manages installation for the core libraries & application dependencies that run Invoke.
-Any models, images, or other assets in the Invoke root folder won't be affected by the installation process.
-
-
Manual Install
-
-If you are familiar with python and want more control over the packages that are installed, you can [install InvokeAI manually via PyPI].
-
-Updates are managed by reinstalling the latest version through PyPi.
-
-
Developer Install
-
-If you want to contribute to InvokeAI, consult the [developer install guide].
-
-
Docker Install
-
-This method is recommended for those familiar with running Docker containers.
-
-We offer a method for creating Docker containers containing InvokeAI and its dependencies. This method is recommended for individuals with experience with Docker containers and understand the pluses and minuses of a container-based install.
-
-See the [docker installation guide].
-
-
Other Installation Guides
-
-- [PyPatchMatch](060_INSTALL_PATCHMATCH.md)
-- [Installing Models](050_INSTALLING_MODELS.md)
-
-[install InvokeAI manually via PyPI]: 020_INSTALL_MANUAL.md
-[developer install guide]: INSTALL_DEVELOPMENT.md
-[docker installation guide]: 040_INSTALL_DOCKER.md
-[installation guide]: 010_INSTALL_AUTOMATED.md
-[FAQ]: ../help/FAQ.md
-[discord]: discord.gg/invoke-ai
-[create an issue]: https://github.com/invoke-ai/InvokeAI/issues
-[installation requirements]: INSTALL_REQUIREMENTS.md
diff --git a/docs/installation/INSTALL_DEVELOPMENT.md b/docs/installation/INSTALL_DEVELOPMENT.md
deleted file mode 100644
index ead6b3bc8d6..00000000000
--- a/docs/installation/INSTALL_DEVELOPMENT.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# Developer Install
-
-!!! warning
-
- InvokeAI uses a SQLite database. By running on `main`, you accept responsibility for your database. This
- means making regular backups (especially before pulling) and/or fixing it yourself in the event that a
- PR introduces a schema change.
-
- If you don't need persistent backend storage, you can use an ephemeral in-memory database by setting
- `use_memory_db: true` in your `invokeai.yaml` file. You'll also want to set `scan_models_on_startup: true`
- so that your models are registered on startup.
-
- If this is untenable, you should run the application via the official installer or a manual install of the
- python package from PyPI. These releases will not break your database.
-
-If you have an interest in how InvokeAI works, or you would like to add features or bugfixes, you are encouraged to install the source code for InvokeAI.
-
-!!! info "Why do I need the frontend toolchain?"
-
- The repo doesn't contain a build of the frontend. You'll be responsible for rebuilding it (or running it in dev mode) to use the app, as described in the [frontend dev toolchain] docs.
-
-
Installation
-
-1. [Fork and clone] the [InvokeAI repo].
-1. Follow the [manual installation] docs to create a new virtual environment for the development install.
- - Create a new folder outside the repo root for the installation and create the venv inside that folder.
- - When installing the InvokeAI package, add `-e` to the command so you get an [editable install].
-1. Install the [frontend dev toolchain] and do a production build of the UI as described.
-1. You can now run the app as described in the [manual installation] docs.
-
-As described in the [frontend dev toolchain] docs, you can run the UI using a dev server. If you do this, you won't need to continually rebuild the frontend. Instead, you run the dev server and use the app with the server URL it provides.
-
-[Fork and clone]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo
-[InvokeAI repo]: https://github.com/invoke-ai/InvokeAI
-[frontend dev toolchain]: ../contributing/frontend/OVERVIEW.md
-[manual installation]: ./020_INSTALL_MANUAL.md
-[editable install]: https://pip.pypa.io/en/latest/cli/pip_install/#cmdoption-e
diff --git a/docs/installation/INSTALL_REQUIREMENTS.md b/docs/installation/INSTALL_REQUIREMENTS.md
deleted file mode 100644
index 2279e7efb8a..00000000000
--- a/docs/installation/INSTALL_REQUIREMENTS.md
+++ /dev/null
@@ -1,181 +0,0 @@
-# Requirements
-
-## GPU
-
-!!! warning "Problematic Nvidia GPUs"
-
- We do not recommend these GPUs. They cannot operate with half precision, but have insufficient VRAM to generate 512x512 images at full precision.
-
- - NVIDIA 10xx series cards such as the 1080 TI
- - GTX 1650 series cards
- - GTX 1660 series cards
-
-Invoke runs best with a dedicated GPU, but will fall back to running on CPU, albeit much slower. You'll need a beefier GPU for SDXL.
-
-!!! example "Stable Diffusion 1.5"
-
- === "Nvidia"
-
- ```
- Any GPU with at least 4GB VRAM.
- ```
-
- === "AMD"
-
- ```
- Any GPU with at least 4GB VRAM. Linux only.
- ```
-
- === "Mac"
-
- ```
- Any Apple Silicon Mac with at least 8GB memory.
- ```
-
-!!! example "Stable Diffusion XL"
-
- === "Nvidia"
-
- ```
- Any GPU with at least 8GB VRAM.
- ```
-
- === "AMD"
-
- ```
- Any GPU with at least 16GB VRAM. Linux only.
- ```
-
- === "Mac"
-
- ```
- Any Apple Silicon Mac with at least 16GB memory.
- ```
-
-## RAM
-
-At least 12GB of RAM.
-
-## Disk
-
-SSDs will, of course, offer the best performance.
-
-The base application disk usage depends on the torch backend.
-
-!!! example "Disk"
-
- === "Nvidia (CUDA)"
-
- ```
- ~6.5GB
- ```
-
- === "AMD (ROCm)"
-
- ```
- ~12GB
- ```
-
- === "Mac (MPS)"
-
- ```
- ~3.5GB
- ```
-
-You'll need to set aside some space for images, depending on how much you generate. A couple GB is enough to get started.
-
-You'll need a good chunk of space for models. Even if you only install the most popular models and the usual support models (ControlNet, IP Adapter ,etc), you will quickly hit 50GB of models.
-
-!!! info "`tmpfs` on Linux"
-
- If your temporary directory is mounted as a `tmpfs`, ensure it has sufficient space.
-
-## Python
-
-Invoke requires python 3.10 or 3.11. If you don't already have one of these versions installed, we suggest installing 3.11, as it will be supported for longer.
-
-Check that your system has an up-to-date Python installed by running `python --version` in the terminal (Linux, macOS) or cmd/powershell (Windows).
-
-
Installing Python (Windows)
-
-- Install python 3.11 with [an official installer].
-- The installer includes an option to add python to your PATH. Be sure to enable this. If you missed it, re-run the installer, choose to modify an existing installation, and tick that checkbox.
-- You may need to install [Microsoft Visual C++ Redistributable].
-
-
Installing Python (macOS)
-
-- Install python 3.11 with [an official installer].
-- If model installs fail with a certificate error, you may need to run this command (changing the python version to match what you have installed): `/Applications/Python\ 3.10/Install\ Certificates.command`
-- If you haven't already, you will need to install the XCode CLI Tools by running `xcode-select --install` in a terminal.
-
-
Installing Python (Linux)
-
-- Follow the [linux install instructions], being sure to install python 3.11.
-- You'll need to install `libglib2.0-0` and `libgl1-mesa-glx` for OpenCV to work. For example, on a Debian system: `sudo apt update && sudo apt install -y libglib2.0-0 libgl1-mesa-glx`
-
-## Drivers
-
-If you have an Nvidia or AMD GPU, you may need to manually install drivers or other support packages for things to work well or at all.
-
-### Nvidia
-
-Run `nvidia-smi` on your system's command line to verify that drivers and CUDA are installed. If this command fails, or doesn't report versions, you will need to install drivers.
-
-Go to the [CUDA Toolkit Downloads] and carefully follow the instructions for your system to get everything installed.
-
-Confirm that `nvidia-smi` displays driver and CUDA versions after installation.
-
-#### Linux - via Nvidia Container Runtime
-
-An alternative to installing CUDA locally is to use the [Nvidia Container Runtime] to run the application in a container.
-
-#### Windows - Nvidia cuDNN DLLs
-
-An out-of-date cuDNN library can greatly hamper performance on 30-series and 40-series cards. Check with the community on discord to compare your `it/s` if you think you may need this fix.
-
-First, locate the destination for the DLL files and make a quick back up:
-
-1. Find your InvokeAI installation folder, e.g. `C:\Users\Username\InvokeAI\`.
-1. Open the `.venv` folder, e.g. `C:\Users\Username\InvokeAI\.venv` (you may need to show hidden files to see it).
-1. Navigate deeper to the `torch` package, e.g. `C:\Users\Username\InvokeAI\.venv\Lib\site-packages\torch`.
-1. Copy the `lib` folder inside `torch` and back it up somewhere.
-
-Next, download and copy the updated cuDNN DLLs:
-
-1. Go to .
-1. Create an account if needed and log in.
-1. Choose the newest version of cuDNN that works with your GPU architecture. Consult the [cuDNN support matrix] to determine the correct version for your GPU.
-1. Download the latest version and extract it.
-1. Find the `bin` folder, e.g. `cudnn-windows-x86_64-SOME_VERSION\bin`.
-1. Copy and paste the `.dll` files into the `lib` folder you located earlier. Replace files when prompted.
-
-If, after restarting the app, this doesn't improve your performance, either restore your back up or re-run the installer to reset `torch` back to its original state.
-
-### AMD
-
-!!! info "Linux Only"
-
- AMD GPUs are supported on Linux only, due to ROCm (the AMD equivalent of CUDA) support being Linux only.
-
-!!! warning "Bumps Ahead"
-
- While the application does run on AMD GPUs, there are occasional bumps related to spotty torch support.
-
-Run `rocm-smi` on your system's command line verify that drivers and ROCm are installed. If this command fails, or doesn't report versions, you will need to install them.
-
-Go to the [ROCm Documentation] and carefully follow the instructions for your system to get everything installed.
-
-Confirm that `rocm-smi` displays driver and CUDA versions after installation.
-
-#### Linux - via Docker Container
-
-An alternative to installing ROCm locally is to use a [ROCm docker container] to run the application in a container.
-
-[ROCm docker container]: https://github.com/ROCm/ROCm-docker
-[ROCm Documentation]: https://rocm.docs.amd.com/projects/install-on-linux/en/latest/tutorial/quick-start.html
-[cuDNN support matrix]: https://docs.nvidia.com/deeplearning/cudnn/support-matrix/index.html
-[Nvidia Container Runtime]: https://developer.nvidia.com/container-runtime
-[linux install instructions]: https://docs.python-guide.org/starting/install3/linux/
-[Microsoft Visual C++ Redistributable]: https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-170
-[an official installer]: https://www.python.org/downloads/release/python-3118/
-[CUDA Toolkit Downloads]: https://developer.nvidia.com/cuda-downloads
diff --git a/installer/lib/__init__.py b/docs/invoke-config.json
similarity index 100%
rename from installer/lib/__init__.py
rename to docs/invoke-config.json
diff --git a/docs/javascripts/init_kapa_widget.js b/docs/javascripts/init_kapa_widget.js
deleted file mode 100644
index 06885c464cd..00000000000
--- a/docs/javascripts/init_kapa_widget.js
+++ /dev/null
@@ -1,10 +0,0 @@
-document.addEventListener("DOMContentLoaded", function () {
- var script = document.createElement("script");
- script.src = "https://widget.kapa.ai/kapa-widget.bundle.js";
- script.setAttribute("data-website-id", "b5973bb1-476b-451e-8cf4-98de86745a10");
- script.setAttribute("data-project-name", "Invoke.AI");
- script.setAttribute("data-project-color", "#11213C");
- script.setAttribute("data-project-logo", "https://avatars.githubusercontent.com/u/113954515?s=280&v=4");
- script.async = true;
- document.head.appendChild(script);
-});
diff --git a/docs/javascripts/tablesort.js b/docs/javascripts/tablesort.js
deleted file mode 100644
index ceb1f94acdb..00000000000
--- a/docs/javascripts/tablesort.js
+++ /dev/null
@@ -1,7 +0,0 @@
-document$.subscribe(function() {
- var tables = document.querySelectorAll("article table:not([class])")
- tables.forEach(function(table) {
- new Tablesort(table)
- })
- })
-
\ No newline at end of file
diff --git a/docs/nodes/INVOCATION_API.md b/docs/nodes/INVOCATION_API.md
deleted file mode 100644
index 40dfca8d7db..00000000000
--- a/docs/nodes/INVOCATION_API.md
+++ /dev/null
@@ -1,63 +0,0 @@
-# Invocation API
-
-Each invocation's `invoke` method is provided a single arg - the Invocation
-Context.
-
-This object provides access to various methods, used to interact with the
-application. Loading and saving images, logging messages, etc.
-
-!!! warning ""
-
- This API may shift slightly until the release of v4.0.0 as we work through a few final updates to the Model Manager.
-
-```py
-class MyInvocation(BaseInvocation):
- ...
- def invoke(self, context: InvocationContext) -> ImageOutput:
- image_pil = context.images.get_pil(image_name)
- # Do something to the image
- image_dto = context.images.save(image_pil)
- # Log a message
- context.logger.info(f"Did something cool, image saved!")
- ...
-```
-
-The full API is documented below.
-
-## Invocation Mixins
-
-Two important mixins are provided to facilitate working with metadata and gallery boards.
-
-### `WithMetadata`
-
-Inherit from this class (in addition to `BaseInvocation`) to add a `metadata` input to your node. When you do this, you can access the metadata dict from `self.metadata` in the `invoke()` function.
-
-The dict will be populated via the node's input, and you can add any metadata you'd like to it. When you call `context.images.save()`, if the metadata dict has any data, it be automatically embedded in the image.
-
-### `WithBoard`
-
-Inherit from this class (in addition to `BaseInvocation`) to add a `board` input to your node. This renders as a drop-down to select a board. The user's selection will be accessible from `self.board` in the `invoke()` function.
-
-When you call `context.images.save()`, if a board was selected, the image will added to that board as it is saved.
-
-
-::: invokeai.app.services.shared.invocation_context.InvocationContext
- options:
- members: false
-
-::: invokeai.app.services.shared.invocation_context.ImagesInterface
-
-::: invokeai.app.services.shared.invocation_context.TensorsInterface
-
-::: invokeai.app.services.shared.invocation_context.ConditioningInterface
-
-::: invokeai.app.services.shared.invocation_context.ModelsInterface
-
-::: invokeai.app.services.shared.invocation_context.LoggerInterface
-
-::: invokeai.app.services.shared.invocation_context.ConfigInterface
-
-::: invokeai.app.services.shared.invocation_context.UtilInterface
-
-::: invokeai.app.services.shared.invocation_context.BoardsInterface
-
diff --git a/docs/nodes/NODES.md b/docs/nodes/NODES.md
deleted file mode 100644
index b7f7aa82ad4..00000000000
--- a/docs/nodes/NODES.md
+++ /dev/null
@@ -1,97 +0,0 @@
-# Using the Workflow Editor
-
-The workflow editor is a blank canvas allowing for the use of individual functions and image transformations to control the image generation workflow. Nodes take in inputs on the left side of the node, and return an output on the right side of the node. A node graph is composed of multiple nodes that are connected together to create a workflow. Nodes' inputs and outputs are connected by dragging connectors from node to node. Inputs and outputs are color coded for ease of use.
-
-If you're not familiar with Diffusion, take a look at our [Diffusion Overview.](../help/diffusion.md) Understanding how diffusion works will enable you to more easily use the Workflow Editor and build workflows to suit your needs.
-
-## Features
-
-### Workflow Library
-The Workflow Library enables you to save workflows to the Invoke database, allowing you to easily creating, modify and share workflows as needed.
-
-A curated set of workflows are provided by default - these are designed to help explain important nodes' usage in the Workflow Editor.
-
-
-
-### Linear View
-The Workflow Editor allows you to create a UI for your workflow, to make it easier to iterate on your generations.
-
-To add an input to the Linear UI, right click on the **input label** and select "Add to Linear View".
-
-The Linear UI View will also be part of the saved workflow, allowing you share workflows and enable other to use them, regardless of complexity.
-
-
-
-### Renaming Fields and Nodes
-Any node or input field can be renamed in the workflow editor. If the input field you have renamed has been added to the Linear View, the changed name will be reflected in the Linear View and the node.
-
-### Managing Nodes
-
-* Ctrl+C to copy a node
-* Ctrl+V to paste a node
-* Backspace/Delete to delete a node
-* Shift+Click to drag and select multiple nodes
-
-### Node Caching
-
-Nodes have a "Use Cache" option in their footer. This allows for performance improvements by using the previously cached values during the workflow processing.
-
-
-## Important Nodes & Concepts
-
-There are several node grouping concepts that can be examined with a narrow focus. These (and other) groupings can be pieced together to make up functional graph setups, and are important to understanding how groups of nodes work together as part of a whole. Note that the screenshots below aren't examples of complete functioning node graphs (see Examples).
-
-### Noise
-
-An initial noise tensor is necessary for the latent diffusion process. As a result, the Denoising node requires a noise node input.
-
-
-
-### Text Prompt Conditioning
-
-Conditioning is necessary for the latent diffusion process, whether empty or not. As a result, the Denoising node requires positive and negative conditioning inputs. Conditioning is reliant on a CLIP text encoder provided by the Model Loader node.
-
-
-
-### Image to Latents & VAE
-
-The ImageToLatents node takes in a pixel image and a VAE and outputs a latents. The LatentsToImage node does the opposite, taking in a latents and a VAE and outpus a pixel image.
-
-
-
-### Defined & Random Seeds
-
-It is common to want to use both the same seed (for continuity) and random seeds (for variety). To define a seed, simply enter it into the 'Seed' field on a noise node. Conversely, the RandomInt node generates a random integer between 'Low' and 'High', and can be used as input to the 'Seed' edge point on a noise node to randomize your seed.
-
-
-
-### ControlNet
-
-The ControlNet node outputs a Control, which can be provided as input to a Denoise Latents node. Depending on the type of ControlNet desired, ControlNet nodes usually require an image processor node, such as a Canny Processor or Depth Processor, which prepares an input image for use with ControlNet.
-
-
-
-### LoRA
-
-The Lora Loader node lets you load a LoRA and pass it as output.A LoRA provides fine-tunes to the UNet and text encoder weights that augment the base model’s image and text vocabularies.
-
-
-
-### Scaling
-
-Use the ImageScale, ScaleLatents, and Upscale nodes to upscale images and/or latent images. Upscaling is the process of enlarging an image and adding more detail. The chosen method differs across contexts. However, be aware that latents are already noisy and compressed at their original resolution; scaling an image could produce more detailed results.
-
-
-
-### Iteration + Multiple Images as Input
-
-Iteration is a common concept in any processing, and means to repeat a process with given input. In nodes, you're able to use the Iterate node to iterate through collections usually gathered by the Collect node. The Iterate node has many potential uses, from processing a collection of images one after another, to varying seeds across multiple image generations and more. This screenshot demonstrates how to collect several images and use them in an image generation workflow.
-
-
-
-### Batch / Multiple Image Generation + Random Seeds
-
-Batch or multiple image generation in the workflow editor is done using the RandomRange node. In this case, the 'Size' field represents the number of images to generate, meaning this example will generate 4 images. As RandomRange produces a collection of integers, we need to add the Iterate node to iterate through the collection. This noise can then be fed to the Denoise Latents node for it to iterate through the denoising process with the different seeds provided.
-
-
-
diff --git a/docs/nodes/NODES_MIGRATION_V3_V4.md b/docs/nodes/NODES_MIGRATION_V3_V4.md
deleted file mode 100644
index 3ba08545817..00000000000
--- a/docs/nodes/NODES_MIGRATION_V3_V4.md
+++ /dev/null
@@ -1,148 +0,0 @@
-# Invoke v4.0.0 Nodes API Migration guide
-
-Invoke v4.0.0 is versioned as such due to breaking changes to the API utilized
-by nodes, both core and custom.
-
-## Motivation
-
-Prior to v4.0.0, the `invokeai` python package has not be set up to be utilized
-as a library. That is to say, it didn't have any explicitly public API, and node
-authors had to work with the unstable internal application API.
-
-v4.0.0 introduces a stable public API for nodes.
-
-## Changes
-
-There are two node-author-facing changes:
-
-1. Import Paths
-1. Invocation Context API
-
-### Import Paths
-
-All public objects are now exported from `invokeai.invocation_api`:
-
-```py
-# Old
-from invokeai.app.invocations.baseinvocation import (
- BaseInvocation,
- InputField,
- InvocationContext,
- invocation,
-)
-from invokeai.app.invocations.primitives import ImageField
-
-# New
-from invokeai.invocation_api import (
- BaseInvocation,
- ImageField,
- InputField,
- InvocationContext,
- invocation,
-)
-```
-
-It's possible that we've missed some classes you need in your node. Please let
-us know if that's the case.
-
-### Invocation Context API
-
-Most nodes utilize the Invocation Context, an object that is passed to the
-`invoke` that provides access to data and services a node may need.
-
-Until now, that object and the services it exposed were internal. Exposing them
-to nodes means that changes to our internal implementation could break nodes.
-The methods on the services are also often fairly complicated and allowed nodes
-to footgun.
-
-In v4.0.0, this object has been refactored to be much simpler.
-
-See [INVOCATION_API](./INVOCATION_API.md) for full details of the API.
-
-!!! warning ""
-
- This API may shift slightly until the release of v4.0.0 as we work through a few final updates to the Model Manager.
-
-#### Improved Service Methods
-
-The biggest offender was the image save method:
-
-```py
-# Old
-image_dto = context.services.images.create(
- image=image,
- image_origin=ResourceOrigin.INTERNAL,
- image_category=ImageCategory.GENERAL,
- node_id=self.id,
- session_id=context.graph_execution_state_id,
- is_intermediate=self.is_intermediate,
- metadata=self.metadata,
- workflow=context.workflow,
-)
-
-# New
-image_dto = context.images.save(image=image)
-```
-
-Other methods are simplified, or enhanced with additional functionality:
-
-```py
-# Old
-image = context.services.images.get_pil_image(image_name)
-
-# New
-image = context.images.get_pil(image_name)
-image_cmyk = context.images.get_pil(image_name, "CMYK")
-```
-
-We also had some typing issues around tensors:
-
-```py
-# Old
-# `latents` typed as `torch.Tensor`, but could be `ConditioningFieldData`
-latents = context.services.latents.get(self.latents.latents_name)
-# `data` typed as `torch.Tenssor,` but could be `ConditioningFieldData`
-context.services.latents.save(latents_name, data)
-
-# New - separate methods for tensors and conditioning data w/ correct typing
-# Also, the service generates the names
-tensor_name = context.tensors.save(tensor)
-tensor = context.tensors.load(tensor_name)
-# For conditioning
-cond_name = context.conditioning.save(cond_data)
-cond_data = context.conditioning.load(cond_name)
-```
-
-#### Output Construction
-
-Core Outputs have builder functions right on them - no need to manually
-construct these objects, or use an extra utility:
-
-```py
-# Old
-image_output = ImageOutput(
- image=ImageField(image_name=image_dto.image_name),
- width=image_dto.width,
- height=image_dto.height,
-)
-latents_output = build_latents_output(latents_name=name, latents=latents, seed=None)
-noise_output = NoiseOutput(
- noise=LatentsField(latents_name=latents_name, seed=seed),
- width=latents.size()[3] * 8,
- height=latents.size()[2] * 8,
-)
-cond_output = ConditioningOutput(
- conditioning=ConditioningField(
- conditioning_name=conditioning_name,
- ),
-)
-
-# New
-image_output = ImageOutput.build(image_dto)
-latents_output = LatentsOutput.build(latents_name=name, latents=noise, seed=self.seed)
-noise_output = NoiseOutput.build(latents_name=name, latents=noise, seed=self.seed)
-cond_output = ConditioningOutput.build(conditioning_name)
-```
-
-You can still create the objects using constructors if you want, but we suggest
-using the builder methods.
diff --git a/docs/nodes/comfyToInvoke.md b/docs/nodes/comfyToInvoke.md
deleted file mode 100644
index 2d894dc74c9..00000000000
--- a/docs/nodes/comfyToInvoke.md
+++ /dev/null
@@ -1,80 +0,0 @@
-# ComfyUI to InvokeAI
-
-If you're coming to InvokeAI from ComfyUI, welcome! You'll find things are similar but different - the good news is that you already know how things should work, and it's just a matter of wiring them up!
-
-Some things to note:
-
-- InvokeAI's nodes tend to be more granular than default nodes in Comfy. This means each node in Invoke will do a specific task and you might need to use multiple nodes to achieve the same result. The added granularity improves the control you have have over your workflows.
-- InvokeAI's backend and ComfyUI's backend are very different which means Comfy workflows are not able to be imported into InvokeAI. However, we have created a [list of popular workflows](exampleWorkflows.md) for you to get started with Nodes in InvokeAI!
-
-## Node Equivalents:
-
-| Comfy UI Category | ComfyUI Node | Invoke Equivalent |
-|:---------------------------------- |:---------------------------------- | :----------------------------------|
-| Sampling |KSampler |Denoise Latents|
-| Sampling |Ksampler Advanced|Denoise Latents |
-| Loaders |Load Checkpoint | Main Model Loader _or_ SDXL Main Model Loader|
-| Loaders |Load VAE | VAE Loader |
-| Loaders |Load Lora | LoRA Loader _or_ SDXL Lora Loader|
-| Loaders |Load ControlNet Model | ControlNet|
-| Loaders |Load ControlNet Model (diff) | ControlNet|
-| Loaders |Load Style Model | Reference Only ControlNet will be coming in a future version of InvokeAI|
-| Loaders |unCLIPCheckpointLoader | N/A |
-| Loaders |GLIGENLoader | N/A |
-| Loaders |Hypernetwork Loader | N/A |
-| Loaders |Load Upscale Model | Occurs within "Upscale (RealESRGAN)"|
-|Conditioning |CLIP Text Encode (Prompt) | Compel (Prompt) or SDXL Compel (Prompt) |
-|Conditioning |CLIP Set Last Layer | CLIP Skip|
-|Conditioning |Conditioning (Average) | Use the .blend() feature of prompts |
-|Conditioning |Conditioning (Combine) | N/A |
-|Conditioning |Conditioning (Concat) | See the Prompt Tools Community Node|
-|Conditioning |Conditioning (Set Area) | N/A |
-|Conditioning |Conditioning (Set Mask) | Mask Edge |
-|Conditioning |CLIP Vision Encode | N/A |
-|Conditioning |unCLIPConditioning | N/A |
-|Conditioning |Apply ControlNet | ControlNet |
-|Conditioning |Apply ControlNet (Advanced) | ControlNet |
-|Latent |VAE Decode | Latents to Image|
-|Latent |VAE Encode | Image to Latents |
-|Latent |Empty Latent Image | Noise |
-|Latent |Upscale Latent |Resize Latents |
-|Latent |Upscale Latent By |Scale Latents |
-|Latent |Latent Composite | Blend Latents |
-|Latent |LatentCompositeMasked | N/A |
-|Image |Save Image | Image |
-|Image |Preview Image |Current |
-|Image |Load Image | Image|
-|Image |Empty Image| Blank Image |
-|Image |Invert Image | Invert Lerp Image |
-|Image |Batch Images | Link "Image" nodes into an "Image Collection" node |
-|Image |Pad Image for Outpainting | Outpainting is easily accomplished in the Unified Canvas |
-|Image |ImageCompositeMasked | Paste Image |
-|Image | Upscale Image | Resize Image |
-|Image | Upscale Image By | Upscale Image |
-|Image | Upscale Image (using Model) | Upscale Image |
-|Image | ImageBlur | Blur Image |
-|Image | ImageQuantize | N/A |
-|Image | ImageSharpen | N/A |
-|Image | Canny | Canny Processor |
-|Mask |Load Image (as Mask) | Image |
-|Mask |Convert Mask to Image | Image|
-|Mask |Convert Image to Mask | Image |
-|Mask |SolidMask | N/A |
-|Mask |InvertMask |Invert Lerp Image |
-|Mask |CropMask | Crop Image |
-|Mask |MaskComposite | Combine Mask |
-|Mask |FeatherMask | Blur Image |
-|Advanced | Load CLIP | Main Model Loader _or_ SDXL Main Model Loader|
-|Advanced | UNETLoader | Main Model Loader _or_ SDXL Main Model Loader|
-|Advanced | DualCLIPLoader | Main Model Loader _or_ SDXL Main Model Loader|
-|Advanced | Load Checkpoint | Main Model Loader _or_ SDXL Main Model Loader |
-|Advanced | ConditioningZeroOut | N/A |
-|Advanced | ConditioningSetTimestepRange | N/A |
-|Advanced | CLIPTextEncodeSDXLRefiner | Compel (Prompt) or SDXL Compel (Prompt) |
-|Advanced | CLIPTextEncodeSDXL |Compel (Prompt) or SDXL Compel (Prompt) |
-|Advanced | ModelMergeSimple | Model Merging is available in the Model Manager |
-|Advanced | ModelMergeBlocks | Model Merging is available in the Model Manager|
-|Advanced | CheckpointSave | Model saving is available in the Model Manager|
-|Advanced | CLIPMergeSimple | N/A |
-
-
diff --git a/docs/nodes/communityNodes.md b/docs/nodes/communityNodes.md
deleted file mode 100644
index 296fbb7ee61..00000000000
--- a/docs/nodes/communityNodes.md
+++ /dev/null
@@ -1,605 +0,0 @@
-# Community Nodes
-
-These are nodes that have been developed by the community, for the community. If you're not sure what a node is, you can learn more about nodes [here](overview.md).
-
-If you'd like to submit a node for the community, please refer to the [node creation overview](contributingNodes.md).
-
-To use a node, add the node to the `nodes` folder found in your InvokeAI install location.
-
-The suggested method is to use `git clone` to clone the repository the node is found in. This allows for easy updates of the node in the future.
-
-If you'd prefer, you can also just download the whole node folder from the linked repository and add it to the `nodes` folder.
-
-To use a community workflow, download the the `.json` node graph file and load it into Invoke AI via the **Load Workflow** button in the Workflow Editor.
-
-- Community Nodes
- + [Adapters-Linked](#adapters-linked-nodes)
- + [Autostereogram](#autostereogram-nodes)
- + [Average Images](#average-images)
- + [Clean Image Artifacts After Cut](#clean-image-artifacts-after-cut)
- + [Close Color Mask](#close-color-mask)
- + [Clothing Mask](#clothing-mask)
- + [Contrast Limited Adaptive Histogram Equalization](#contrast-limited-adaptive-histogram-equalization)
- + [Depth Map from Wavefront OBJ](#depth-map-from-wavefront-obj)
- + [Film Grain](#film-grain)
- + [Generative Grammar-Based Prompt Nodes](#generative-grammar-based-prompt-nodes)
- + [GPT2RandomPromptMaker](#gpt2randompromptmaker)
- + [Grid to Gif](#grid-to-gif)
- + [Halftone](#halftone)
- + [Hand Refiner with MeshGraphormer](#hand-refiner-with-meshgraphormer)
- + [Image and Mask Composition Pack](#image-and-mask-composition-pack)
- + [Image Dominant Color](#image-dominant-color)
- + [Image to Character Art Image Nodes](#image-to-character-art-image-nodes)
- + [Image Picker](#image-picker)
- + [Image Resize Plus](#image-resize-plus)
- + [Latent Upscale](#latent-upscale)
- + [Load Video Frame](#load-video-frame)
- + [Make 3D](#make-3d)
- + [Mask Operations](#mask-operations)
- + [Match Histogram](#match-histogram)
- + [Metadata-Linked](#metadata-linked-nodes)
- + [Negative Image](#negative-image)
- + [Nightmare Promptgen](#nightmare-promptgen)
- + [Oobabooga](#oobabooga)
- + [Prompt Tools](#prompt-tools)
- + [Remote Image](#remote-image)
- + [BriaAI Background Remove](#briaai-remove-background)
- + [Remove Background](#remove-background)
- + [Retroize](#retroize)
- + [Size Stepper Nodes](#size-stepper-nodes)
- + [Simple Skin Detection](#simple-skin-detection)
- + [Text font to Image](#text-font-to-image)
- + [Thresholding](#thresholding)
- + [Unsharp Mask](#unsharp-mask)
- + [XY Image to Grid and Images to Grids nodes](#xy-image-to-grid-and-images-to-grids-nodes)
-- [Example Node Template](#example-node-template)
-- [Disclaimer](#disclaimer)
-- [Help](#help)
-
-
---------------------------------
-### Adapters Linked Nodes
-
-**Description:** A set of nodes for linked adapters (ControlNet, IP-Adaptor & T2I-Adapter). This allows multiple adapters to be chained together without using a `collect` node which means it can be used inside an `iterate` node without any collecting on every iteration issues.
-
-- `ControlNet-Linked` - Collects ControlNet info to pass to other nodes.
-- `IP-Adapter-Linked` - Collects IP-Adapter info to pass to other nodes.
-- `T2I-Adapter-Linked` - Collects T2I-Adapter info to pass to other nodes.
-
-Note: These are inherited from the core nodes so any update to the core nodes should be reflected in these.
-
-**Node Link:** https://github.com/skunkworxdark/adapters-linked-nodes
-
---------------------------------
-### Autostereogram Nodes
-
-**Description:** Generate autostereogram images from a depth map. This is not a very practically useful node but more a 90s nostalgic indulgence as I used to love these images as a kid.
-
-**Node Link:** https://github.com/skunkworxdark/autostereogram_nodes
-
-**Example Usage:**
-
- -> ->
-
---------------------------------
-### Average Images
-
-**Description:** This node takes in a collection of images of the same size and averages them as output. It converts everything to RGB mode first.
-
-**Node Link:** https://github.com/JPPhoto/average-images-node
-
---------------------------------
-### Clean Image Artifacts After Cut
-
-Description: Removes residual artifacts after an image is separated from its background.
-
-Node Link: https://github.com/VeyDlin/clean-artifact-after-cut-node
-
-View:
-
-
---------------------------------
-### Close Color Mask
-
-Description: Generates a mask for images based on a closely matching color, useful for color-based selections.
-
-Node Link: https://github.com/VeyDlin/close-color-mask-node
-
-View:
-
-
---------------------------------
-### Clothing Mask
-
-Description: Employs a U2NET neural network trained for the segmentation of clothing items in images.
-
-Node Link: https://github.com/VeyDlin/clothing-mask-node
-
-View:
-
-
---------------------------------
-### Contrast Limited Adaptive Histogram Equalization
-
-Description: Enhances local image contrast using adaptive histogram equalization with contrast limiting.
-
-Node Link: https://github.com/VeyDlin/clahe-node
-
-View:
-
-
---------------------------------
-### Depth Map from Wavefront OBJ
-
-**Description:** Render depth maps from Wavefront .obj files (triangulated) using this simple 3D renderer utilizing numpy and matplotlib to compute and color the scene. There are simple parameters to change the FOV, camera position, and model orientation.
-
-To be imported, an .obj must use triangulated meshes, so make sure to enable that option if exporting from a 3D modeling program. This renderer makes each triangle a solid color based on its average depth, so it will cause anomalies if your .obj has large triangles. In Blender, the Remesh modifier can be helpful to subdivide a mesh into small pieces that work well given these limitations.
-
-**Node Link:** https://github.com/dwringer/depth-from-obj-node
-
-**Example Usage:**
-
-
---------------------------------
-### Film Grain
-
-**Description:** This node adds a film grain effect to the input image based on the weights, seeds, and blur radii parameters. It works with RGB input images only.
-
-**Node Link:** https://github.com/JPPhoto/film-grain-node
-
---------------------------------
-### Generative Grammar-Based Prompt Nodes
-
-**Description:** This set of 3 nodes generates prompts from simple user-defined grammar rules (loaded from custom files - examples provided below). The prompts are made by recursively expanding a special template string, replacing nonterminal "parts-of-speech" until no nonterminal terms remain in the string.
-
-This includes 3 Nodes:
-- *Lookup Table from File* - loads a YAML file "prompt" section (or of a whole folder of YAML's) into a JSON-ified dictionary (Lookups output)
-- *Lookups Entry from Prompt* - places a single entry in a new Lookups output under the specified heading
-- *Prompt from Lookup Table* - uses a Collection of Lookups as grammar rules from which to randomly generate prompts.
-
-**Node Link:** https://github.com/dwringer/generative-grammar-prompt-nodes
-
-**Example Usage:**
-
-
---------------------------------
-### GPT2RandomPromptMaker
-
-**Description:** A node for InvokeAI utilizes the GPT-2 language model to generate random prompts based on a provided seed and context.
-
-**Node Link:** https://github.com/mickr777/GPT2RandomPromptMaker
-
-**Output Examples**
-
-Generated Prompt: An enchanted weapon will be usable by any character regardless of their alignment.
-
-
-
---------------------------------
-### Grid to Gif
-
-**Description:** One node that turns a grid image into an image collection, one node that turns an image collection into a gif.
-
-**Node Link:** https://github.com/mildmisery/invokeai-GridToGifNode/blob/main/GridToGif.py
-
-**Example Node Graph:** https://github.com/mildmisery/invokeai-GridToGifNode/blob/main/Grid%20to%20Gif%20Example%20Workflow.json
-
-**Output Examples**
-
-
-
-
---------------------------------
-### Halftone
-
-**Description**: Halftone converts the source image to grayscale and then performs halftoning. CMYK Halftone converts the image to CMYK and applies a per-channel halftoning to make the source image look like a magazine or newspaper. For both nodes, you can specify angles and halftone dot spacing.
-
-**Node Link:** https://github.com/JPPhoto/halftone-node
-
-**Example**
-
-Input:
-
-
-
-Halftone Output:
-
-
-
-CMYK Halftone Output:
-
-
-
---------------------------------
-
-### Hand Refiner with MeshGraphormer
-
-**Description**: Hand Refiner takes in your image and automatically generates a fixed depth map for the hands along with a mask of the hands region that will conveniently allow you to use them along with ControlNet to fix the wonky hands generated by Stable Diffusion
-
-**Node Link:** https://github.com/blessedcoolant/invoke_meshgraphormer
-
-**View**
-
-
---------------------------------
-
-### Image and Mask Composition Pack
-
-**Description:** This is a pack of nodes for composing masks and images, including a simple text mask creator and both image and latent offset nodes. The offsets wrap around, so these can be used in conjunction with the Seamless node to progressively generate centered on different parts of the seamless tiling.
-
-This includes 15 Nodes:
-
-- *Adjust Image Hue Plus* - Rotate the hue of an image in one of several different color spaces.
-- *Blend Latents/Noise (Masked)* - Use a mask to blend part of one latents tensor [including Noise outputs] into another. Can be used to "renoise" sections during a multi-stage [masked] denoising process.
-- *Enhance Image* - Boost or reduce color saturation, contrast, brightness, sharpness, or invert colors of any image at any stage with this simple wrapper for pillow [PIL]'s ImageEnhance module.
-- *Equivalent Achromatic Lightness* - Calculates image lightness accounting for Helmholtz-Kohlrausch effect based on a method described by High, Green, and Nussbaum (2023).
-- *Text to Mask (Clipseg)* - Input a prompt and an image to generate a mask representing areas of the image matched by the prompt.
-- *Text to Mask Advanced (Clipseg)* - Output up to four prompt masks combined with logical "and", logical "or", or as separate channels of an RGBA image.
-- *Image Layer Blend* - Perform a layered blend of two images using alpha compositing. Opacity of top layer is selectable, with optional mask and several different blend modes/color spaces.
-- *Image Compositor* - Take a subject from an image with a flat backdrop and layer it on another image using a chroma key or flood select background removal.
-- *Image Dilate or Erode* - Dilate or expand a mask (or any image!). This is equivalent to an expand/contract operation.
-- *Image Value Thresholds* - Clip an image to pure black/white beyond specified thresholds.
-- *Offset Latents* - Offset a latents tensor in the vertical and/or horizontal dimensions, wrapping it around.
-- *Offset Image* - Offset an image in the vertical and/or horizontal dimensions, wrapping it around.
-- *Rotate/Flip Image* - Rotate an image in degrees clockwise/counterclockwise about its center, optionally resizing the image boundaries to fit, or flipping it about the vertical and/or horizontal axes.
-- *Shadows/Highlights/Midtones* - Extract three masks (with adjustable hard or soft thresholds) representing shadows, midtones, and highlights regions of an image.
-- *Text Mask (simple 2D)* - create and position a white on black (or black on white) line of text using any font locally available to Invoke.
-
-**Node Link:** https://github.com/dwringer/composition-nodes
-
-
-
---------------------------------
-### Image Dominant Color
-
-Description: Identifies and extracts the dominant color from an image using k-means clustering.
-
-Node Link: https://github.com/VeyDlin/image-dominant-color-node
-
-View:
-
-
---------------------------------
-### Image to Character Art Image Nodes
-
-**Description:** Group of nodes to convert an input image into ascii/unicode art Image
-
-**Node Link:** https://github.com/mickr777/imagetoasciiimage
-
-**Output Examples**
-
-
-
-
-
---------------------------------
-
-### Image Picker
-
-**Description:** This InvokeAI node takes in a collection of images and randomly chooses one. This can be useful when you have a number of poses to choose from for a ControlNet node, or a number of input images for another purpose.
-
-**Node Link:** https://github.com/JPPhoto/image-picker-node
-
---------------------------------
-### Image Resize Plus
-
-Description: Provides various image resizing options such as fill, stretch, fit, center, and crop.
-
-Node Link: https://github.com/VeyDlin/image-resize-plus-node
-
-View:
-
-
-
---------------------------------
-### Latent Upscale
-
-**Description:** This node uses a small (~2.4mb) model to upscale the latents used in a Stable Diffusion 1.5 or Stable Diffusion XL image generation, rather than the typical interpolation method, avoiding the traditional downsides of the latent upscale technique.
-
-**Node Link:** [https://github.com/gogurtenjoyer/latent-upscale](https://github.com/gogurtenjoyer/latent-upscale)
-
---------------------------------
-### Load Video Frame
-
-**Description:** This is a video frame image provider + indexer/video creation nodes for hooking up to iterators and ranges and ControlNets and such for invokeAI node experimentation. Think animation + ControlNet outputs.
-
-**Node Link:** https://github.com/helix4u/load_video_frame
-
-**Output Example:**
-
-
---------------------------------
-### Make 3D
-
-**Description:** Create compelling 3D stereo images from 2D originals.
-
-**Node Link:** [https://gitlab.com/srcrr/shift3d/-/raw/main/make3d.py](https://gitlab.com/srcrr/shift3d)
-
-**Example Node Graph:** https://gitlab.com/srcrr/shift3d/-/raw/main/example-workflow.json?ref_type=heads&inline=false
-
-**Output Examples**
-
-
-
-
---------------------------------
-### Mask Operations
-
-Description: Offers logical operations (OR, SUB, AND) for combining and manipulating image masks.
-
-Node Link: https://github.com/VeyDlin/mask-operations-node
-
-View:
-
-
---------------------------------
-### Match Histogram
-
-**Description:** An InvokeAI node to match a histogram from one image to another. This is a bit like the `color correct` node in the main InvokeAI but this works in the YCbCr colourspace and can handle images of different sizes. Also does not require a mask input.
-- Option to only transfer luminance channel.
-- Option to save output as grayscale
-
-A good use case for this node is to normalize the colors of an image that has been through the tiled scaling workflow of my XYGrid Nodes.
-
-See full docs here: https://github.com/skunkworxdark/Prompt-tools-nodes/edit/main/README.md
-
-**Node Link:** https://github.com/skunkworxdark/match_histogram
-
-**Output Examples**
-
-
-
---------------------------------
-### Metadata Linked Nodes
-
-**Description:** A set of nodes for Metadata. Collect Metadata from within an `iterate` node & extract metadata from an image.
-
-- `Metadata Item Linked` - Allows collecting of metadata while within an iterate node with no need for a collect node or conversion to metadata node
-- `Metadata From Image` - Provides Metadata from an image
-- `Metadata To String` - Extracts a String value of a label from metadata
-- `Metadata To Integer` - Extracts an Integer value of a label from metadata
-- `Metadata To Float` - Extracts a Float value of a label from metadata
-- `Metadata To Scheduler` - Extracts a Scheduler value of a label from metadata
-- `Metadata To Bool` - Extracts Bool types from metadata
-- `Metadata To Model` - Extracts model types from metadata
-- `Metadata To SDXL Model` - Extracts SDXL model types from metadata
-- `Metadata To LoRAs` - Extracts Loras from metadata.
-- `Metadata To SDXL LoRAs` - Extracts SDXL Loras from metadata
-- `Metadata To ControlNets` - Extracts ControNets from metadata
-- `Metadata To IP-Adapters` - Extracts IP-Adapters from metadata
-- `Metadata To T2I-Adapters` - Extracts T2I-Adapters from metadata
-- `Denoise Latents + Metadata` - This is an inherited version of the existing `Denoise Latents` node but with a metadata input and output.
-
-**Node Link:** https://github.com/skunkworxdark/metadata-linked-nodes
-
---------------------------------
-### Negative Image
-
-Description: Creates a negative version of an image, effective for visual effects and mask inversion.
-
-Node Link: https://github.com/VeyDlin/negative-image-node
-
-View:
-
-
---------------------------------
-### Nightmare Promptgen
-
-**Description:** Nightmare Prompt Generator - Uses a local text generation model to create unique imaginative (but usually nightmarish) prompts for InvokeAI. By default, it allows you to choose from some gpt-neo models I finetuned on over 2500 of my own InvokeAI prompts in Compel format, but you're able to add your own, as well. Offers support for replacing any troublesome words with a random choice from list you can also define.
-
-**Node Link:** [https://github.com/gogurtenjoyer/nightmare-promptgen](https://github.com/gogurtenjoyer/nightmare-promptgen)
-
---------------------------------
-### Oobabooga
-
-**Description:** asks a local LLM running in Oobabooga's Text-Generation-Webui to write a prompt based on the user input.
-
-**Link:** https://github.com/sammyf/oobabooga-node
-
-**Example:**
-
-"describe a new mystical creature in its natural environment"
-
-*can return*
-
-"The mystical creature I am describing to you is called the "Glimmerwing". It is a majestic, iridescent being that inhabits the depths of the most enchanted forests and glimmering lakes. Its body is covered in shimmering scales that reflect every color of the rainbow, and it has delicate, translucent wings that sparkle like diamonds in the sunlight. The Glimmerwing's home is a crystal-clear lake, surrounded by towering trees with leaves that shimmer like jewels. In this serene environment, the Glimmerwing spends its days swimming gracefully through the water, chasing schools of glittering fish and playing with the gentle ripples of the lake's surface.
-As the sun sets, the Glimmerwing perches on a branch of one of the trees, spreading its wings to catch the last rays of light. The creature's scales glow softly, casting a rainbow of colors across the forest floor. The Glimmerwing sings a haunting melody, its voice echoing through the stillness of the night air. Its song is said to have the power to heal the sick and bring peace to troubled souls. Those who are lucky enough to hear the Glimmerwing's song are forever changed by its beauty and grace."
-
-
-
-**Requirement**
-
-a Text-Generation-Webui instance (might work remotely too, but I never tried it) and obviously InvokeAI 3.x
-
-**Note**
-
-This node works best with SDXL models, especially as the style can be described independently of the LLM's output.
-
---------------------------------
-### Prompt Tools
-
-**Description:** A set of InvokeAI nodes that add general prompt (string) manipulation tools. Designed to accompany the `Prompts From File` node and other prompt generation nodes.
-
-1. `Prompt To File` - saves a prompt or collection of prompts to a file. one per line. There is an append/overwrite option.
-2. `PTFields Collect` - Converts image generation fields into a Json format string that can be passed to Prompt to file.
-3. `PTFields Expand` - Takes Json string and converts it to individual generation parameters. This can be fed from the Prompts to file node.
-4. `Prompt Strength` - Formats prompt with strength like the weighted format of compel
-5. `Prompt Strength Combine` - Combines weighted prompts for .and()/.blend()
-6. `CSV To Index String` - Gets a string from a CSV by index. Includes a Random index option
-
-The following Nodes are now included in v3.2 of Invoke and are nolonger in this set of tools.
-- `Prompt Join` -> `String Join`
-- `Prompt Join Three` -> `String Join Three`
-- `Prompt Replace` -> `String Replace`
-- `Prompt Split Neg` -> `String Split Neg`
-
-
-See full docs here: https://github.com/skunkworxdark/Prompt-tools-nodes/edit/main/README.md
-
-**Node Link:** https://github.com/skunkworxdark/Prompt-tools-nodes
-
-**Workflow Examples**
-
-
-
---------------------------------
-### Remote Image
-
-**Description:** This is a pack of nodes to interoperate with other services, be they public websites or bespoke local servers. The pack consists of these nodes:
-
-- *Load Remote Image* - Lets you load remote images such as a realtime webcam image, an image of the day, or dynamically created images.
-- *Post Image to Remote Server* - Lets you upload an image to a remote server using an HTTP POST request, eg for storage, display or further processing.
-
-**Node Link:** https://github.com/fieldOfView/InvokeAI-remote_image
-
---------------------------------
-
-### BriaAI Remove Background
-
-**Description**: Implements one click background removal with BriaAI's new version 1.4 model which seems to be be producing better results than any other previous background removal tool.
-
-**Node Link:** https://github.com/blessedcoolant/invoke_bria_rmbg
-
-**View**
-
-
---------------------------------
-### Remove Background
-
-Description: An integration of the rembg package to remove backgrounds from images using multiple U2NET models.
-
-Node Link: https://github.com/VeyDlin/remove-background-node
-
-View:
-
-
---------------------------------
-### Retroize
-
-**Description:** Retroize is a collection of nodes for InvokeAI to "Retroize" images. Any image can be given a fresh coat of retro paint with these nodes, either from your gallery or from within the graph itself. It includes nodes to pixelize, quantize, palettize, and ditherize images; as well as to retrieve palettes from existing images.
-
-**Node Link:** https://github.com/Ar7ific1al/invokeai-retroizeinode/
-
-**Retroize Output Examples**
-
-
-
---------------------------------
-### Simple Skin Detection
-
-Description: Detects skin in images based on predefined color thresholds.
-
-Node Link: https://github.com/VeyDlin/simple-skin-detection-node
-
-View:
-
-
-
---------------------------------
-### Size Stepper Nodes
-
-**Description:** This is a set of nodes for calculating the necessary size increments for doing upscaling workflows. Use the *Final Size & Orientation* node to enter your full size dimensions and orientation (portrait/landscape/random), then plug that and your initial generation dimensions into the *Ideal Size Stepper* and get 1, 2, or 3 intermediate pairs of dimensions for upscaling. Note this does not output the initial size or full size dimensions: the 1, 2, or 3 outputs of this node are only the intermediate sizes.
-
-A third node is included, *Random Switch (Integers)*, which is just a generic version of Final Size with no orientation selection.
-
-**Node Link:** https://github.com/dwringer/size-stepper-nodes
-
-**Example Usage:**
-
-
---------------------------------
-### Text font to Image
-
-**Description:** text font to text image node for InvokeAI, download a font to use (or if in font cache uses it from there), the text is always resized to the image size, but can control that with padding, optional 2nd line
-
-**Node Link:** https://github.com/mickr777/textfontimage
-
-**Output Examples**
-
-
-
-Results after using the depth controlnet
-
-
-
-
-
---------------------------------
-### Thresholding
-
-**Description:** This node generates masks for highlights, midtones, and shadows given an input image. You can optionally specify a blur for the lookup table used in making those masks from the source image.
-
-**Node Link:** https://github.com/JPPhoto/thresholding-node
-
-**Examples**
-
-Input:
-
-
-
-Highlights/Midtones/Shadows:
-
-
-
-
-
-Highlights/Midtones/Shadows (with LUT blur enabled):
-
-
-
-
-
---------------------------------
-### Unsharp Mask
-
-**Description:** Applies an unsharp mask filter to an image, preserving its alpha channel in the process.
-
-**Node Link:** https://github.com/JPPhoto/unsharp-mask-node
-
---------------------------------
-### XY Image to Grid and Images to Grids nodes
-
-**Description:** These nodes add the following to InvokeAI:
-- Generate grids of images from multiple input images
-- Create XY grid images with labels from parameters
-- Split images into overlapping tiles for processing (for super-resolution workflows)
-- Recombine image tiles into a single output image blending the seams
-
-The nodes include:
-1. `Images To Grids` - Combine multiple images into a grid of images
-2. `XYImage To Grid` - Take X & Y params and creates a labeled image grid.
-3. `XYImage Tiles` - Super-resolution (embiggen) style tiled resizing
-4. `Image Tot XYImages` - Takes an image and cuts it up into a number of columns and rows.
-5. Multiple supporting nodes - Helper nodes for data wrangling and building `XYImage` collections
-
-See full docs here: https://github.com/skunkworxdark/XYGrid_nodes/edit/main/README.md
-
-**Node Link:** https://github.com/skunkworxdark/XYGrid_nodes
-
-**Output Examples**
-
-
-
-
---------------------------------
-### Example Node Template
-
-**Description:** This node allows you to do super cool things with InvokeAI.
-
-**Node Link:** https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/app/invocations/prompt.py
-
-**Example Workflow:** https://github.com/invoke-ai/InvokeAI/blob/docs/main/docs/workflows/Prompt_from_File.json
-
-**Output Examples**
-
-
-
-
-## Disclaimer
-
-The nodes linked have been developed and contributed by members of the Invoke AI community. While we strive to ensure the quality and safety of these contributions, we do not guarantee the reliability or security of the nodes. If you have issues or concerns with any of the nodes below, please raise it on GitHub or in the Discord.
-
-
-## Help
-If you run into any issues with a node, please post in the [InvokeAI Discord](https://discord.gg/ZmtBAhwWhy).
-
diff --git a/docs/nodes/contributingNodes.md b/docs/nodes/contributingNodes.md
deleted file mode 100644
index 7a30c8aeb0f..00000000000
--- a/docs/nodes/contributingNodes.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# Contributing Nodes
-
-To learn about the specifics of creating a new node, please visit our [Node creation documentation](../contributing/INVOCATIONS.md).
-
-Once you’ve created a node and confirmed that it behaves as expected locally, follow these steps:
-
-- Make sure the node is contained in a new Python (.py) file. Preferably, the node is in a repo with a README detailing the nodes usage & examples to help others more easily use your node. Including the tag "invokeai-node" in your repository's README can also help other users find it more easily.
-- Submit a pull request with a link to your node(s) repo in GitHub against the `main` branch to add the node to the [Community Nodes](communityNodes.md) list
- - Make sure you are following the template below and have provided all relevant details about the node and what it does. Example output images and workflows are very helpful for other users looking to use your node.
-- A maintainer will review the pull request and node. If the node is aligned with the direction of the project, you may be asked for permission to include it in the core project.
-
-### Community Node Template
-
-```markdown
---------------------------------
-### Super Cool Node Template
-
-**Description:** This node allows you to do super cool things with InvokeAI.
-
-**Node Link:** https://github.com/invoke-ai/InvokeAI/fake_node.py
-
-**Example Node Graph:** https://github.com/invoke-ai/InvokeAI/fake_node_graph.json
-
-**Output Examples**
-
-
-```
diff --git a/docs/nodes/defaultNodes.md b/docs/nodes/defaultNodes.md
deleted file mode 100644
index b78c9af9010..00000000000
--- a/docs/nodes/defaultNodes.md
+++ /dev/null
@@ -1,109 +0,0 @@
-# List of Default Nodes
-
-The table below contains a list of the default nodes shipped with InvokeAI and
-their descriptions.
-
-| Node | Function |
-| :------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Add Integers | Adds two numbers |
-| Boolean Primitive Collection | A collection of boolean primitive values |
-| Boolean Primitive | A boolean primitive value |
-| Canny Processor | Canny edge detection for ControlNet |
-| CenterPadCrop | Pad or crop an image's sides from the center by specified pixels. Positive values are outside of the image. |
-| CLIP Skip | Skip layers in clip text_encoder model. |
-| Collect | Collects values into a collection |
-| Color Correct | Shifts the colors of a target image to match the reference image, optionally using a mask to only color-correct certain regions of the target image. |
-| Color Primitive | A color primitive value |
-| Compel Prompt | Parse prompt using compel package to conditioning. |
-| Conditioning Primitive Collection | A collection of conditioning tensor primitive values |
-| Conditioning Primitive | A conditioning tensor primitive value |
-| Content Shuffle Processor | Applies content shuffle processing to image |
-| ControlNet | Collects ControlNet info to pass to other nodes |
-| Create Denoise Mask | Converts a greyscale or transparency image into a mask for denoising. |
-| Create Gradient Mask | Creates a mask for Gradient ("soft", "differential") inpainting that gradually expands during denoising. Improves edge coherence. |
-| Denoise Latents | Denoises noisy latents to decodable images |
-| Divide Integers | Divides two numbers |
-| Dynamic Prompt | Parses a prompt using adieyal/dynamicprompts' random or combinatorial generator |
-| [FaceMask](./detailedNodes/faceTools.md#facemask) | Generates masks for faces in an image to use with Inpainting |
-| [FaceIdentifier](./detailedNodes/faceTools.md#faceidentifier) | Identifies and labels faces in an image |
-| [FaceOff](./detailedNodes/faceTools.md#faceoff) | Creates a new image that is a scaled bounding box with a mask on the face for Inpainting |
-| Float Math | Perform basic math operations on two floats |
-| Float Primitive Collection | A collection of float primitive values |
-| Float Primitive | A float primitive value |
-| Float Range | Creates a range |
-| HED (softedge) Processor | Applies HED edge detection to image |
-| Blur Image | Blurs an image |
-| Extract Image Channel | Gets a channel from an image. |
-| Image Primitive Collection | A collection of image primitive values |
-| Integer Math | Perform basic math operations on two integers |
-| Convert Image Mode | Converts an image to a different mode. |
-| Crop Image | Crops an image to a specified box. The box can be outside of the image. |
-| Ideal Size | Calculates an ideal image size for latents for a first pass of a multi-pass upscaling to avoid duplication and other artifacts |
-| Image Hue Adjustment | Adjusts the Hue of an image. |
-| Inverse Lerp Image | Inverse linear interpolation of all pixels of an image |
-| Image Primitive | An image primitive value |
-| Lerp Image | Linear interpolation of all pixels of an image |
-| Offset Image Channel | Add to or subtract from an image color channel by a uniform value. |
-| Multiply Image Channel | Multiply or Invert an image color channel by a scalar value. |
-| Multiply Images | Multiplies two images together using `PIL.ImageChops.multiply()`. |
-| Blur NSFW Image | Add blur to NSFW-flagged images |
-| Paste Image | Pastes an image into another image. |
-| ImageProcessor | Base class for invocations that preprocess images for ControlNet |
-| Resize Image | Resizes an image to specific dimensions |
-| Round Float | Rounds a float to a specified number of decimal places |
-| Float to Integer | Converts a float to an integer. Optionally rounds to an even multiple of a input number. |
-| Scale Image | Scales an image by a factor |
-| Image to Latents | Encodes an image into latents. |
-| Add Invisible Watermark | Add an invisible watermark to an image |
-| Solid Color Infill | Infills transparent areas of an image with a solid color |
-| PatchMatch Infill | Infills transparent areas of an image using the PatchMatch algorithm |
-| Tile Infill | Infills transparent areas of an image with tiles of the image |
-| Integer Primitive Collection | A collection of integer primitive values |
-| Integer Primitive | An integer primitive value |
-| Iterate | Iterates over a list of items |
-| Latents Primitive Collection | A collection of latents tensor primitive values |
-| Latents Primitive | A latents tensor primitive value |
-| Latents to Image | Generates an image from latents. |
-| Leres (Depth) Processor | Applies leres processing to image |
-| Lineart Anime Processor | Applies line art anime processing to image |
-| Lineart Processor | Applies line art processing to image |
-| LoRA Loader | Apply selected lora to unet and text_encoder. |
-| Main Model Loader | Loads a main model, outputting its submodels. |
-| Combine Mask | Combine two masks together by multiplying them using `PIL.ImageChops.multiply()`. |
-| Mask Edge | Applies an edge mask to an image |
-| Mask from Alpha | Extracts the alpha channel of an image as a mask. |
-| Mediapipe Face Processor | Applies mediapipe face processing to image |
-| Midas (Depth) Processor | Applies Midas depth processing to image |
-| MLSD Processor | Applies MLSD processing to image |
-| Multiply Integers | Multiplies two numbers |
-| Noise | Generates latent noise. |
-| Normal BAE Processor | Applies NormalBae processing to image |
-| ONNX Latents to Image | Generates an image from latents. |
-| ONNX Prompt (Raw) | A node to process inputs and produce outputs. May use dependency injection in **init** to receive providers. |
-| ONNX Text to Latents | Generates latents from conditionings. |
-| ONNX Model Loader | Loads a main model, outputting its submodels. |
-| OpenCV Inpaint | Simple inpaint using opencv. |
-| DW Openpose Processor | Applies Openpose processing to image |
-| PIDI Processor | Applies PIDI processing to image |
-| Prompts from File | Loads prompts from a text file |
-| Random Integer | Outputs a single random integer. |
-| Random Range | Creates a collection of random numbers |
-| Integer Range | Creates a range of numbers from start to stop with step |
-| Integer Range of Size | Creates a range from start to start + size with step |
-| Resize Latents | Resizes latents to explicit width/height (in pixels). Provided dimensions are floor-divided by 8. |
-| SDXL Compel Prompt | Parse prompt using compel package to conditioning. |
-| SDXL LoRA Loader | Apply selected lora to unet and text_encoder. |
-| SDXL Main Model Loader | Loads an sdxl base model, outputting its submodels. |
-| SDXL Refiner Compel Prompt | Parse prompt using compel package to conditioning. |
-| SDXL Refiner Model Loader | Loads an sdxl refiner model, outputting its submodels. |
-| Scale Latents | Scales latents by a given factor. |
-| Segment Anything Processor | Applies segment anything processing to image |
-| Show Image | Displays a provided image, and passes it forward in the pipeline. |
-| Step Param Easing | Experimental per-step parameter easing for denoising steps |
-| String Primitive Collection | A collection of string primitive values |
-| String Primitive | A string primitive value |
-| Subtract Integers | Subtracts two numbers |
-| Tile Resample Processor | Tile resampler processor |
-| Upscale (RealESRGAN) | Upscales an image using RealESRGAN. |
-| VAE Loader | Loads a VAE model, outputting a VaeLoaderOutput |
-| Zoe (Depth) Processor | Applies Zoe depth processing to image |
diff --git a/docs/nodes/detailedNodes/faceTools.md b/docs/nodes/detailedNodes/faceTools.md
deleted file mode 100644
index 632212d3c33..00000000000
--- a/docs/nodes/detailedNodes/faceTools.md
+++ /dev/null
@@ -1,154 +0,0 @@
-# Face Nodes
-
-## FaceOff
-
-FaceOff mimics a user finding a face in an image and resizing the bounding box
-around the head in Canvas.
-
-Enter a face ID (found with FaceIdentifier) to choose which face to mask.
-
-Just as you would add more context inside the bounding box by making it larger
-in Canvas, the node gives you a padding input (in pixels) which will
-simultaneously add more context, and increase the resolution of the bounding box
-so the face remains the same size inside it.
-
-The "Minimum Confidence" input defaults to 0.5 (50%), and represents a pass/fail
-threshold a detected face must reach for it to be processed. Lowering this value
-may help if detection is failing. If the detected masks are imperfect and stray
-too far outside/inside of faces, the node gives you X & Y offsets to shrink/grow
-the masks by a multiplier.
-
-FaceOff will output the face in a bounded image, taking the face off of the
-original image for input into any node that accepts image inputs. The node also
-outputs a face mask with the dimensions of the bounded image. The X & Y outputs
-are for connecting to the X & Y inputs of the Paste Image node, which will place
-the bounded image back on the original image using these coordinates.
-
-###### Inputs/Outputs
-
-| Input | Description |
-| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Image | Image for face detection |
-| Face ID | The face ID to process, numbered from 0. Multiple faces not supported. Find a face's ID with FaceIdentifier node. |
-| Minimum Confidence | Minimum confidence for face detection (lower if detection is failing) |
-| X Offset | X-axis offset of the mask |
-| Y Offset | Y-axis offset of the mask |
-| Padding | All-axis padding around the mask in pixels |
-| Chunk | Chunk (or divide) the image into sections to greatly improve face detection success. Defaults to off, but will activate if no faces are detected normally. Activate to chunk by default. |
-
-| Output | Description |
-| ------------- | ------------------------------------------------ |
-| Bounded Image | Original image bound, cropped, and resized |
-| Width | The width of the bounded image in pixels |
-| Height | The height of the bounded image in pixels |
-| Mask | The output mask |
-| X | The x coordinate of the bounding box's left side |
-| Y | The y coordinate of the bounding box's top side |
-
-## FaceMask
-
-FaceMask mimics a user drawing masks on faces in an image in Canvas.
-
-The "Face IDs" input allows the user to select specific faces to be masked.
-Leave empty to detect and mask all faces, or a comma-separated list for a
-specific combination of faces (ex: `1,2,4`). A single integer will detect and
-mask that specific face. Find face IDs with the FaceIdentifier node.
-
-The "Minimum Confidence" input defaults to 0.5 (50%), and represents a pass/fail
-threshold a detected face must reach for it to be processed. Lowering this value
-may help if detection is failing.
-
-If the detected masks are imperfect and stray too far outside/inside of faces,
-the node gives you X & Y offsets to shrink/grow the masks by a multiplier. All
-masks shrink/grow together by the X & Y offset values.
-
-By default, masks are created to change faces. When masks are inverted, they
-change surrounding areas, protecting faces.
-
-###### Inputs/Outputs
-
-| Input | Description |
-| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Image | Image for face detection |
-| Face IDs | Comma-separated list of face ids to mask eg '0,2,7'. Numbered from 0. Leave empty to mask all. Find face IDs with FaceIdentifier node. |
-| Minimum Confidence | Minimum confidence for face detection (lower if detection is failing) |
-| X Offset | X-axis offset of the mask |
-| Y Offset | Y-axis offset of the mask |
-| Chunk | Chunk (or divide) the image into sections to greatly improve face detection success. Defaults to off, but will activate if no faces are detected normally. Activate to chunk by default. |
-| Invert Mask | Toggle to invert the face mask |
-
-| Output | Description |
-| ------ | --------------------------------- |
-| Image | The original image |
-| Width | The width of the image in pixels |
-| Height | The height of the image in pixels |
-| Mask | The output face mask |
-
-## FaceIdentifier
-
-FaceIdentifier outputs an image with detected face IDs printed in white numbers
-onto each face.
-
-Face IDs can then be used in FaceMask and FaceOff to selectively mask all, a
-specific combination, or single faces.
-
-The FaceIdentifier output image is generated for user reference, and isn't meant
-to be passed on to other image-processing nodes.
-
-The "Minimum Confidence" input defaults to 0.5 (50%), and represents a pass/fail
-threshold a detected face must reach for it to be processed. Lowering this value
-may help if detection is failing. If an image is changed in the slightest, run
-it through FaceIdentifier again to get updated FaceIDs.
-
-###### Inputs/Outputs
-
-| Input | Description |
-| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Image | Image for face detection |
-| Minimum Confidence | Minimum confidence for face detection (lower if detection is failing) |
-| Chunk | Chunk (or divide) the image into sections to greatly improve face detection success. Defaults to off, but will activate if no faces are detected normally. Activate to chunk by default. |
-
-| Output | Description |
-| ------ | ------------------------------------------------------------------------------------------------ |
-| Image | The original image with small face ID numbers printed in white onto each face for user reference |
-| Width | The width of the original image in pixels |
-| Height | The height of the original image in pixels |
-
-## Tips
-
-- If not all target faces are being detected, activate Chunk to bypass full
- image face detection and greatly improve detection success.
-- Final results will vary between full-image detection and chunking for faces
- that are detectable by both due to the nature of the process. Try either to
- your taste.
-- Be sure Minimum Confidence is set the same when using FaceIdentifier with
- FaceOff/FaceMask.
-- For FaceOff, use the color correction node before faceplace to correct edges
- being noticeable in the final image (see example screenshot).
-- Non-inpainting models may struggle to paint/generate correctly around faces.
-- If your face won't change the way you want it to no matter what you change,
- consider that the change you're trying to make is too much at that resolution.
- For example, if an image is only 512x768 total, the face might only be 128x128
- or 256x256, much smaller than the 512x512 your SD1.5 model was probably
- trained on. Try increasing the resolution of the image by upscaling or
- resizing, add padding to increase the bounding box's resolution, or use an
- image where the face takes up more pixels.
-- If the resulting face seems out of place pasted back on the original image
- (ie. too large, not proportional), add more padding on the FaceOff node to
- give inpainting more context. Context and good prompting are important to
- keeping things proportional.
-- If you find the mask is too big/small and going too far outside/inside the
- area you want to affect, adjust the x & y offsets to shrink/grow the mask area
-- Use a higher denoise start value to resemble aspects of the original face or
- surroundings. Denoise start = 0 & denoise end = 1 will make something new,
- while denoise start = 0.50 & denoise end = 1 will be 50% old and 50% new.
-- mediapipe isn't good at detecting faces with lots of face paint, hair covering
- the face, etc. Anything that obstructs the face will likely result in no faces
- being detected.
-- If you find your face isn't being detected, try lowering the minimum
- confidence value from 0.5. This could result in false positives, however
- (random areas being detected as faces and masked).
-- After altering an image and wanting to process a different face in the newly
- altered image, run the altered image through FaceIdentifier again to see the
- new Face IDs. MediaPipe will most likely detect faces in a different order
- after an image has been changed in the slightest.
diff --git a/docs/nodes/exampleWorkflows.md b/docs/nodes/exampleWorkflows.md
deleted file mode 100644
index b52493f365f..00000000000
--- a/docs/nodes/exampleWorkflows.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# Example Workflows
-
-We've curated some example workflows for you to get started with Workflows in InvokeAI! These can also be found in the Workflow Library, located in the Workflow Editor of Invoke.
-
-To use them, right click on your desired workflow, follow the link to GitHub and click the "⬇" button to download the raw file. You can then use the "Load Workflow" functionality in InvokeAI to load the workflow and start generating images!
-
-If you're interested in finding more workflows, checkout the [#share-your-workflows](https://discord.com/channels/1020123559063990373/1130291608097661000) channel in the InvokeAI Discord.
-
-* [SD1.5 / SD2 Text to Image](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/Text_to_Image.json)
-* [SDXL Text to Image](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/SDXL_Text_to_Image.json)
-* [SDXL Text to Image with Refiner](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/SDXL_w_Refiner_Text_to_Image.json)
-* [Multi ControlNet (Canny & Depth)](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/Multi_ControlNet_Canny_and_Depth.json)
-* [Tiled Upscaling with ControlNet](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/ESRGAN_img2img_upscale_w_Canny_ControlNet.json)
-* [Prompt From File](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/Prompt_from_File.json)
-* [Face Detailer with IP-Adapter & ControlNet](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/Face_Detailer_with_IP-Adapter_and_Canny.json)
-* [FaceMask](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/FaceMask.json)
-* [FaceOff with 2x Face Scaling](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/FaceOff_FaceScale2x.json)
-* [QR Code Monster](https://github.com/invoke-ai/InvokeAI/blob/main/docs/workflows/QR_Code_Monster.json)
diff --git a/docs/nodes/overview.md b/docs/nodes/overview.md
deleted file mode 100644
index 71e316c8561..00000000000
--- a/docs/nodes/overview.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# Nodes
-
-## What are Nodes?
-An Node is simply a single operation that takes in inputs and returns
-out outputs. Multiple nodes can be linked together to create more
-complex functionality. All InvokeAI features are added through nodes.
-
-### Anatomy of a Node
-
-Individual nodes are made up of the following:
-
-- Inputs: Edge points on the left side of the node window where you connect outputs from other nodes.
-- Outputs: Edge points on the right side of the node window where you connect to inputs on other nodes.
-- Options: Various options which are either manually configured, or overridden by connecting an output from another node to the input.
-
-
-With nodes, you can can easily extend the image generation capabilities of InvokeAI, and allow you build workflows that suit your needs.
-
-You can read more about nodes and the node editor [here](../nodes/NODES.md).
-
-To get started with nodes, take a look at some of our examples for [common workflows](../nodes/exampleWorkflows.md)
-
-## Downloading New Nodes
-To download a new node, visit our list of [Community Nodes](../nodes/communityNodes.md). These are nodes that have been created by the community, for the community.
-
-
diff --git a/docs/other/CONTRIBUTORS.md b/docs/other/CONTRIBUTORS.md
deleted file mode 100644
index 448eddbcf01..00000000000
--- a/docs/other/CONTRIBUTORS.md
+++ /dev/null
@@ -1,380 +0,0 @@
----
-title: Contributors
----
-
-# :octicons-person-24: Contributors
-
-The list of all the amazing people who have contributed to the various features that you get to
-experience in this fork.
-
-We thank them for all of their time and hard work.
-
-## **Original Author**
-
-- [Lincoln D. Stein](mailto:lincoln.stein@gmail.com)
-
-## **Current Core Team**
-
-* @lstein (Lincoln Stein) - Co-maintainer
-* @blessedcoolant - Co-maintainer
-* @hipsterusername (Kent Keirsey) - Co-maintainer, CEO, Positive Vibes
-* @psychedelicious (Spencer Mabrito) - Web Team Leader
-* @chainchompa (Jennifer Player) - Web Development & Chain-Chomping
-* @josh is toast (Josh Corbett) - Web Development
-* @cheerio (Mary Rogers) - Lead Engineer & Web App Development
-* @ebr (Eugene Brodsky) - Cloud/DevOps/Sofware engineer; your friendly neighbourhood cluster-autoscaler
-* @sunija - Standalone version
-* @genomancer (Gregg Helt) - Controlnet support
-* @brandon (Brandon Rising) - Platform, Infrastructure, Backend Systems
-* @ryanjdick (Ryan Dick) - Machine Learning & Training
-* @JPPhoto - Core image generation nodes
-* @dunkeroni - Image generation backend
-* @SkunkWorxDark - Image generation backend
-* @keturn (Kevin Turner) - Diffusers
-* @millu (Millun Atluri) - Community Wizard, Documentation, Node-wrangler,
-* @glimmerleaf (Devon Hopkins) - Community Wizard
-* @gogurt enjoyer - Discord moderator and end user support
-* @whosawhatsis - Discord moderator and end user support
-* @dwinrger - Discord moderator and end user support
-* @526christian - Discord moderator and end user support
-* @harvester62 - Discord moderator and end user support
-
-
-## **Honored Team Alumni**
-
-* @StAlKeR7779 (Sergey Borisov) - Torch stack, ONNX, model management, optimization
-* @damian0815 - Attention Systems and Compel Maintainer
-* @netsvetaev (Artur) - Localization support
-* @Kyle0654 (Kyle Schouviller) - Node Architect and General Backend Wizard
-* @tildebyte - Installation and configuration
-* @mauwii (Matthias Wilde) - Installation, release, continuous integration
-
-
-## **Full List of Contributors by Commit Name**
-
-- 이승석
-- AbdBarho
-- ablattmann
-- AdamOStark
-- Adam Rice
-- Airton Silva
-- Aldo Hoeben
-- Alexander Eichhorn
-- Alexandre D. Roberge
-- Alexandre Macabies
-- Alfie John
-- Andreas Rozek
-- Andre LaBranche
-- Andy Bearman
-- Andy Luhrs
-- Andy Pilate
-- Anonymous
-- Anthony Monthe
-- Any-Winter-4079
-- apolinario
-- Ar7ific1al
-- ArDiouscuros
-- Armando C. Santisbon
-- Arnold Cordewiner
-- Arthur Holstvoogd
-- artmen1516
-- Artur
-- Arturo Mendivil
-- Ben Alkov
-- Benjamin Warner
-- Bernard Maltais
-- blessedcoolant
-- blhook
-- BlueAmulet
-- Bouncyknighter
-- Brandon
-- Brandon Rising
-- Brent Ozar
-- Brian Racer
-- bsilvereagle
-- c67e708d
-- camenduru
-- CapableWeb
-- Carson Katri
-- chainchompa
-- Chloe
-- Chris Dawson
-- Chris Hayes
-- Chris Jones
-- chromaticist
-- Claus F. Strasburger
-- cmdr2
-- cody
-- Conor Reid
-- Cora Johnson-Roberson
-- coreco
-- cosmii02
-- cpacker
-- Cragin Godley
-- creachec
-- CrypticWit
-- d8ahazard
-- damian
-- damian0815
-- Damian at mba
-- Damian Stewart
-- Daniel Manzke
-- Danny Beer
-- Dan Sully
-- Darren Ringer
-- David Burnett
-- David Ford
-- David Regla
-- David Sisco
-- David Wager
-- Daya Adianto
-- db3000
-- DekitaRPG
-- Denis Olshin
-- Dennis
-- dependabot[bot]
-- Dmitry Parnas
-- Dobrynia100
-- Dominic Letz
-- DrGunnarMallon
-- Drun555
-- dunkeroni
-- Edward Johan
-- elliotsayes
-- Elrik
-- ElrikUnderlake
-- Eric Khun
-- Eric Wolf
-- Eugene
-- Eugene Brodsky
-- ExperimentalCyborg
-- Fabian Bahl
-- Fabio 'MrWHO' Torchetti
-- Fattire
-- fattire
-- Felipe Nogueira
-- Félix Sanz
-- figgefigge
-- Gabriel Mackievicz Telles
-- gabrielrotbart
-- gallegonovato
-- Gérald LONLAS
-- Gille
-- GitHub Actions Bot
-- glibesyck
-- gogurtenjoyer
-- Gohsuke Shimada
-- greatwolf
-- greentext2
-- Gregg Helt
-- H4rk
-- Håvard Gulldahl
-- henry
-- Henry van Megen
-- hipsterusername
-- hj
-- Hosted Weblate
-- Iman Karim
-- ismail ihsan bülbül
-- ItzAttila
-- Ivan Efimov
-- jakehl
-- Jakub Kolčář
-- JamDon2
-- James Reynolds
-- Jan Skurovec
-- Jari Vetoniemi
-- Jason Toffaletti
-- Jaulustus
-- Jeff Mahoney
-- Jennifer Player
-- jeremy
-- Jeremy Clark
-- JigenD
-- Jim Hays
-- Johan Roxendal
-- Johnathon Selstad
-- Jonathan
-- Jordan Hewitt
-- Joseph Dries III
-- Josh Corbett
-- JPPhoto
-- jspraul
-- junzi
-- Justin Wong
-- Juuso V
-- Kaspar Emanuel
-- Katsuyuki-Karasawa
-- Keerigan45
-- Kent Keirsey
-- Kevin Brack
-- Kevin Coakley
-- Kevin Gibbons
-- Kevin Schaul
-- Kevin Turner
-- Kieran Klaassen
-- krummrey
-- Kyle
-- Kyle Lacy
-- Kyle Schouviller
-- Lawrence Norton
-- LemonDouble
-- Leo Pasanen
-- Lincoln Stein
-- LoganPederson
-- Lynne Whitehorn
-- majick
-- Marco Labarile
-- Marta Nahorniuk
-- Martin Kristiansen
-- Mary Hipp
-- maryhipp
-- Mary Hipp Rogers
-- mastercaster
-- mastercaster9000
-- Matthias Wild
-- mauwii
-- michaelk71
-- mickr777
-- Mihai
-- Mihail Dumitrescu
-- Mikhail Tishin
-- Millun Atluri
-- Minjune Song
-- Mitchell Allain
-- mitien
-- mofuzz
-- Muhammad Usama
-- Name
-- _nderscore
-- Neil Wang
-- nekowaiz
-- nemuruibai
-- Netzer R
-- Nicholas Koh
-- Nicholas Körfer
-- nicolai256
-- Niek van der Maas
-- noodlebox
-- Nuno Coração
-- ofirkris
-- Olivier Louvignes
-- owenvincent
-- pand4z31
-- Patrick Esser
-- Patrick Tien
-- Patrick von Platen
-- Paul Curry
-- Paul Sajna
-- pejotr
-- Peter Baylies
-- Peter Lin
-- plucked
-- prixt
-- psychedelicious
-- psychedelicious@windows
-- Rainer Bernhardt
-- Riccardo Giovanetti
-- Rich Jones
-- rmagur1203
-- Rob Baines
-- Robert Bolender
-- Robin Rombach
-- Rohan Barar
-- Rohinish
-- rpagliuca
-- rromb
-- Rupesh Sreeraman
-- Ryan
-- Ryan Cao
-- Ryan Dick
-- Saifeddine
-- Saifeddine ALOUI
-- Sam
-- SammCheese
-- Sam McLeod
-- Sammy
-- sammyf
-- Samuel Husso
-- Saurav Maheshkar
-- Scott Lahteine
-- Sean McLellan
-- Sebastian Aigner
-- Sergey Borisov
-- Sergey Krashevich
-- Shapor Naghibzadeh
-- Shawn Zhong
-- Simona Liliac
-- Simon Vans-Colina
-- skunkworxdark
-- slashtechno
-- SoheilRezaei
-- Song, Pengcheng
-- spezialspezial
-- ssantos
-- StAlKeR7779
-- Stefan Tobler
-- Stephan Koglin-Fischer
-- SteveCaruso
-- Steve Martinelli
-- Steven Frank
-- Surisen
-- System X - Files
-- Taylor Kems
-- techicode
-- techybrain-dev
-- tesseractcat
-- thealanle
-- Thomas
-- tildebyte
-- Tim Cabbage
-- Tom
-- Tom Elovi Spruce
-- Tom Gouville
-- tomosuto
-- Travco
-- Travis Palmer
-- tyler
-- unknown
-- user1
-- vedant-3010
-- Vedant Madane
-- veprogames
-- wa.code
-- wfng92
-- whjms
-- whosawhatsis
-- Will
-- William Becher
-- William Chong
-- Wilson E. Alvarez
-- woweenie
-- Wubbbi
-- xra
-- Yeung Yiu Hung
-- ymgenesis
-- Yorzaren
-- Yosuke Shinya
-- yun saki
-- ZachNagengast
-- Zadagu
-- zeptofine
-- Zerdoumi
-- Васянатор
-- 冯不游
-- 唐澤 克幸
-
-## **Original CompVis (Stable Diffusion) Authors**
-
-- [Robin Rombach](https://github.com/rromb)
-- [Patrick von Platen](https://github.com/patrickvonplaten)
-- [ablattmann](https://github.com/ablattmann)
-- [Patrick Esser](https://github.com/pesser)
-- [owenvincent](https://github.com/owenvincent)
-- [apolinario](https://github.com/apolinario)
-- [Charles Packer](https://github.com/cpacker)
-
----
-
-_If you have contributed and don't see your name on the list of contributors, please let one of the
-collaborators know about the omission, or feel free to make a pull request._
diff --git a/docs/other/README-CompViz.md b/docs/other/README-CompViz.md
deleted file mode 100644
index cb3a207b2e0..00000000000
--- a/docs/other/README-CompViz.md
+++ /dev/null
@@ -1,255 +0,0 @@
----
-title: CompViz-Readme
----
-
-# _README from [CompViz/stable-diffusion](https://github.com/CompVis/stable-diffusion)_
-
-_Stable Diffusion was made possible thanks to a collaboration with
-[Stability AI](https://stability.ai/) and [Runway](https://runwayml.com/) and
-builds upon our previous work:_
-
-[**High-Resolution Image Synthesis with Latent Diffusion Models**](https://ommer-lab.com/research/latent-diffusion-models/)
-[Robin Rombach](https://github.com/rromb)\*,
-[Andreas Blattmann](https://github.com/ablattmann)\*,
-[Dominik Lorenz](https://github.com/qp-qp)\,
-[Patrick Esser](https://github.com/pesser),
-[Björn Ommer](https://hci.iwr.uni-heidelberg.de/Staff/bommer)
-
-## **CVPR '22 Oral**
-
-which is available on [GitHub](https://github.com/CompVis/latent-diffusion). PDF
-at [arXiv](https://arxiv.org/abs/2112.10752). Please also visit our
-[Project page](https://ommer-lab.com/research/latent-diffusion-models/).
-
-
-[Stable Diffusion](#stable-diffusion-v1) is a latent text-to-image diffusion
-model. Thanks to a generous compute donation from
-[Stability AI](https://stability.ai/) and support from
-[LAION](https://laion.ai/), we were able to train a Latent Diffusion Model on
-512x512 images from a subset of the [LAION-5B](https://laion.ai/blog/laion-5b/)
-database. Similar to Google's [Imagen](https://arxiv.org/abs/2205.11487), this
-model uses a frozen CLIP ViT-L/14 text encoder to condition the model on text
-prompts. With its 860M UNet and 123M text encoder, the model is relatively
-lightweight and runs on a GPU with at least 10GB VRAM. See
-[this section](#stable-diffusion-v1) below and the
-[model card](https://huggingface.co/CompVis/stable-diffusion).
-
-## Requirements
-
-A suitable [conda](https://conda.io/) environment named `ldm` can be created and
-activated with:
-
-```
-conda env create
-conda activate ldm
-```
-
-Note that the first line may be abbreviated `conda env create`, since conda will
-look for `environment.yml` by default.
-
-You can also update an existing
-[latent diffusion](https://github.com/CompVis/latent-diffusion) environment by
-running
-
-```bash
-conda install pytorch torchvision -c pytorch
-pip install transformers==4.19.2
-pip install -e .
-```
-
-## Stable Diffusion v1
-
-Stable Diffusion v1 refers to a specific configuration of the model architecture
-that uses a downsampling-factor 8 autoencoder with an 860M UNet and CLIP
-ViT-L/14 text encoder for the diffusion model. The model was pretrained on
-256x256 images and then finetuned on 512x512 images.
-
-\*Note: Stable Diffusion v1 is a general text-to-image diffusion model and
-therefore mirrors biases and (mis-)conceptions that are present in its training
-data. Details on the training procedure and data, as well as the intended use of
-the model can be found in the corresponding
-[model card](https://huggingface.co/CompVis/stable-diffusion). Research into the
-safe deployment of general text-to-image models is an ongoing effort. To prevent
-misuse and harm, we currently provide access to the checkpoints only for
-[academic research purposes upon request](https://stability.ai/academia-access-form).
-**This is an experiment in safe and community-driven publication of a capable
-and general text-to-image model. We are working on a public release with a more
-permissive license that also incorporates ethical considerations.\***
-
-[Request access to Stable Diffusion v1 checkpoints for academic research](https://stability.ai/academia-access-form)
-
-### Weights
-
-We currently provide three checkpoints, `sd-v1-1.ckpt`, `sd-v1-2.ckpt` and
-`sd-v1-3.ckpt`, which were trained as follows,
-
-- `sd-v1-1.ckpt`: 237k steps at resolution `256x256` on
- [laion2B-en](https://huggingface.co/datasets/laion/laion2B-en). 194k steps at
- resolution `512x512` on
- [laion-high-resolution](https://huggingface.co/datasets/laion/laion-high-resolution)
- (170M examples from LAION-5B with resolution `>= 1024x1024`).
-- `sd-v1-2.ckpt`: Resumed from `sd-v1-1.ckpt`. 515k steps at resolution
- `512x512` on "laion-improved-aesthetics" (a subset of laion2B-en, filtered to
- images with an original size `>= 512x512`, estimated aesthetics score `> 5.0`,
- and an estimated watermark probability `< 0.5`. The watermark estimate is from
- the LAION-5B metadata, the aesthetics score is estimated using an
- [improved aesthetics estimator](https://github.com/christophschuhmann/improved-aesthetic-predictor)).
-- `sd-v1-3.ckpt`: Resumed from `sd-v1-2.ckpt`. 195k steps at resolution
- `512x512` on "laion-improved-aesthetics" and 10\% dropping of the
- text-conditioning to improve
- [classifier-free guidance sampling](https://arxiv.org/abs/2207.12598).
-
-Evaluations with different classifier-free guidance scales (1.5, 2.0, 3.0, 4.0,
-5.0, 6.0, 7.0, 8.0) and 50 PLMS sampling steps show the relative improvements of
-the checkpoints: 
-
-### Text-to-Image with Stable Diffusion
-
-
-
-
-Stable Diffusion is a latent diffusion model conditioned on the (non-pooled)
-text embeddings of a CLIP ViT-L/14 text encoder.
-
-#### Sampling Script
-
-After [obtaining the weights](#weights), link them
-
-```
-mkdir -p models/ldm/stable-diffusion-v1/
-ln -s models/ldm/stable-diffusion-v1/model.ckpt
-```
-
-and sample with
-
-```
-python scripts/txt2img.py --prompt "a photograph of an astronaut riding a horse" --plms
-```
-
-By default, this uses a guidance scale of `--scale 7.5`,
-[Katherine Crowson's implementation](https://github.com/CompVis/latent-diffusion/pull/51)
-of the [PLMS](https://arxiv.org/abs/2202.09778) sampler, and renders images of
-size 512x512 (which it was trained on) in 50 steps. All supported arguments are
-listed below (type `python scripts/txt2img.py --help`).
-
-```commandline
-usage: txt2img.py [-h] [--prompt [PROMPT]] [--outdir [OUTDIR]] [--skip_grid] [--skip_save] [--ddim_steps DDIM_STEPS] [--plms] [--laion400m] [--fixed_code] [--ddim_eta DDIM_ETA] [--n_iter N_ITER] [--H H] [--W W] [--C C] [--f F] [--n_samples N_SAMPLES] [--n_rows N_ROWS]
- [--scale SCALE] [--from-file FROM_FILE] [--config CONFIG] [--ckpt CKPT] [--seed SEED] [--precision {full,autocast}]
-
-optional arguments:
- -h, --help show this help message and exit
- --prompt [PROMPT] the prompt to render
- --outdir [OUTDIR] dir to write results to
- --skip_grid do not save a grid, only individual samples. Helpful when evaluating lots of samples
- --skip_save do not save individual samples. For speed measurements.
- --ddim_steps DDIM_STEPS
- number of ddim sampling steps
- --plms use plms sampling
- --laion400m uses the LAION400M model
- --fixed_code if enabled, uses the same starting code across samples
- --ddim_eta DDIM_ETA ddim eta (eta=0.0 corresponds to deterministic sampling
- --n_iter N_ITER sample this often
- --H H image height, in pixel space
- --W W image width, in pixel space
- --C C latent channels
- --f F downsampling factor
- --n_samples N_SAMPLES
- how many samples to produce for each given prompt. A.k.a. batch size
- (note that the seeds for each image in the batch will be unavailable)
- --n_rows N_ROWS rows in the grid (default: n_samples)
- --scale SCALE unconditional guidance scale: eps = eps(x, empty) + scale * (eps(x, cond) - eps(x, empty))
- --from-file FROM_FILE
- if specified, load prompts from this file
- --config CONFIG path to config which constructs model
- --ckpt CKPT path to checkpoint of model
- --seed SEED the seed (for reproducible sampling)
- --precision {full,autocast}
- evaluate at this precision
-
-```
-
-Note: The inference config for all v1 versions is designed to be used with
-EMA-only checkpoints. For this reason `use_ema=False` is set in the
-configuration, otherwise the code will try to switch from non-EMA to EMA
-weights. If you want to examine the effect of EMA vs no EMA, we provide "full"
-checkpoints which contain both types of weights. For these, `use_ema=False` will
-load and use the non-EMA weights.
-
-#### Diffusers Integration
-
-Another way to download and sample Stable Diffusion is by using the
-[diffusers library](https://github.com/huggingface/diffusers/tree/main#new--stable-diffusion-is-now-fully-compatible-with-diffusers)
-
-```py
-# make sure you're logged in with `huggingface-cli login`
-from torch import autocast
-from diffusers import StableDiffusionPipeline, LMSDiscreteScheduler
-
-pipe = StableDiffusionPipeline.from_pretrained(
- "CompVis/stable-diffusion-v1-3-diffusers",
- use_auth_token=True
-)
-
-prompt = "a photo of an astronaut riding a horse on mars"
-with autocast("cuda"):
- image = pipe(prompt)["sample"][0]
-
-image.save("astronaut_rides_horse.png")
-```
-
-### Image Modification with Stable Diffusion
-
-By using a diffusion-denoising mechanism as first proposed by
-[SDEdit](https://arxiv.org/abs/2108.01073), the model can be used for different
-tasks such as text-guided image-to-image translation and upscaling. Similar to
-the txt2img sampling script, we provide a script to perform image modification
-with Stable Diffusion.
-
-The following describes an example where a rough sketch made in
-[Pinta](https://www.pinta-project.com/) is converted into a detailed artwork.
-
-```
-python scripts/img2img.py --prompt "A fantasy landscape, trending on artstation" --init-img --strength 0.8
-```
-
-Here, strength is a value between 0.0 and 1.0, that controls the amount of noise
-that is added to the input image. Values that approach 1.0 allow for lots of
-variations but will also produce images that are not semantically consistent
-with the input. See the following example.
-
-**Input**
-
-
-
-**Outputs**
-
-
-
-
-This procedure can, for example, also be used to upscale samples from the base
-model.
-
-## Comments
-
-- Our codebase for the diffusion models builds heavily on
- [OpenAI's ADM codebase](https://github.com/openai/guided-diffusion) and
- [https://github.com/lucidrains/denoising-diffusion-pytorch](https://github.com/lucidrains/denoising-diffusion-pytorch).
- Thanks for open-sourcing!
-
-- The implementation of the transformer encoder is from
- [x-transformers](https://github.com/lucidrains/x-transformers) by
- [lucidrains](https://github.com/lucidrains?tab=repositories).
-
-## BibTeX
-
-```
-@misc{rombach2021highresolution,
- title={High-Resolution Image Synthesis with Latent Diffusion Models},
- author={Robin Rombach and Andreas Blattmann and Dominik Lorenz and Patrick Esser and Björn Ommer},
- year={2021},
- eprint={2112.10752},
- archivePrefix={arXiv},
- primaryClass={cs.CV}
-}
-
-```
diff --git a/docs/package.json b/docs/package.json
new file mode 100644
index 00000000000..29d0786e8ea
--- /dev/null
+++ b/docs/package.json
@@ -0,0 +1,34 @@
+{
+ "name": "docs",
+ "type": "module",
+ "version": "0.0.1",
+ "scripts": {
+ "dev": "astro dev",
+ "start": "astro dev",
+ "generate-docs-data": "uv run python ../scripts/generate_docs_json.py",
+ "check-docs-data": "pnpm run generate-docs-data && git diff --exit-code -- src/generated",
+ "check-deploy-output": "node ./scripts/verify-deploy-output.mjs",
+ "check-redirects": "node ./scripts/validate-redirect-targets.mjs",
+ "build": "astro build",
+ "preview": "astro preview",
+ "astro": "astro"
+ },
+ "dependencies": {
+ "@astrojs/starlight": "^0.39.2",
+ "@fontsource-variable/inter": "^5.2.8",
+ "@fontsource-variable/roboto-mono": "^5.2.9",
+ "astro": "^6.3.7",
+ "mermaid": "^11.15.0",
+ "rehype-external-links": "^3.0.0",
+ "sharp": "^0.34.5",
+ "starlight-changelogs": "^0.5.0",
+ "starlight-contextual-menu": "^0.1.5",
+ "starlight-links-validator": "^0.24.0",
+ "starlight-llms-txt": "^0.10.0"
+ },
+ "devDependencies": {
+ "node-addon-api": "^8.8.0",
+ "node-gyp": "^12.3.0"
+ },
+ "packageManager": "pnpm@10.12.4"
+}
diff --git a/docs/plugins/rehype-prefix-base-to-root-links.mjs b/docs/plugins/rehype-prefix-base-to-root-links.mjs
new file mode 100644
index 00000000000..fa424ab5c54
--- /dev/null
+++ b/docs/plugins/rehype-prefix-base-to-root-links.mjs
@@ -0,0 +1,53 @@
+export function rehypePrefixBaseToRootLinks(options = {}) {
+ const base = normalizeBase(options.base);
+
+ return (tree) => {
+ if (!base) {
+ return;
+ }
+
+ walk(tree, (node) => {
+ if (node.tagName !== 'a') {
+ return;
+ }
+
+ const href = node.properties?.href;
+
+ if (typeof href !== 'string') {
+ return;
+ }
+
+ if (!href.startsWith('/') || href.startsWith('//') || href.startsWith(`${base}/`)) {
+ return;
+ }
+
+ node.properties.href = `${base}${href}`;
+ });
+ };
+}
+
+function walk(node, visitor) {
+ if (!node || typeof node !== 'object') {
+ return;
+ }
+
+ if (node.type === 'element') {
+ visitor(node);
+ }
+
+ if (!Array.isArray(node.children)) {
+ return;
+ }
+
+ for (const child of node.children) {
+ walk(child, visitor);
+ }
+}
+
+function normalizeBase(base) {
+ if (!base || base === '/') {
+ return '';
+ }
+
+ return base.endsWith('/') ? base.slice(0, -1) : base;
+}
diff --git a/docs/pnpm-lock.yaml b/docs/pnpm-lock.yaml
new file mode 100644
index 00000000000..a2daac1ce72
--- /dev/null
+++ b/docs/pnpm-lock.yaml
@@ -0,0 +1,5443 @@
+lockfileVersion: '9.0'
+
+settings:
+ autoInstallPeers: true
+ excludeLinksFromLockfile: false
+
+importers:
+
+ .:
+ dependencies:
+ '@astrojs/starlight':
+ specifier: ^0.39.2
+ version: 0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ '@fontsource-variable/inter':
+ specifier: ^5.2.8
+ version: 5.2.8
+ '@fontsource-variable/roboto-mono':
+ specifier: ^5.2.9
+ version: 5.2.9
+ astro:
+ specifier: ^6.3.7
+ version: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+ mermaid:
+ specifier: ^11.15.0
+ version: 11.15.0
+ rehype-external-links:
+ specifier: ^3.0.0
+ version: 3.0.0
+ sharp:
+ specifier: ^0.34.5
+ version: 0.34.5
+ starlight-changelogs:
+ specifier: ^0.5.0
+ version: 0.5.0(@astrojs/starlight@0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)))(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ starlight-contextual-menu:
+ specifier: ^0.1.5
+ version: 0.1.5(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))(starlight-markdown@0.1.5(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)))
+ starlight-links-validator:
+ specifier: ^0.24.0
+ version: 0.24.0(@astrojs/starlight@0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)))(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ starlight-llms-txt:
+ specifier: ^0.10.0
+ version: 0.10.0(@astrojs/starlight@0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)))(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ devDependencies:
+ node-addon-api:
+ specifier: ^8.8.0
+ version: 8.8.0
+ node-gyp:
+ specifier: ^12.3.0
+ version: 12.3.0
+
+packages:
+
+ '@antfu/install-pkg@1.1.0':
+ resolution: {integrity: sha512-MGQsmw10ZyI+EJo45CdSER4zEb+p31LpDAFp2Z3gkSd1yqVZGi0Ebx++YTEMonJy4oChEMLsxZ64j8FH6sSqtQ==}
+
+ '@ascorbic/loader-utils@1.0.2':
+ resolution: {integrity: sha512-pg43g83gojVtEsAkXfjWuzJhuXneJp4wM/leBftGkCPV3yxKgB92EWA+nWu735BgbBMph3P7DrVqVc3ikt+dJA==}
+ peerDependencies:
+ astro: ^4.14.0 || ^5.0.0-beta.0
+
+ '@astrojs/compiler@4.0.0':
+ resolution: {integrity: sha512-eouss7G8ygdZqHuke033VMcVw5HTZUu+PXd/h06DGDUg/jt5btPYPqh66ENWw/mU78rBrf/oeC4oqoBwMtDMNA==}
+
+ '@astrojs/internal-helpers@0.9.0':
+ resolution: {integrity: sha512-GdYkzR26re8izmyYlBqf4z2s7zNngmWLFuxw0UKiPNqHraZGS6GKWIwSHgS22RDlu2ePFJ8bzmpBcUszut/SDg==}
+
+ '@astrojs/internal-helpers@0.9.1':
+ resolution: {integrity: sha512-1pWuARqYom/TzuU3+0ZugsTrKlUydWKuULmDqSMTuonY+9IRDUEGKX/8PXQ1nBxRq3w85uGtd9q9SXfqEldMIQ==}
+
+ '@astrojs/markdown-remark@7.1.1':
+ resolution: {integrity: sha512-C6e9BnLGlbdv6bV8MYGeHpHxsUHrCrB4OuRLqi5LI7oiBVcBcqfUN06zpwFQdHgV48QCCrMmLpyqBr7VqC+swA==}
+
+ '@astrojs/markdown-remark@7.1.2':
+ resolution: {integrity: sha512-caXZ4Dc2St2dW8luEg22GlP0gupLdztCTQE4EzZOxW1pqWXz9mbeJEuHUkgDYcKWW8tjIHkydYDhWLVoxJ327Q==}
+
+ '@astrojs/mdx@5.0.4':
+ resolution: {integrity: sha512-tSbuuYueNODiFAFaME7pjHY5lOLoxBYJi1cKd6scw9+a4ZO7C7UGdafEoVAQvOV2eO8a6RaHSAJYGVPL1w8BPA==}
+ engines: {node: '>=22.12.0'}
+ peerDependencies:
+ astro: ^6.0.0
+
+ '@astrojs/mdx@5.0.6':
+ resolution: {integrity: sha512-4dKe0ZMmqujofPNDHahzClkwinn9f8jHPcaXcgdGvPAlboD2mjzkUCofli2cBnxYAkdfhC6d50gBJ8i/cH8gHw==}
+ engines: {node: '>=22.12.0'}
+ peerDependencies:
+ astro: ^6.0.0
+
+ '@astrojs/prism@4.0.1':
+ resolution: {integrity: sha512-nksZQVjlferuWzhPsBpQ1JE5XuKAf1id1/9Hj4a9KG4+ofrlzxUUwX4YGQF/SuDiuiGKEnzopGOt38F3AnVWsQ==}
+ engines: {node: '>=22.12.0'}
+
+ '@astrojs/prism@4.0.2':
+ resolution: {integrity: sha512-KTivpmnz6lDsC6o9H4+DNm2SrE/GHzw8cNAvEJwAvUT+eoaEnn/4NtbDNfRRaxaJHdp15gf+tfHAWiXR4wB3BA==}
+ engines: {node: '>=22.12.0'}
+
+ '@astrojs/sitemap@3.7.2':
+ resolution: {integrity: sha512-PqkzkcZTb5ICiyIR8VoKbIAP/laNRXi5tw616N1Ckk+40oNB8Can1AzVV56lrbC5GKSZFCyJYUVYqVivMisvpA==}
+
+ '@astrojs/starlight@0.39.2':
+ resolution: {integrity: sha512-vlw+bwnjtf5buCTUtLU7JfV6D3knslxqnspr6LKs6hfRuFZiyr5hT44F7GyDqR9FKANUqFxnIzWM81F1k/kOUA==}
+ peerDependencies:
+ astro: ^6.0.0
+
+ '@astrojs/telemetry@3.3.2':
+ resolution: {integrity: sha512-j8DNruA8ors99Al39RYZPJK4DC1bKkoNm93mAMuBhY9TCNC4R8n1q7ovFnJ5qhGh5Lsh7pa1gpQVpYpsJPeTHQ==}
+ engines: {node: 18.20.8 || ^20.3.0 || >=22.0.0}
+
+ '@babel/helper-string-parser@7.27.1':
+ resolution: {integrity: sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-validator-identifier@7.28.5':
+ resolution: {integrity: sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/parser@7.29.3':
+ resolution: {integrity: sha512-b3ctpQwp+PROvU/cttc4OYl4MzfJUWy6FZg+PMXfzmt/+39iHVF0sDfqay8TQM3JA2EUOyKcFZt75jWriQijsA==}
+ engines: {node: '>=6.0.0'}
+ hasBin: true
+
+ '@babel/types@7.29.0':
+ resolution: {integrity: sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==}
+ engines: {node: '>=6.9.0'}
+
+ '@braintree/sanitize-url@7.1.2':
+ resolution: {integrity: sha512-jigsZK+sMF/cuiB7sERuo9V7N9jx+dhmHHnQyDSVdpZwVutaBu7WvNYqMDLSgFgfB30n452TP3vjDAvFC973mA==}
+
+ '@capsizecss/unpack@4.0.0':
+ resolution: {integrity: sha512-VERIM64vtTP1C4mxQ5thVT9fK0apjPFobqybMtA1UdUujWka24ERHbRHFGmpbbhp73MhV+KSsHQH9C6uOTdEQA==}
+ engines: {node: '>=18'}
+
+ '@chevrotain/types@11.1.2':
+ resolution: {integrity: sha512-U+HFai5+zmJCkK86QsaJtoITlboZHBqrVketcO2ROv865xfCMSFpELQoz1GkX5GzME8pTa+3kbKrZHQtI0gdbw==}
+
+ '@clack/core@1.3.1':
+ resolution: {integrity: sha512-fT1qHVGAag4IEkrupZ6lRRbNCs1vS9P01KB/sG8zKgvUztbYtFBtQpjSITNwooDZ83tpsPzP0mRNs1/KVszCRA==}
+ engines: {node: '>= 20.12.0'}
+
+ '@clack/prompts@1.4.0':
+ resolution: {integrity: sha512-S0My7XPGIgpRWMDG8uRqalbgT+a6FmCUdOW+HaIOVVpUPHOb7RrpvjTjiODadKp06fsrVDJZlIzc6yCTp4AnxA==}
+ engines: {node: '>= 20.12.0'}
+
+ '@ctrl/tinycolor@4.2.0':
+ resolution: {integrity: sha512-kzyuwOAQnXJNLS9PSyrk0CWk35nWJW/zl/6KvnTBMFK65gm7U1/Z5BqjxeapjZCIhQcM/DsrEmcbRwDyXyXK4A==}
+ engines: {node: '>=14'}
+
+ '@emnapi/runtime@1.9.2':
+ resolution: {integrity: sha512-3U4+MIWHImeyu1wnmVygh5WlgfYDtyf0k8AbLhMFxOipihf6nrWC4syIm/SwEeec0mNSafiiNnMJwbza/Is6Lw==}
+
+ '@esbuild/aix-ppc64@0.27.7':
+ resolution: {integrity: sha512-EKX3Qwmhz1eMdEJokhALr0YiD0lhQNwDqkPYyPhiSwKrh7/4KRjQc04sZ8db+5DVVnZ1LmbNDI1uAMPEUBnQPg==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [aix]
+
+ '@esbuild/android-arm64@0.27.7':
+ resolution: {integrity: sha512-62dPZHpIXzvChfvfLJow3q5dDtiNMkwiRzPylSCfriLvZeq0a1bWChrGx/BbUbPwOrsWKMn8idSllklzBy+dgQ==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [android]
+
+ '@esbuild/android-arm@0.27.7':
+ resolution: {integrity: sha512-jbPXvB4Yj2yBV7HUfE2KHe4GJX51QplCN1pGbYjvsyCZbQmies29EoJbkEc+vYuU5o45AfQn37vZlyXy4YJ8RQ==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [android]
+
+ '@esbuild/android-x64@0.27.7':
+ resolution: {integrity: sha512-x5VpMODneVDb70PYV2VQOmIUUiBtY3D3mPBG8NxVk5CogneYhkR7MmM3yR/uMdITLrC1ml/NV1rj4bMJuy9MCg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [android]
+
+ '@esbuild/darwin-arm64@0.27.7':
+ resolution: {integrity: sha512-5lckdqeuBPlKUwvoCXIgI2D9/ABmPq3Rdp7IfL70393YgaASt7tbju3Ac+ePVi3KDH6N2RqePfHnXkaDtY9fkw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@esbuild/darwin-x64@0.27.7':
+ resolution: {integrity: sha512-rYnXrKcXuT7Z+WL5K980jVFdvVKhCHhUwid+dDYQpH+qu+TefcomiMAJpIiC2EM3Rjtq0sO3StMV/+3w3MyyqQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [darwin]
+
+ '@esbuild/freebsd-arm64@0.27.7':
+ resolution: {integrity: sha512-B48PqeCsEgOtzME2GbNM2roU29AMTuOIN91dsMO30t+Ydis3z/3Ngoj5hhnsOSSwNzS+6JppqWsuhTp6E82l2w==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [freebsd]
+
+ '@esbuild/freebsd-x64@0.27.7':
+ resolution: {integrity: sha512-jOBDK5XEjA4m5IJK3bpAQF9/Lelu/Z9ZcdhTRLf4cajlB+8VEhFFRjWgfy3M1O4rO2GQ/b2dLwCUGpiF/eATNQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@esbuild/linux-arm64@0.27.7':
+ resolution: {integrity: sha512-RZPHBoxXuNnPQO9rvjh5jdkRmVizktkT7TCDkDmQ0W2SwHInKCAV95GRuvdSvA7w4VMwfCjUiPwDi0ZO6Nfe9A==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [linux]
+
+ '@esbuild/linux-arm@0.27.7':
+ resolution: {integrity: sha512-RkT/YXYBTSULo3+af8Ib0ykH8u2MBh57o7q/DAs3lTJlyVQkgQvlrPTnjIzzRPQyavxtPtfg0EopvDyIt0j1rA==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [linux]
+
+ '@esbuild/linux-ia32@0.27.7':
+ resolution: {integrity: sha512-GA48aKNkyQDbd3KtkplYWT102C5sn/EZTY4XROkxONgruHPU72l+gW+FfF8tf2cFjeHaRbWpOYa/uRBz/Xq1Pg==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [linux]
+
+ '@esbuild/linux-loong64@0.27.7':
+ resolution: {integrity: sha512-a4POruNM2oWsD4WKvBSEKGIiWQF8fZOAsycHOt6JBpZ+JN2n2JH9WAv56SOyu9X5IqAjqSIPTaJkqN8F7XOQ5Q==}
+ engines: {node: '>=18'}
+ cpu: [loong64]
+ os: [linux]
+
+ '@esbuild/linux-mips64el@0.27.7':
+ resolution: {integrity: sha512-KabT5I6StirGfIz0FMgl1I+R1H73Gp0ofL9A3nG3i/cYFJzKHhouBV5VWK1CSgKvVaG4q1RNpCTR2LuTVB3fIw==}
+ engines: {node: '>=18'}
+ cpu: [mips64el]
+ os: [linux]
+
+ '@esbuild/linux-ppc64@0.27.7':
+ resolution: {integrity: sha512-gRsL4x6wsGHGRqhtI+ifpN/vpOFTQtnbsupUF5R5YTAg+y/lKelYR1hXbnBdzDjGbMYjVJLJTd2OFmMewAgwlQ==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@esbuild/linux-riscv64@0.27.7':
+ resolution: {integrity: sha512-hL25LbxO1QOngGzu2U5xeXtxXcW+/GvMN3ejANqXkxZ/opySAZMrc+9LY/WyjAan41unrR3YrmtTsUpwT66InQ==}
+ engines: {node: '>=18'}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@esbuild/linux-s390x@0.27.7':
+ resolution: {integrity: sha512-2k8go8Ycu1Kb46vEelhu1vqEP+UeRVj2zY1pSuPdgvbd5ykAw82Lrro28vXUrRmzEsUV0NzCf54yARIK8r0fdw==}
+ engines: {node: '>=18'}
+ cpu: [s390x]
+ os: [linux]
+
+ '@esbuild/linux-x64@0.27.7':
+ resolution: {integrity: sha512-hzznmADPt+OmsYzw1EE33ccA+HPdIqiCRq7cQeL1Jlq2gb1+OyWBkMCrYGBJ+sxVzve2ZJEVeePbLM2iEIZSxA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [linux]
+
+ '@esbuild/netbsd-arm64@0.27.7':
+ resolution: {integrity: sha512-b6pqtrQdigZBwZxAn1UpazEisvwaIDvdbMbmrly7cDTMFnw/+3lVxxCTGOrkPVnsYIosJJXAsILG9XcQS+Yu6w==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [netbsd]
+
+ '@esbuild/netbsd-x64@0.27.7':
+ resolution: {integrity: sha512-OfatkLojr6U+WN5EDYuoQhtM+1xco+/6FSzJJnuWiUw5eVcicbyK3dq5EeV/QHT1uy6GoDhGbFpprUiHUYggrw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [netbsd]
+
+ '@esbuild/openbsd-arm64@0.27.7':
+ resolution: {integrity: sha512-AFuojMQTxAz75Fo8idVcqoQWEHIXFRbOc1TrVcFSgCZtQfSdc1RXgB3tjOn/krRHENUB4j00bfGjyl2mJrU37A==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openbsd]
+
+ '@esbuild/openbsd-x64@0.27.7':
+ resolution: {integrity: sha512-+A1NJmfM8WNDv5CLVQYJ5PshuRm/4cI6WMZRg1by1GwPIQPCTs1GLEUHwiiQGT5zDdyLiRM/l1G0Pv54gvtKIg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [openbsd]
+
+ '@esbuild/openharmony-arm64@0.27.7':
+ resolution: {integrity: sha512-+KrvYb/C8zA9CU/g0sR6w2RBw7IGc5J2BPnc3dYc5VJxHCSF1yNMxTV5LQ7GuKteQXZtspjFbiuW5/dOj7H4Yw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@esbuild/sunos-x64@0.27.7':
+ resolution: {integrity: sha512-ikktIhFBzQNt/QDyOL580ti9+5mL/YZeUPKU2ivGtGjdTYoqz6jObj6nOMfhASpS4GU4Q/Clh1QtxWAvcYKamA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [sunos]
+
+ '@esbuild/win32-arm64@0.27.7':
+ resolution: {integrity: sha512-7yRhbHvPqSpRUV7Q20VuDwbjW5kIMwTHpptuUzV+AA46kiPze5Z7qgt6CLCK3pWFrHeNfDd1VKgyP4O+ng17CA==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [win32]
+
+ '@esbuild/win32-ia32@0.27.7':
+ resolution: {integrity: sha512-SmwKXe6VHIyZYbBLJrhOoCJRB/Z1tckzmgTLfFYOfpMAx63BJEaL9ExI8x7v0oAO3Zh6D/Oi1gVxEYr5oUCFhw==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [win32]
+
+ '@esbuild/win32-x64@0.27.7':
+ resolution: {integrity: sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [win32]
+
+ '@expressive-code/core@0.42.0':
+ resolution: {integrity: sha512-MN11+9nfmaC7sYu2BZJXAXqwkBRt8t1xTSqP+Ti1NfTEskgl6xUnzDxoaiQkg0BMzpglA0pys4dpDKquP/cyIw==}
+
+ '@expressive-code/plugin-frames@0.42.0':
+ resolution: {integrity: sha512-XtkPm+941Uta7Y+81Acv+OA/20F1NJmJhCX6UYGKpqEIGqplNh3PTOhcURp6tcruhlzJcWcvpWy6Oigz3SrjqA==}
+
+ '@expressive-code/plugin-shiki@0.42.0':
+ resolution: {integrity: sha512-PMKey/kLmewttAHQezL+Y5Fx3vVssfDi3+FJOYQQS2mXP3tQspFELtKKAfsXfmSXdToZYgwoO69HJndqfE+09g==}
+
+ '@expressive-code/plugin-text-markers@0.42.0':
+ resolution: {integrity: sha512-l59lUx8fq1v5g6SpmbDjiU0+7IdfbiWnAyRmtTVSpfhyq+nZMN4UcmYyu2b9Mynhzt7Gr+O+cXyEPDNb2AVWVQ==}
+
+ '@fontsource-variable/inter@5.2.8':
+ resolution: {integrity: sha512-kOfP2D+ykbcX/P3IFnokOhVRNoTozo5/JxhAIVYLpea/UBmCQ/YWPBfWIDuBImXX/15KH+eKh4xpEUyS2sQQGQ==}
+
+ '@fontsource-variable/roboto-mono@5.2.9':
+ resolution: {integrity: sha512-OzFO2AXlSGcXl/NcXS3CGjImb6rczCByPJ1C+Dzp9kkYOrUPyrGTuAtqPcmA/d+nZGX5oyOWKXLk5BrwVLYqkw==}
+
+ '@iconify/types@2.0.0':
+ resolution: {integrity: sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==}
+
+ '@iconify/utils@3.1.0':
+ resolution: {integrity: sha512-Zlzem1ZXhI1iHeeERabLNzBHdOa4VhQbqAcOQaMKuTuyZCpwKbC2R4Dd0Zo3g9EAc+Y4fiarO8HIHRAth7+skw==}
+
+ '@img/colour@1.1.0':
+ resolution: {integrity: sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==}
+ engines: {node: '>=18'}
+
+ '@img/sharp-darwin-arm64@0.34.5':
+ resolution: {integrity: sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@img/sharp-darwin-x64@0.34.5':
+ resolution: {integrity: sha512-YNEFAF/4KQ/PeW0N+r+aVVsoIY0/qxxikF2SWdp+NRkmMB7y9LBZAVqQ4yhGCm/H3H270OSykqmQMKLBhBJDEw==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [x64]
+ os: [darwin]
+
+ '@img/sharp-libvips-darwin-arm64@1.2.4':
+ resolution: {integrity: sha512-zqjjo7RatFfFoP0MkQ51jfuFZBnVE2pRiaydKJ1G/rHZvnsrHAOcQALIi9sA5co5xenQdTugCvtb1cuf78Vf4g==}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@img/sharp-libvips-darwin-x64@1.2.4':
+ resolution: {integrity: sha512-1IOd5xfVhlGwX+zXv2N93k0yMONvUlANylbJw1eTah8K/Jtpi15KC+WSiaX/nBmbm2HxRM1gZ0nSdjSsrZbGKg==}
+ cpu: [x64]
+ os: [darwin]
+
+ '@img/sharp-libvips-linux-arm64@1.2.4':
+ resolution: {integrity: sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==}
+ cpu: [arm64]
+ os: [linux]
+
+ '@img/sharp-libvips-linux-arm@1.2.4':
+ resolution: {integrity: sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==}
+ cpu: [arm]
+ os: [linux]
+
+ '@img/sharp-libvips-linux-ppc64@1.2.4':
+ resolution: {integrity: sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@img/sharp-libvips-linux-riscv64@1.2.4':
+ resolution: {integrity: sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@img/sharp-libvips-linux-s390x@1.2.4':
+ resolution: {integrity: sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==}
+ cpu: [s390x]
+ os: [linux]
+
+ '@img/sharp-libvips-linux-x64@1.2.4':
+ resolution: {integrity: sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==}
+ cpu: [x64]
+ os: [linux]
+
+ '@img/sharp-libvips-linuxmusl-arm64@1.2.4':
+ resolution: {integrity: sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==}
+ cpu: [arm64]
+ os: [linux]
+
+ '@img/sharp-libvips-linuxmusl-x64@1.2.4':
+ resolution: {integrity: sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==}
+ cpu: [x64]
+ os: [linux]
+
+ '@img/sharp-linux-arm64@0.34.5':
+ resolution: {integrity: sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [arm64]
+ os: [linux]
+
+ '@img/sharp-linux-arm@0.34.5':
+ resolution: {integrity: sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@img/sharp-linux-ppc64@0.34.5':
+ resolution: {integrity: sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@img/sharp-linux-riscv64@0.34.5':
+ resolution: {integrity: sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@img/sharp-linux-s390x@0.34.5':
+ resolution: {integrity: sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [s390x]
+ os: [linux]
+
+ '@img/sharp-linux-x64@0.34.5':
+ resolution: {integrity: sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [x64]
+ os: [linux]
+
+ '@img/sharp-linuxmusl-arm64@0.34.5':
+ resolution: {integrity: sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [arm64]
+ os: [linux]
+
+ '@img/sharp-linuxmusl-x64@0.34.5':
+ resolution: {integrity: sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [x64]
+ os: [linux]
+
+ '@img/sharp-wasm32@0.34.5':
+ resolution: {integrity: sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [wasm32]
+
+ '@img/sharp-win32-arm64@0.34.5':
+ resolution: {integrity: sha512-WQ3AgWCWYSb2yt+IG8mnC6Jdk9Whs7O0gxphblsLvdhSpSTtmu69ZG1Gkb6NuvxsNACwiPV6cNSZNzt0KPsw7g==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [arm64]
+ os: [win32]
+
+ '@img/sharp-win32-ia32@0.34.5':
+ resolution: {integrity: sha512-FV9m/7NmeCmSHDD5j4+4pNI8Cp3aW+JvLoXcTUo0IqyjSfAZJ8dIUmijx1qaJsIiU+Hosw6xM5KijAWRJCSgNg==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [ia32]
+ os: [win32]
+
+ '@img/sharp-win32-x64@0.34.5':
+ resolution: {integrity: sha512-+29YMsqY2/9eFEiW93eqWnuLcWcufowXewwSNIT6UwZdUUCrM3oFjMWH/Z6/TMmb4hlFenmfAVbpWeup2jryCw==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+ cpu: [x64]
+ os: [win32]
+
+ '@isaacs/fs-minipass@4.0.1':
+ resolution: {integrity: sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==}
+ engines: {node: '>=18.0.0'}
+
+ '@jridgewell/sourcemap-codec@1.5.5':
+ resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==}
+
+ '@mdx-js/mdx@3.1.1':
+ resolution: {integrity: sha512-f6ZO2ifpwAQIpzGWaBQT2TXxPv6z3RBzQKpVftEWN78Vl/YweF1uwussDx8ECAXVtr3Rs89fKyG9YlzUs9DyGQ==}
+
+ '@mermaid-js/parser@1.1.1':
+ resolution: {integrity: sha512-VuHdsYMK1bT6X2JbcAaWAhugTRvRBRyuZgd+c22swUeI9g/ntaxF7CY7dYarhZovofCbUNO0G7JesfmNtjYOCw==}
+
+ '@oslojs/encoding@1.1.0':
+ resolution: {integrity: sha512-70wQhgYmndg4GCPxPPxPGevRKqTIJ2Nh4OkiMWmDAVYsTQ+Ta7Sq+rPevXyXGdzr30/qZBnyOalCszoMxlyldQ==}
+
+ '@pagefind/darwin-arm64@1.5.2':
+ resolution: {integrity: sha512-MXpI+7HsAdPkvJ0gk9xj9g541BCqBZOBbdwj9g6lB5LCj6kSV6nqDSjzcAJwvOsfu0fjwvC8hQU+ecfhp+MpiQ==}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@pagefind/darwin-x64@1.5.2':
+ resolution: {integrity: sha512-IojxFWMEJe0RQ7PQ3KXQsPIImNsbpPYpoZ+QUDrL8fAl/O27IX+LVLs74/UzEZy5uA2LD8Nz1AiwKr72vrkZQw==}
+ cpu: [x64]
+ os: [darwin]
+
+ '@pagefind/default-ui@1.5.2':
+ resolution: {integrity: sha512-pm1LMnQg8N2B3n2TnjKlhaFihpz6zTiA4HiGQ6/slKO/+8K9CAU5kcjdSSPgpuk1PMuuN4hxLipUIifnrkl3Sg==}
+
+ '@pagefind/freebsd-x64@1.5.2':
+ resolution: {integrity: sha512-7EVzo9+0w+2cbe671BtMj10UlNo83I+HrLVLfRxO731svHRJKUfJ/mo05gU14pe9PCfpKNQT8FS3Xc/oDN6pOA==}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@pagefind/linux-arm64@1.5.2':
+ resolution: {integrity: sha512-Ovt9+K35sqzn8H3ZMXGwls4TD/wMJuvRtShHIsmUQREmaxjrDEX7gHckRCrwYJ4XE1H1p6HkLz3wukrAnsfXQw==}
+ cpu: [arm64]
+ os: [linux]
+
+ '@pagefind/linux-x64@1.5.2':
+ resolution: {integrity: sha512-V+tFqHKXhQKq/WqPBD67AFy7scn1/aZID00ws4fSDd+1daSi5UHR9VVlRrOUYKxn3VuFQYRD7lYXdZK1WED1YA==}
+ cpu: [x64]
+ os: [linux]
+
+ '@pagefind/windows-arm64@1.5.2':
+ resolution: {integrity: sha512-hN9Nh90fNW61nNRCW9ZyQrAj/mD0eRvmJ8NlTUzkbuW8kIzGJUi3cxjFkEcMZ5h/8FsKWD/VcouZl4yo1F7B6g==}
+ cpu: [arm64]
+ os: [win32]
+
+ '@pagefind/windows-x64@1.5.2':
+ resolution: {integrity: sha512-Fa2Iyw7kaDRzGMfNYNUXNW2zbL5FQVDgSOcbDHdzBrDEdpqOqg8TcZ68F22ol6NJ9IGzvUdmeyZypLW5dyhqsg==}
+ cpu: [x64]
+ os: [win32]
+
+ '@rollup/pluginutils@5.3.0':
+ resolution: {integrity: sha512-5EdhGZtnu3V88ces7s53hhfK5KSASnJZv8Lulpc04cWO3REESroJXg73DFsOmgbU2BhwV0E20bu2IDZb3VKW4Q==}
+ engines: {node: '>=14.0.0'}
+ peerDependencies:
+ rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/rollup-android-arm-eabi@4.60.4':
+ resolution: {integrity: sha512-F5QXMSiFebS9hKZj02XhWLLnRpJ3B3AROP0tWbFBSj+6kCbg5m9j5JoHKd4mmSVy5mS/IMQloYgYxCuJC0fxEQ==}
+ cpu: [arm]
+ os: [android]
+
+ '@rollup/rollup-android-arm64@4.60.4':
+ resolution: {integrity: sha512-GxxTKApUpzRhof7poWvCJHRF51C67u1R7D6DiluBE8wKU1u5GWE8t+v81JvJYtbawoBFX1hLv5Ei4eVjkWokaw==}
+ cpu: [arm64]
+ os: [android]
+
+ '@rollup/rollup-darwin-arm64@4.60.4':
+ resolution: {integrity: sha512-tua0TaJxMOB1R0V0RS1jFZ/RpURFDJIOR2A6jWwQeawuFyS4gBW+rntLRaQd0EQ4bd6Vp44Z2rXW+YYDBsj6IA==}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@rollup/rollup-darwin-x64@4.60.4':
+ resolution: {integrity: sha512-CSKq7MsP+5PFIcydhAiR1K0UhEI1A2jWXVKHPCBZ151yOutENwvnPocgVHkivu2kviURtCEB6zUQw0vs8RrhMg==}
+ cpu: [x64]
+ os: [darwin]
+
+ '@rollup/rollup-freebsd-arm64@4.60.4':
+ resolution: {integrity: sha512-+O8OkVdyvXMtJEciu2wS/pzm1IxntEEQx3z5TAVy4l32G0etZn+RsA48ARRrFm6Ri8fvqPQfgrvNxSjKAbnd3g==}
+ cpu: [arm64]
+ os: [freebsd]
+
+ '@rollup/rollup-freebsd-x64@4.60.4':
+ resolution: {integrity: sha512-Iw3oMskH3AfNuhU0MSN7vNbdi4me/NiYo2azqPz/Le16zHSa+3RRmliCMWWQmh4lcndccU40xcJuTYJZxNo/lw==}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@rollup/rollup-linux-arm-gnueabihf@4.60.4':
+ resolution: {integrity: sha512-EIPRXTVQpHyF8WOo219AD2yEltPehLTcTMz2fn6JsatLYSzQf00hj3rulF+yauOlF9/FtM2WpkT/hJh/KJFGhA==}
+ cpu: [arm]
+ os: [linux]
+
+ '@rollup/rollup-linux-arm-musleabihf@4.60.4':
+ resolution: {integrity: sha512-J3Yh9PzzF1Ovah2At+lHiGQdsYgArxBbXv/zHfSyaiFQEqvNv7DcW98pCrmdjCZBrqBiKrKKe2V+aaSGWuBe/w==}
+ cpu: [arm]
+ os: [linux]
+
+ '@rollup/rollup-linux-arm64-gnu@4.60.4':
+ resolution: {integrity: sha512-BFDEZMYfUvLn37ONE1yMBojPxnMlTFsdyNoqncT0qFq1mAfllL+ATMMJd8TeuVMiX84s1KbcxcZbXInmcO2mRg==}
+ cpu: [arm64]
+ os: [linux]
+
+ '@rollup/rollup-linux-arm64-musl@4.60.4':
+ resolution: {integrity: sha512-pc9EYOSlOgdQ2uPl1o9PF6/kLSgaUosia7gOuS8mB69IxJvlclko1MECXysjs5ryez1/5zjYqx3+xYU0TU6R1A==}
+ cpu: [arm64]
+ os: [linux]
+
+ '@rollup/rollup-linux-loong64-gnu@4.60.4':
+ resolution: {integrity: sha512-NxnomyxYerDh5n4iLrNa+sH+Z+U4BMEE46V2PgQ/hoB909i8gV1M5wPojWg9fk1jWpO3IQnOs20K4wyZuFLEFQ==}
+ cpu: [loong64]
+ os: [linux]
+
+ '@rollup/rollup-linux-loong64-musl@4.60.4':
+ resolution: {integrity: sha512-nbJnQ8a3z1mtmrwImCYhc6BGpThAyYVRQxw9uKSKG4wR6aAYno9sVjJ0zaZcW9BPJX1GbrDPf+SvdWjgTuDmnw==}
+ cpu: [loong64]
+ os: [linux]
+
+ '@rollup/rollup-linux-ppc64-gnu@4.60.4':
+ resolution: {integrity: sha512-2EU6acNrQLd8tYvo/LXW535wupT3m6fo7HKo6lr7ktQoItxTyOL1ZCR/GfGCuXl2vR+zmfI6eRXkSemafv+iVg==}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@rollup/rollup-linux-ppc64-musl@4.60.4':
+ resolution: {integrity: sha512-WeBtoMuaMxiiIrO2IYP3xs6GMWkJP2C0EoT8beTLkUPmzV1i/UcOSVw1d5r9KBODtHKilG5yFxsGRnBbK3wJ4A==}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@rollup/rollup-linux-riscv64-gnu@4.60.4':
+ resolution: {integrity: sha512-FJHFfqpKUI3A10WrWKiFbBZ7yVbGT4q4B5o1qKFFojqpaYoh9LrQgqWCmmcxQzVSXYtyB5bzkXrYzlHTs21MYA==}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@rollup/rollup-linux-riscv64-musl@4.60.4':
+ resolution: {integrity: sha512-mcEl6CUT5IAUmQf1m9FYSmVqCJlpQ8r8eyftFUHG8i9OhY7BkBXSUdnLH5DOf0wCOjcP9v/QO93zpmF1SptCCw==}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@rollup/rollup-linux-s390x-gnu@4.60.4':
+ resolution: {integrity: sha512-ynt3JxVd2w2buzoKDWIyiV1pJW93xlQic1THVLXilz429oijRpSHivZAgp65KBu+cMcgf1eVVjdnTLvPxgCuoQ==}
+ cpu: [s390x]
+ os: [linux]
+
+ '@rollup/rollup-linux-x64-gnu@4.60.4':
+ resolution: {integrity: sha512-Boiz5+MsaROEWDf+GGEwF8VMHGhlUoQMtIPjOgA5fv4osupqTVnJteQNKJwUcnUog2G55jYXH7KZFFiJe0TEzQ==}
+ cpu: [x64]
+ os: [linux]
+
+ '@rollup/rollup-linux-x64-musl@4.60.4':
+ resolution: {integrity: sha512-+qfSY27qIrFfI/Hom04KYFw3GKZSGU4lXus51wsb5EuySfFlWRwjkKWoE9emgRw/ukoT4Udsj4W/+xxG8VbPKg==}
+ cpu: [x64]
+ os: [linux]
+
+ '@rollup/rollup-openbsd-x64@4.60.4':
+ resolution: {integrity: sha512-VpTfOPHgVXEBeeR8hZ2O0F3aSso+JDWqTWmTmzcQKted54IAdUVbxE+j/MVxUsKa8L20HJhv3vUezVPoquqWjA==}
+ cpu: [x64]
+ os: [openbsd]
+
+ '@rollup/rollup-openharmony-arm64@4.60.4':
+ resolution: {integrity: sha512-IPOsh5aRYuLv/nkU51X10Bf75Bsf6+gZdx1X+QP5QM6lIJFHHqbHLG0uJn/hWthzo13UAc2umiUorqZy3axoZg==}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@rollup/rollup-win32-arm64-msvc@4.60.4':
+ resolution: {integrity: sha512-4QzE9E81OohJ/HKzHhsqU+zcYYojVOXlFMs1DdyMT6qXl/niOH7AVElmmEdUNHHS/oRkc++d5k6Vy85zFs0DEw==}
+ cpu: [arm64]
+ os: [win32]
+
+ '@rollup/rollup-win32-ia32-msvc@4.60.4':
+ resolution: {integrity: sha512-zTPgT1YuHHcd+Tmx7h8aml0FWFVelV5N54oHow9SLj+GfoDy/huQ+UV396N/C7KpMDMiPspRktzM1/0r1usYEA==}
+ cpu: [ia32]
+ os: [win32]
+
+ '@rollup/rollup-win32-x64-gnu@4.60.4':
+ resolution: {integrity: sha512-DRS4G7mi9lJxqEDezIkKCaUIKCrLUUDCUaCsTPCi/rtqaC6D/jjwslMQyiDU50Ka0JKpeXeRBFBAXwArY52vBw==}
+ cpu: [x64]
+ os: [win32]
+
+ '@rollup/rollup-win32-x64-msvc@4.60.4':
+ resolution: {integrity: sha512-QVTUovf40zgTqlFVrKA1uXMVvU2QWEFWfAH8Wdc48IxLvrJMQVMBRjuQyUpzZCDkakImib9eVazbWlC6ksWtJw==}
+ cpu: [x64]
+ os: [win32]
+
+ '@shikijs/core@4.0.2':
+ resolution: {integrity: sha512-hxT0YF4ExEqB8G/qFdtJvpmHXBYJ2lWW7qTHDarVkIudPFE6iCIrqdgWxGn5s+ppkGXI0aEGlibI0PAyzP3zlw==}
+ engines: {node: '>=20'}
+
+ '@shikijs/core@4.1.0':
+ resolution: {integrity: sha512-jLJtSJeuFffqX6/inRE1zqU5aFv2hrszvYgq3OjbAgFRZiWv7abKMDdQzYxuSDfmUPQozZvI/kuy6VMTvnvqTQ==}
+ engines: {node: '>=20'}
+
+ '@shikijs/engine-javascript@4.0.2':
+ resolution: {integrity: sha512-7PW0Nm49DcoUIQEXlJhNNBHyoGMjalRETTCcjMqEaMoJRLljy1Bi/EGV3/qLBgLKQejdspiiYuHGQW6dX94Nag==}
+ engines: {node: '>=20'}
+
+ '@shikijs/engine-javascript@4.1.0':
+ resolution: {integrity: sha512-YquhawCUgaBfhsS72e2Y/dI59gCBNPHu3fEO/tvLaXrTssxZrY5ddjtNLTwndrMgPo8b3IscE+xoICDzpTmlFQ==}
+ engines: {node: '>=20'}
+
+ '@shikijs/engine-oniguruma@4.0.2':
+ resolution: {integrity: sha512-UpCB9Y2sUKlS9z8juFSKz7ZtysmeXCgnRF0dlhXBkmQnek7lAToPte8DkxmEYGNTMii72zU/lyXiCB6StuZeJg==}
+ engines: {node: '>=20'}
+
+ '@shikijs/engine-oniguruma@4.1.0':
+ resolution: {integrity: sha512-axLpjVs45YBvvINa+dJF+NPW+KtFkNXsFr4SDw2BMj9GdeMnGxVB9PQb2xXlJYovslt/nz6giedAyOANkfc7hg==}
+ engines: {node: '>=20'}
+
+ '@shikijs/langs@4.0.2':
+ resolution: {integrity: sha512-KaXby5dvoeuZzN0rYQiPMjFoUrz4hgwIE+D6Du9owcHcl6/g16/yT5BQxSW5cGt2MZBz6Hl0YuRqf12omRfUUg==}
+ engines: {node: '>=20'}
+
+ '@shikijs/langs@4.1.0':
+ resolution: {integrity: sha512-nwOMruEkbgdZfQ/b8CgpNBVOpvG1k0N5tbmgiFeqsan401+x3ILqlzZJowSla4Agmq4hG2Uf2wh5jLTEhR8VSg==}
+ engines: {node: '>=20'}
+
+ '@shikijs/primitive@4.0.2':
+ resolution: {integrity: sha512-M6UMPrSa3fN5ayeJwFVl9qWofl273wtK1VG8ySDZ1mQBfhCpdd8nEx7nPZ/tk7k+TYcpqBZzj/AnwxT9lO+HJw==}
+ engines: {node: '>=20'}
+
+ '@shikijs/primitive@4.1.0':
+ resolution: {integrity: sha512-zx2/2Uwj2q9X3KSyYREEhXO23xBw5WUhP4orK2lE4r+t9JGITmEe0JH+wPmJhqHpOT2bRRs6lAL945+LDvOAGw==}
+ engines: {node: '>=20'}
+
+ '@shikijs/themes@4.0.2':
+ resolution: {integrity: sha512-mjCafwt8lJJaVSsQvNVrJumbnnj1RI8jbUKrPKgE6E3OvQKxnuRoBaYC51H4IGHePsGN/QtALglWBU7DoKDFnA==}
+ engines: {node: '>=20'}
+
+ '@shikijs/themes@4.1.0':
+ resolution: {integrity: sha512-emCcTnUM7yO2wltYbaxm+yLvcCI4+h8XBKc4KmJ7EZUXoSGjcCHifkI//R4OFit9ewpg7H2/9tjOuXrT2v/Knw==}
+ engines: {node: '>=20'}
+
+ '@shikijs/types@4.0.2':
+ resolution: {integrity: sha512-qzbeRooUTPnLE+sHD/Z8DStmaDgnbbc/pMrU203950aRqjX/6AFHeDYT+j00y2lPdz0ywJKx7o/7qnqTivtlXg==}
+ engines: {node: '>=20'}
+
+ '@shikijs/types@4.1.0':
+ resolution: {integrity: sha512-3EQWX54fMpniOrDblzAhiwiJwpiTMW6+B9DWyUd9ska483tbayFYuw47UxwuPknI31bKnySfVQ/QW+jFL4rFdA==}
+ engines: {node: '>=20'}
+
+ '@shikijs/vscode-textmate@10.0.2':
+ resolution: {integrity: sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==}
+
+ '@types/braces@3.0.5':
+ resolution: {integrity: sha512-SQFof9H+LXeWNz8wDe7oN5zu7ket0qwMu5vZubW4GCJ8Kkeh6nBWUz87+KTz/G3Kqsrp0j/W253XJb3KMEeg3w==}
+
+ '@types/d3-array@3.2.2':
+ resolution: {integrity: sha512-hOLWVbm7uRza0BYXpIIW5pxfrKe0W+D5lrFiAEYR+pb6w3N2SwSMaJbXdUfSEv+dT4MfHBLtn5js0LAWaO6otw==}
+
+ '@types/d3-axis@3.0.6':
+ resolution: {integrity: sha512-pYeijfZuBd87T0hGn0FO1vQ/cgLk6E1ALJjfkC0oJ8cbwkZl3TpgS8bVBLZN+2jjGgg38epgxb2zmoGtSfvgMw==}
+
+ '@types/d3-brush@3.0.6':
+ resolution: {integrity: sha512-nH60IZNNxEcrh6L1ZSMNA28rj27ut/2ZmI3r96Zd+1jrZD++zD3LsMIjWlvg4AYrHn/Pqz4CF3veCxGjtbqt7A==}
+
+ '@types/d3-chord@3.0.6':
+ resolution: {integrity: sha512-LFYWWd8nwfwEmTZG9PfQxd17HbNPksHBiJHaKuY1XeqscXacsS2tyoo6OdRsjf+NQYeB6XrNL3a25E3gH69lcg==}
+
+ '@types/d3-color@3.1.3':
+ resolution: {integrity: sha512-iO90scth9WAbmgv7ogoq57O9YpKmFBbmoEoCHDB2xMBY0+/KVrqAaCDyCE16dUspeOvIxFFRI+0sEtqDqy2b4A==}
+
+ '@types/d3-contour@3.0.6':
+ resolution: {integrity: sha512-BjzLgXGnCWjUSYGfH1cpdo41/hgdWETu4YxpezoztawmqsvCeep+8QGfiY6YbDvfgHz/DkjeIkkZVJavB4a3rg==}
+
+ '@types/d3-delaunay@6.0.4':
+ resolution: {integrity: sha512-ZMaSKu4THYCU6sV64Lhg6qjf1orxBthaC161plr5KuPHo3CNm8DTHiLw/5Eq2b6TsNP0W0iJrUOFscY6Q450Hw==}
+
+ '@types/d3-dispatch@3.0.7':
+ resolution: {integrity: sha512-5o9OIAdKkhN1QItV2oqaE5KMIiXAvDWBDPrD85e58Qlz1c1kI/J0NcqbEG88CoTwJrYe7ntUCVfeUl2UJKbWgA==}
+
+ '@types/d3-drag@3.0.7':
+ resolution: {integrity: sha512-HE3jVKlzU9AaMazNufooRJ5ZpWmLIoc90A37WU2JMmeq28w1FQqCZswHZ3xR+SuxYftzHq6WU6KJHvqxKzTxxQ==}
+
+ '@types/d3-dsv@3.0.7':
+ resolution: {integrity: sha512-n6QBF9/+XASqcKK6waudgL0pf/S5XHPPI8APyMLLUHd8NqouBGLsU8MgtO7NINGtPBtk9Kko/W4ea0oAspwh9g==}
+
+ '@types/d3-ease@3.0.2':
+ resolution: {integrity: sha512-NcV1JjO5oDzoK26oMzbILE6HW7uVXOHLQvHshBUW4UMdZGfiY6v5BeQwh9a9tCzv+CeefZQHJt5SRgK154RtiA==}
+
+ '@types/d3-fetch@3.0.7':
+ resolution: {integrity: sha512-fTAfNmxSb9SOWNB9IoG5c8Hg6R+AzUHDRlsXsDZsNp6sxAEOP0tkP3gKkNSO/qmHPoBFTxNrjDprVHDQDvo5aA==}
+
+ '@types/d3-force@3.0.10':
+ resolution: {integrity: sha512-ZYeSaCF3p73RdOKcjj+swRlZfnYpK1EbaDiYICEEp5Q6sUiqFaFQ9qgoshp5CzIyyb/yD09kD9o2zEltCexlgw==}
+
+ '@types/d3-format@3.0.4':
+ resolution: {integrity: sha512-fALi2aI6shfg7vM5KiR1wNJnZ7r6UuggVqtDA+xiEdPZQwy/trcQaHnwShLuLdta2rTymCNpxYTiMZX/e09F4g==}
+
+ '@types/d3-geo@3.1.0':
+ resolution: {integrity: sha512-856sckF0oP/diXtS4jNsiQw/UuK5fQG8l/a9VVLeSouf1/PPbBE1i1W852zVwKwYCBkFJJB7nCFTbk6UMEXBOQ==}
+
+ '@types/d3-hierarchy@3.1.7':
+ resolution: {integrity: sha512-tJFtNoYBtRtkNysX1Xq4sxtjK8YgoWUNpIiUee0/jHGRwqvzYxkq0hGVbbOGSz+JgFxxRu4K8nb3YpG3CMARtg==}
+
+ '@types/d3-interpolate@3.0.4':
+ resolution: {integrity: sha512-mgLPETlrpVV1YRJIglr4Ez47g7Yxjl1lj7YKsiMCb27VJH9W8NVM6Bb9d8kkpG/uAQS5AmbA48q2IAolKKo1MA==}
+
+ '@types/d3-path@3.1.1':
+ resolution: {integrity: sha512-VMZBYyQvbGmWyWVea0EHs/BwLgxc+MKi1zLDCONksozI4YJMcTt8ZEuIR4Sb1MMTE8MMW49v0IwI5+b7RmfWlg==}
+
+ '@types/d3-polygon@3.0.2':
+ resolution: {integrity: sha512-ZuWOtMaHCkN9xoeEMr1ubW2nGWsp4nIql+OPQRstu4ypeZ+zk3YKqQT0CXVe/PYqrKpZAi+J9mTs05TKwjXSRA==}
+
+ '@types/d3-quadtree@3.0.6':
+ resolution: {integrity: sha512-oUzyO1/Zm6rsxKRHA1vH0NEDG58HrT5icx/azi9MF1TWdtttWl0UIUsjEQBBh+SIkrpd21ZjEv7ptxWys1ncsg==}
+
+ '@types/d3-random@3.0.3':
+ resolution: {integrity: sha512-Imagg1vJ3y76Y2ea0871wpabqp613+8/r0mCLEBfdtqC7xMSfj9idOnmBYyMoULfHePJyxMAw3nWhJxzc+LFwQ==}
+
+ '@types/d3-scale-chromatic@3.1.0':
+ resolution: {integrity: sha512-iWMJgwkK7yTRmWqRB5plb1kadXyQ5Sj8V/zYlFGMUBbIPKQScw+Dku9cAAMgJG+z5GYDoMjWGLVOvjghDEFnKQ==}
+
+ '@types/d3-scale@4.0.9':
+ resolution: {integrity: sha512-dLmtwB8zkAeO/juAMfnV+sItKjlsw2lKdZVVy6LRr0cBmegxSABiLEpGVmSJJ8O08i4+sGR6qQtb6WtuwJdvVw==}
+
+ '@types/d3-selection@3.0.11':
+ resolution: {integrity: sha512-bhAXu23DJWsrI45xafYpkQ4NtcKMwWnAC/vKrd2l+nxMFuvOT3XMYTIj2opv8vq8AO5Yh7Qac/nSeP/3zjTK0w==}
+
+ '@types/d3-shape@3.1.8':
+ resolution: {integrity: sha512-lae0iWfcDeR7qt7rA88BNiqdvPS5pFVPpo5OfjElwNaT2yyekbM0C9vK+yqBqEmHr6lDkRnYNoTBYlAgJa7a4w==}
+
+ '@types/d3-time-format@4.0.3':
+ resolution: {integrity: sha512-5xg9rC+wWL8kdDj153qZcsJ0FWiFt0J5RB6LYUNZjwSnesfblqrI/bJ1wBdJ8OQfncgbJG5+2F+qfqnqyzYxyg==}
+
+ '@types/d3-time@3.0.4':
+ resolution: {integrity: sha512-yuzZug1nkAAaBlBBikKZTgzCeA+k1uy4ZFwWANOfKw5z5LRhV0gNA7gNkKm7HoK+HRN0wX3EkxGk0fpbWhmB7g==}
+
+ '@types/d3-timer@3.0.2':
+ resolution: {integrity: sha512-Ps3T8E8dZDam6fUyNiMkekK3XUsaUEik+idO9/YjPtfj2qruF8tFBXS7XhtE4iIXBLxhmLjP3SXpLhVf21I9Lw==}
+
+ '@types/d3-transition@3.0.9':
+ resolution: {integrity: sha512-uZS5shfxzO3rGlu0cC3bjmMFKsXv+SmZZcgp0KD22ts4uGXp5EVYGzu/0YdwZeKmddhcAccYtREJKkPfXkZuCg==}
+
+ '@types/d3-zoom@3.0.8':
+ resolution: {integrity: sha512-iqMC4/YlFCSlO8+2Ii1GGGliCAY4XdeG748w5vQUbevlbDu0zSjH/+jojorQVBK/se0j6DUFNPBGSqD3YWYnDw==}
+
+ '@types/d3@7.4.3':
+ resolution: {integrity: sha512-lZXZ9ckh5R8uiFVt8ogUNf+pIrK4EsWrx2Np75WvF/eTpJ0FMHNhjXk8CKEx/+gpHbNQyJWehbFaTvqmHWB3ww==}
+
+ '@types/debug@4.1.13':
+ resolution: {integrity: sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==}
+
+ '@types/estree-jsx@1.0.5':
+ resolution: {integrity: sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==}
+
+ '@types/estree@1.0.8':
+ resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
+
+ '@types/estree@1.0.9':
+ resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==}
+
+ '@types/geojson@7946.0.16':
+ resolution: {integrity: sha512-6C8nqWur3j98U6+lXDfTUWIfgvZU+EumvpHKcYjujKH7woYyLj2sUmff0tRhrqM7BohUw7Pz3ZB1jj2gW9Fvmg==}
+
+ '@types/hast@3.0.4':
+ resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==}
+
+ '@types/js-yaml@4.0.9':
+ resolution: {integrity: sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg==}
+
+ '@types/mdast@4.0.4':
+ resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
+
+ '@types/mdx@2.0.13':
+ resolution: {integrity: sha512-+OWZQfAYyio6YkJb3HLxDrvnx6SWWDbC0zVPfBRzUk0/nqoDyf6dNxQi3eArPe8rJ473nobTMQ/8Zk+LxJ+Yuw==}
+
+ '@types/micromatch@4.0.10':
+ resolution: {integrity: sha512-5jOhFDElqr4DKTrTEbnW8DZ4Hz5LRUEmyrGpCMrD/NphYv3nUnaF08xmSLx1rGGnyEs/kFnhiw6dCgcDqMr5PQ==}
+
+ '@types/ms@2.1.0':
+ resolution: {integrity: sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==}
+
+ '@types/nlcst@2.0.3':
+ resolution: {integrity: sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA==}
+
+ '@types/node@24.12.3':
+ resolution: {integrity: sha512-8oljBDGun9cIsZRJR6fkihn0TSXJI0UDOOhncYaERq6M0JMDoPLxyscwruJcb4GKS6dvK/d8xebYBg27h/duaQ==}
+
+ '@types/picomatch@4.0.3':
+ resolution: {integrity: sha512-iG0T6+nYJ9FAPmx9SsUlnwcq1ZVRuCXcVEvWnntoPlrOpwtSTKNDC9uVAxTsC3PUvJ+99n4RpAcNgBbHX3JSnQ==}
+
+ '@types/sax@1.2.7':
+ resolution: {integrity: sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A==}
+
+ '@types/trusted-types@2.0.7':
+ resolution: {integrity: sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==}
+
+ '@types/unist@2.0.11':
+ resolution: {integrity: sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==}
+
+ '@types/unist@3.0.3':
+ resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==}
+
+ '@ungap/structured-clone@1.3.0':
+ resolution: {integrity: sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==}
+
+ '@ungap/structured-clone@1.3.1':
+ resolution: {integrity: sha512-mUFwbeTqrVgDQxFveS+df2yfap6iuP20NAKAsBt5jDEoOTDew+zwLAOilHCeQJOVSvmgCX4ogqIrA0mnyr08yQ==}
+
+ '@upsetjs/venn.js@2.0.0':
+ resolution: {integrity: sha512-WbBhLrooyePuQ1VZxrJjtLvTc4NVfpOyKx0sKqioq9bX1C1m7Jgykkn8gLrtwumBioXIqam8DLxp88Adbue6Hw==}
+
+ abbrev@4.0.0:
+ resolution: {integrity: sha512-a1wflyaL0tHtJSmLSOVybYhy22vRih4eduhhrkcjgrWGnRfrZtovJ2FRjxuTtkkj47O/baf0R86QU5OuYpz8fA==}
+ engines: {node: ^20.17.0 || >=22.9.0}
+
+ acorn-jsx@5.3.2:
+ resolution: {integrity: sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==}
+ peerDependencies:
+ acorn: ^6.0.0 || ^7.0.0 || ^8.0.0
+
+ acorn@8.16.0:
+ resolution: {integrity: sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==}
+ engines: {node: '>=0.4.0'}
+ hasBin: true
+
+ ansi-escapes@7.3.0:
+ resolution: {integrity: sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==}
+ engines: {node: '>=18'}
+
+ anymatch@3.1.3:
+ resolution: {integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==}
+ engines: {node: '>= 8'}
+
+ arg@5.0.2:
+ resolution: {integrity: sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==}
+
+ argparse@2.0.1:
+ resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
+
+ aria-query@5.3.2:
+ resolution: {integrity: sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==}
+ engines: {node: '>= 0.4'}
+
+ array-iterate@2.0.1:
+ resolution: {integrity: sha512-I1jXZMjAgCMmxT4qxXfPXa6SthSoE8h6gkSI9BGGNv8mP8G/v0blc+qFnZu6K42vTOiuME596QaLO0TP3Lk0xg==}
+
+ astring@1.9.0:
+ resolution: {integrity: sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg==}
+ hasBin: true
+
+ astro-expressive-code@0.42.0:
+ resolution: {integrity: sha512-aiTePi2Cn0mJPYWZSzP1GcxCinX9mNtJyCCshVVPSg1yRwM7ADvFJOx0FnS440M9t65hp8JH//dc2qr22Bm4ag==}
+ peerDependencies:
+ astro: ^4.0.0-beta || ^5.0.0-beta || ^3.3.0 || ^6.0.0-beta
+
+ astro@6.3.7:
+ resolution: {integrity: sha512-zIeDRrI0qNgN1lcCjNqt6/IVCVej7VwSa326cO8uP9BOk1cg4QuffhLnOn2gCgWQr32/wxpSRFfXiLKHglu1Tw==}
+ engines: {node: '>=22.12.0', npm: '>=9.6.5', pnpm: '>=7.1.0'}
+ hasBin: true
+
+ axobject-query@4.1.0:
+ resolution: {integrity: sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==}
+ engines: {node: '>= 0.4'}
+
+ bail@2.0.2:
+ resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==}
+
+ bcp-47-match@2.0.3:
+ resolution: {integrity: sha512-JtTezzbAibu8G0R9op9zb3vcWZd9JF6M0xOYGPn0fNCd7wOpRB1mU2mH9T8gaBGbAAyIIVgB2G7xG0GP98zMAQ==}
+
+ bcp-47@2.1.0:
+ resolution: {integrity: sha512-9IIS3UPrvIa1Ej+lVDdDwO7zLehjqsaByECw0bu2RRGP73jALm6FYbzI5gWbgHLvNdkvfXB5YrSbocZdOS0c0w==}
+
+ boolbase@1.0.0:
+ resolution: {integrity: sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==}
+
+ braces@3.0.3:
+ resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==}
+ engines: {node: '>=8'}
+
+ ccount@2.0.1:
+ resolution: {integrity: sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==}
+
+ character-entities-html4@2.1.0:
+ resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==}
+
+ character-entities-legacy@3.0.0:
+ resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==}
+
+ character-entities@2.0.2:
+ resolution: {integrity: sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==}
+
+ character-reference-invalid@2.0.1:
+ resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==}
+
+ chokidar@5.0.0:
+ resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==}
+ engines: {node: '>= 20.19.0'}
+
+ chownr@3.0.0:
+ resolution: {integrity: sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==}
+ engines: {node: '>=18'}
+
+ ci-info@4.4.0:
+ resolution: {integrity: sha512-77PSwercCZU2Fc4sX94eF8k8Pxte6JAwL4/ICZLFjJLqegs7kCuAsqqj/70NQF6TvDpgFjkubQB2FW2ZZddvQg==}
+ engines: {node: '>=8'}
+
+ clsx@2.1.1:
+ resolution: {integrity: sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==}
+ engines: {node: '>=6'}
+
+ collapse-white-space@2.1.0:
+ resolution: {integrity: sha512-loKTxY1zCOuG4j9f6EPnuyyYkf58RnhhWTvRoZEokgB+WbdXehfjFviyOVYkqzEWz1Q5kRiZdBYS5SwxbQYwzw==}
+
+ comma-separated-tokens@2.0.3:
+ resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==}
+
+ commander@11.1.0:
+ resolution: {integrity: sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==}
+ engines: {node: '>=16'}
+
+ commander@7.2.0:
+ resolution: {integrity: sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw==}
+ engines: {node: '>= 10'}
+
+ commander@8.3.0:
+ resolution: {integrity: sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==}
+ engines: {node: '>= 12'}
+
+ common-ancestor-path@2.0.0:
+ resolution: {integrity: sha512-dnN3ibLeoRf2HNC+OlCiNc5d2zxbLJXOtiZUudNFSXZrNSydxcCsSpRzXwfu7BBWCIfHPw+xTayeBvJCP/D8Ng==}
+ engines: {node: '>= 18'}
+
+ confbox@0.1.8:
+ resolution: {integrity: sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==}
+
+ cookie-es@1.2.3:
+ resolution: {integrity: sha512-lXVyvUvrNXblMqzIRrxHb57UUVmqsSWlxqt3XIjCkUP0wDAf6uicO6KMbEgYrMNtEvWgWHwe42CKxPu9MYAnWw==}
+
+ cookie@1.1.1:
+ resolution: {integrity: sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==}
+ engines: {node: '>=18'}
+
+ cose-base@1.0.3:
+ resolution: {integrity: sha512-s9whTXInMSgAp/NVXVNuVxVKzGH2qck3aQlVHxDCdAEPgtMKwc4Wq6/QKhgdEdgbLSi9rBTAcPoRa6JpiG4ksg==}
+
+ cose-base@2.2.0:
+ resolution: {integrity: sha512-AzlgcsCbUMymkADOJtQm3wO9S3ltPfYOFD5033keQn9NJzIbtnZj+UdBJe7DYml/8TdbtHJW3j58SOnKhWY/5g==}
+
+ crossws@0.3.5:
+ resolution: {integrity: sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA==}
+
+ css-select@5.2.2:
+ resolution: {integrity: sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==}
+
+ css-selector-parser@3.3.0:
+ resolution: {integrity: sha512-Y2asgMGFqJKF4fq4xHDSlFYIkeVfRsm69lQC1q9kbEsH5XtnINTMrweLkjYMeaUgiXBy/uvKeO/a1JHTNnmB2g==}
+
+ css-tree@2.2.1:
+ resolution: {integrity: sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA==}
+ engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0, npm: '>=7.0.0'}
+
+ css-tree@3.2.1:
+ resolution: {integrity: sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==}
+ engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0}
+
+ css-what@6.2.2:
+ resolution: {integrity: sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==}
+ engines: {node: '>= 6'}
+
+ cssesc@3.0.0:
+ resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==}
+ engines: {node: '>=4'}
+ hasBin: true
+
+ csso@5.0.5:
+ resolution: {integrity: sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ==}
+ engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0, npm: '>=7.0.0'}
+
+ cytoscape-cose-bilkent@4.1.0:
+ resolution: {integrity: sha512-wgQlVIUJF13Quxiv5e1gstZ08rnZj2XaLHGoFMYXz7SkNfCDOOteKBE6SYRfA9WxxI/iBc3ajfDoc6hb/MRAHQ==}
+ peerDependencies:
+ cytoscape: ^3.2.0
+
+ cytoscape-fcose@2.2.0:
+ resolution: {integrity: sha512-ki1/VuRIHFCzxWNrsshHYPs6L7TvLu3DL+TyIGEsRcvVERmxokbf5Gdk7mFxZnTdiGtnA4cfSmjZJMviqSuZrQ==}
+ peerDependencies:
+ cytoscape: ^3.2.0
+
+ cytoscape@3.33.2:
+ resolution: {integrity: sha512-sj4HXd3DokGhzZAdjDejGvTPLqlt84vNFN8m7bGsOzDY5DyVcxIb2ejIXat2Iy7HxWhdT/N1oKyheJ5YdpsGuw==}
+ engines: {node: '>=0.10'}
+
+ d3-array@2.12.1:
+ resolution: {integrity: sha512-B0ErZK/66mHtEsR1TkPEEkwdy+WDesimkM5gpZr5Dsg54BiTA5RXtYW5qTLIAcekaS9xfZrzBLF/OAkB3Qn1YQ==}
+
+ d3-array@3.2.4:
+ resolution: {integrity: sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==}
+ engines: {node: '>=12'}
+
+ d3-axis@3.0.0:
+ resolution: {integrity: sha512-IH5tgjV4jE/GhHkRV0HiVYPDtvfjHQlQfJHs0usq7M30XcSBvOotpmH1IgkcXsO/5gEQZD43B//fc7SRT5S+xw==}
+ engines: {node: '>=12'}
+
+ d3-brush@3.0.0:
+ resolution: {integrity: sha512-ALnjWlVYkXsVIGlOsuWH1+3udkYFI48Ljihfnh8FZPF2QS9o+PzGLBslO0PjzVoHLZ2KCVgAM8NVkXPJB2aNnQ==}
+ engines: {node: '>=12'}
+
+ d3-chord@3.0.1:
+ resolution: {integrity: sha512-VE5S6TNa+j8msksl7HwjxMHDM2yNK3XCkusIlpX5kwauBfXuyLAtNg9jCp/iHH61tgI4sb6R/EIMWCqEIdjT/g==}
+ engines: {node: '>=12'}
+
+ d3-color@3.1.0:
+ resolution: {integrity: sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA==}
+ engines: {node: '>=12'}
+
+ d3-contour@4.0.2:
+ resolution: {integrity: sha512-4EzFTRIikzs47RGmdxbeUvLWtGedDUNkTcmzoeyg4sP/dvCexO47AaQL7VKy/gul85TOxw+IBgA8US2xwbToNA==}
+ engines: {node: '>=12'}
+
+ d3-delaunay@6.0.4:
+ resolution: {integrity: sha512-mdjtIZ1XLAM8bm/hx3WwjfHt6Sggek7qH043O8KEjDXN40xi3vx/6pYSVTwLjEgiXQTbvaouWKynLBiUZ6SK6A==}
+ engines: {node: '>=12'}
+
+ d3-dispatch@3.0.1:
+ resolution: {integrity: sha512-rzUyPU/S7rwUflMyLc1ETDeBj0NRuHKKAcvukozwhshr6g6c5d8zh4c2gQjY2bZ0dXeGLWc1PF174P2tVvKhfg==}
+ engines: {node: '>=12'}
+
+ d3-drag@3.0.0:
+ resolution: {integrity: sha512-pWbUJLdETVA8lQNJecMxoXfH6x+mO2UQo8rSmZ+QqxcbyA3hfeprFgIT//HW2nlHChWeIIMwS2Fq+gEARkhTkg==}
+ engines: {node: '>=12'}
+
+ d3-dsv@3.0.1:
+ resolution: {integrity: sha512-UG6OvdI5afDIFP9w4G0mNq50dSOsXHJaRE8arAS5o9ApWnIElp8GZw1Dun8vP8OyHOZ/QJUKUJwxiiCCnUwm+Q==}
+ engines: {node: '>=12'}
+ hasBin: true
+
+ d3-ease@3.0.1:
+ resolution: {integrity: sha512-wR/XK3D3XcLIZwpbvQwQ5fK+8Ykds1ip7A2Txe0yxncXSdq1L9skcG7blcedkOX+ZcgxGAmLX1FrRGbADwzi0w==}
+ engines: {node: '>=12'}
+
+ d3-fetch@3.0.1:
+ resolution: {integrity: sha512-kpkQIM20n3oLVBKGg6oHrUchHM3xODkTzjMoj7aWQFq5QEM+R6E4WkzT5+tojDY7yjez8KgCBRoj4aEr99Fdqw==}
+ engines: {node: '>=12'}
+
+ d3-force@3.0.0:
+ resolution: {integrity: sha512-zxV/SsA+U4yte8051P4ECydjD/S+qeYtnaIyAs9tgHCqfguma/aAQDjo85A9Z6EKhBirHRJHXIgJUlffT4wdLg==}
+ engines: {node: '>=12'}
+
+ d3-format@3.1.2:
+ resolution: {integrity: sha512-AJDdYOdnyRDV5b6ArilzCPPwc1ejkHcoyFarqlPqT7zRYjhavcT3uSrqcMvsgh2CgoPbK3RCwyHaVyxYcP2Arg==}
+ engines: {node: '>=12'}
+
+ d3-geo@3.1.1:
+ resolution: {integrity: sha512-637ln3gXKXOwhalDzinUgY83KzNWZRKbYubaG+fGVuc/dxO64RRljtCTnf5ecMyE1RIdtqpkVcq0IbtU2S8j2Q==}
+ engines: {node: '>=12'}
+
+ d3-hierarchy@3.1.2:
+ resolution: {integrity: sha512-FX/9frcub54beBdugHjDCdikxThEqjnR93Qt7PvQTOHxyiNCAlvMrHhclk3cD5VeAaq9fxmfRp+CnWw9rEMBuA==}
+ engines: {node: '>=12'}
+
+ d3-interpolate@3.0.1:
+ resolution: {integrity: sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g==}
+ engines: {node: '>=12'}
+
+ d3-path@1.0.9:
+ resolution: {integrity: sha512-VLaYcn81dtHVTjEHd8B+pbe9yHWpXKZUC87PzoFmsFrJqgFwDe/qxfp5MlfsfM1V5E/iVt0MmEbWQ7FVIXh/bg==}
+
+ d3-path@3.1.0:
+ resolution: {integrity: sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==}
+ engines: {node: '>=12'}
+
+ d3-polygon@3.0.1:
+ resolution: {integrity: sha512-3vbA7vXYwfe1SYhED++fPUQlWSYTTGmFmQiany/gdbiWgU/iEyQzyymwL9SkJjFFuCS4902BSzewVGsHHmHtXg==}
+ engines: {node: '>=12'}
+
+ d3-quadtree@3.0.1:
+ resolution: {integrity: sha512-04xDrxQTDTCFwP5H6hRhsRcb9xxv2RzkcsygFzmkSIOJy3PeRJP7sNk3VRIbKXcog561P9oU0/rVH6vDROAgUw==}
+ engines: {node: '>=12'}
+
+ d3-random@3.0.1:
+ resolution: {integrity: sha512-FXMe9GfxTxqd5D6jFsQ+DJ8BJS4E/fT5mqqdjovykEB2oFbTMDVdg1MGFxfQW+FBOGoB++k8swBrgwSHT1cUXQ==}
+ engines: {node: '>=12'}
+
+ d3-sankey@0.12.3:
+ resolution: {integrity: sha512-nQhsBRmM19Ax5xEIPLMY9ZmJ/cDvd1BG3UVvt5h3WRxKg5zGRbvnteTyWAbzeSvlh3tW7ZEmq4VwR5mB3tutmQ==}
+
+ d3-scale-chromatic@3.1.0:
+ resolution: {integrity: sha512-A3s5PWiZ9YCXFye1o246KoscMWqf8BsD9eRiJ3He7C9OBaxKhAd5TFCdEx/7VbKtxxTsu//1mMJFrEt572cEyQ==}
+ engines: {node: '>=12'}
+
+ d3-scale@4.0.2:
+ resolution: {integrity: sha512-GZW464g1SH7ag3Y7hXjf8RoUuAFIqklOAq3MRl4OaWabTFJY9PN/E1YklhXLh+OQ3fM9yS2nOkCoS+WLZ6kvxQ==}
+ engines: {node: '>=12'}
+
+ d3-selection@3.0.0:
+ resolution: {integrity: sha512-fmTRWbNMmsmWq6xJV8D19U/gw/bwrHfNXxrIN+HfZgnzqTHp9jOmKMhsTUjXOJnZOdZY9Q28y4yebKzqDKlxlQ==}
+ engines: {node: '>=12'}
+
+ d3-shape@1.3.7:
+ resolution: {integrity: sha512-EUkvKjqPFUAZyOlhY5gzCxCeI0Aep04LwIRpsZ/mLFelJiUfnK56jo5JMDSE7yyP2kLSb6LtF+S5chMk7uqPqw==}
+
+ d3-shape@3.2.0:
+ resolution: {integrity: sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==}
+ engines: {node: '>=12'}
+
+ d3-time-format@4.1.0:
+ resolution: {integrity: sha512-dJxPBlzC7NugB2PDLwo9Q8JiTR3M3e4/XANkreKSUxF8vvXKqm1Yfq4Q5dl8budlunRVlUUaDUgFt7eA8D6NLg==}
+ engines: {node: '>=12'}
+
+ d3-time@3.1.0:
+ resolution: {integrity: sha512-VqKjzBLejbSMT4IgbmVgDjpkYrNWUYJnbCGo874u7MMKIWsILRX+OpX/gTk8MqjpT1A/c6HY2dCA77ZN0lkQ2Q==}
+ engines: {node: '>=12'}
+
+ d3-timer@3.0.1:
+ resolution: {integrity: sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==}
+ engines: {node: '>=12'}
+
+ d3-transition@3.0.1:
+ resolution: {integrity: sha512-ApKvfjsSR6tg06xrL434C0WydLr7JewBB3V+/39RMHsaXTOG0zmt/OAXeng5M5LBm0ojmxJrpomQVZ1aPvBL4w==}
+ engines: {node: '>=12'}
+ peerDependencies:
+ d3-selection: 2 - 3
+
+ d3-zoom@3.0.0:
+ resolution: {integrity: sha512-b8AmV3kfQaqWAuacbPuNbL6vahnOJflOhexLzMMNLga62+/nh0JzvJ0aO/5a5MVgUFGS7Hu1P9P03o3fJkDCyw==}
+ engines: {node: '>=12'}
+
+ d3@7.9.0:
+ resolution: {integrity: sha512-e1U46jVP+w7Iut8Jt8ri1YsPOvFpg46k+K8TpCb0P+zjCkjkPnV7WzfDJzMHy1LnA+wj5pLT1wjO901gLXeEhA==}
+ engines: {node: '>=12'}
+
+ dagre-d3-es@7.0.14:
+ resolution: {integrity: sha512-P4rFMVq9ESWqmOgK+dlXvOtLwYg0i7u0HBGJER0LZDJT2VHIPAMZ/riPxqJceWMStH5+E61QxFra9kIS3AqdMg==}
+
+ dayjs@1.11.20:
+ resolution: {integrity: sha512-YbwwqR/uYpeoP4pu043q+LTDLFBLApUP6VxRihdfNTqu4ubqMlGDLd6ErXhEgsyvY0K6nCs7nggYumAN+9uEuQ==}
+
+ debug@4.4.3:
+ resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==}
+ engines: {node: '>=6.0'}
+ peerDependencies:
+ supports-color: '*'
+ peerDependenciesMeta:
+ supports-color:
+ optional: true
+
+ decode-named-character-reference@1.3.0:
+ resolution: {integrity: sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==}
+
+ defu@6.1.7:
+ resolution: {integrity: sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==}
+
+ delaunator@5.1.0:
+ resolution: {integrity: sha512-AGrQ4QSgssa1NGmWmLPqN5NY2KajF5MqxetNEO+o0n3ZwZZeTmt7bBnvzHWrmkZFxGgr4HdyFgelzgi06otLuQ==}
+
+ dequal@2.0.3:
+ resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==}
+ engines: {node: '>=6'}
+
+ destr@2.0.5:
+ resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==}
+
+ detect-libc@2.1.2:
+ resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
+ engines: {node: '>=8'}
+
+ devalue@5.8.1:
+ resolution: {integrity: sha512-4CXDYRBGqN+57wVJkuXBYmpAVUSg3L6JAQa/DFqm238G73E1wuyc/JhGQJzN7vUf/CMphYau2zXbfWzDR5aTEw==}
+
+ devlop@1.1.0:
+ resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==}
+
+ diff@8.0.4:
+ resolution: {integrity: sha512-DPi0FmjiSU5EvQV0++GFDOJ9ASQUVFh5kD+OzOnYdi7n3Wpm9hWWGfB/O2blfHcMVTL5WkQXSnRiK9makhrcnw==}
+ engines: {node: '>=0.3.1'}
+
+ direction@2.0.1:
+ resolution: {integrity: sha512-9S6m9Sukh1cZNknO1CWAr2QAWsbKLafQiyM5gZ7VgXHeuaoUwffKN4q6NC4A/Mf9iiPlOXQEKW/Mv/mh9/3YFA==}
+ hasBin: true
+
+ dom-serializer@2.0.0:
+ resolution: {integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==}
+
+ domelementtype@2.3.0:
+ resolution: {integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==}
+
+ domhandler@5.0.3:
+ resolution: {integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==}
+ engines: {node: '>= 4'}
+
+ dompurify@3.3.3:
+ resolution: {integrity: sha512-Oj6pzI2+RqBfFG+qOaOLbFXLQ90ARpcGG6UePL82bJLtdsa6CYJD7nmiU8MW9nQNOtCHV3lZ/Bzq1X0QYbBZCA==}
+
+ domutils@3.2.2:
+ resolution: {integrity: sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==}
+
+ dset@3.1.4:
+ resolution: {integrity: sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA==}
+ engines: {node: '>=4'}
+
+ entities@4.5.0:
+ resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==}
+ engines: {node: '>=0.12'}
+
+ entities@6.0.1:
+ resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
+ engines: {node: '>=0.12'}
+
+ env-paths@2.2.1:
+ resolution: {integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==}
+ engines: {node: '>=6'}
+
+ environment@1.1.0:
+ resolution: {integrity: sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==}
+ engines: {node: '>=18'}
+
+ es-module-lexer@2.1.0:
+ resolution: {integrity: sha512-n27zTYMjYu1aj4MjCWzSP7G9r75utsaoc8m61weK+W8JMBGGQybd43GstCXZ3WNmSFtGT9wi59qQTW6mhTR5LQ==}
+
+ es-toolkit@1.46.1:
+ resolution: {integrity: sha512-5eNtXOs3tbfxXOj04tjjseeWkRWaoCjdEI+96DgwzZoe6c9juL49pXlzAFTI72aWC9Y8p7168g6XIKjh7k6pyQ==}
+
+ esast-util-from-estree@2.0.0:
+ resolution: {integrity: sha512-4CyanoAudUSBAn5K13H4JhsMH6L9ZP7XbLVe/dKybkxMO7eDyLsT8UHl9TRNrU2Gr9nz+FovfSIjuXWJ81uVwQ==}
+
+ esast-util-from-js@2.0.1:
+ resolution: {integrity: sha512-8Ja+rNJ0Lt56Pcf3TAmpBZjmx8ZcK5Ts4cAzIOjsjevg9oSXJnl6SUQ2EevU8tv3h6ZLWmoKL5H4fgWvdvfETw==}
+
+ esbuild@0.27.7:
+ resolution: {integrity: sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ escape-string-regexp@5.0.0:
+ resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==}
+ engines: {node: '>=12'}
+
+ estree-util-attach-comments@3.0.0:
+ resolution: {integrity: sha512-cKUwm/HUcTDsYh/9FgnuFqpfquUbwIqwKM26BVCGDPVgvaCl/nDCCjUfiLlx6lsEZ3Z4RFxNbOQ60pkaEwFxGw==}
+
+ estree-util-build-jsx@3.0.1:
+ resolution: {integrity: sha512-8U5eiL6BTrPxp/CHbs2yMgP8ftMhR5ww1eIKoWRMlqvltHF8fZn5LRDvTKuxD3DUn+shRbLGqXemcP51oFCsGQ==}
+
+ estree-util-is-identifier-name@3.0.0:
+ resolution: {integrity: sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==}
+
+ estree-util-scope@1.0.0:
+ resolution: {integrity: sha512-2CAASclonf+JFWBNJPndcOpA8EMJwa0Q8LUFJEKqXLW6+qBvbFZuF5gItbQOs/umBUkjviCSDCbBwU2cXbmrhQ==}
+
+ estree-util-to-js@2.0.0:
+ resolution: {integrity: sha512-WDF+xj5rRWmD5tj6bIqRi6CkLIXbbNQUcxQHzGysQzvHmdYG2G7p/Tf0J0gpxGgkeMZNTIjT/AoSvC9Xehcgdg==}
+
+ estree-util-visit@2.0.0:
+ resolution: {integrity: sha512-m5KgiH85xAhhW8Wta0vShLcUvOsh3LLPI2YVwcbio1l7E09NTLL1EyMZFM1OyWowoH0skScNbhOPl4kcBgzTww==}
+
+ estree-walker@2.0.2:
+ resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==}
+
+ estree-walker@3.0.3:
+ resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}
+
+ eventemitter3@5.0.4:
+ resolution: {integrity: sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==}
+
+ exponential-backoff@3.1.3:
+ resolution: {integrity: sha512-ZgEeZXj30q+I0EN+CbSSpIyPaJ5HVQD18Z1m+u1FXbAeT94mr1zw50q4q6jiiC447Nl/YTcIYSAftiGqetwXCA==}
+
+ expressive-code@0.42.0:
+ resolution: {integrity: sha512-V5DtJLEKuj4wf9O6IRtPtRObkMVy2ggR+S0MdjrTw6m58krZnDioyhW1si3Y04c5YPeooP4nd85Yq9NwEVHS4g==}
+
+ extend@3.0.2:
+ resolution: {integrity: sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==}
+
+ fast-string-truncated-width@3.0.3:
+ resolution: {integrity: sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g==}
+
+ fast-string-width@3.0.2:
+ resolution: {integrity: sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg==}
+
+ fast-wrap-ansi@0.2.2:
+ resolution: {integrity: sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q==}
+
+ fdir@6.5.0:
+ resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
+ engines: {node: '>=12.0.0'}
+ peerDependencies:
+ picomatch: ^3 || ^4
+ peerDependenciesMeta:
+ picomatch:
+ optional: true
+
+ fill-range@7.1.1:
+ resolution: {integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==}
+ engines: {node: '>=8'}
+
+ flattie@1.1.1:
+ resolution: {integrity: sha512-9UbaD6XdAL97+k/n+N7JwX46K/M6Zc6KcFYskrYL8wbBV/Uyk0CTAMY0VT+qiK5PM7AIc9aTWYtq65U7T+aCNQ==}
+ engines: {node: '>=8'}
+
+ fontace@0.4.1:
+ resolution: {integrity: sha512-lDMvbAzSnHmbYMTEld5qdtvNH2/pWpICOqpean9IgC7vUbUJc3k+k5Dokp85CegamqQpFbXf0rAVkbzpyTA8aw==}
+
+ fontkitten@1.0.3:
+ resolution: {integrity: sha512-Wp1zXWPVUPBmfoa3Cqc9ctaKuzKAV6uLstRqlR56kSjplf5uAce+qeyYym7F+PHbGTk+tCEdkCW6RD7DX/gBZw==}
+ engines: {node: '>=20'}
+
+ fsevents@2.3.3:
+ resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+ engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+ os: [darwin]
+
+ get-tsconfig@5.0.0-beta.4:
+ resolution: {integrity: sha512-7nF7C9fIPFEMHgEMEfgIlO9wDdZ8CyHw27rWciFZfHvHDReIiPhsYuzPRXsfvBCqFy1l8RRyyWV7QLM+ZhUJsQ==}
+ engines: {node: '>=20.20.0'}
+
+ github-slugger@2.0.0:
+ resolution: {integrity: sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==}
+
+ graceful-fs@4.2.11:
+ resolution: {integrity: sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==}
+
+ h3@1.15.11:
+ resolution: {integrity: sha512-L3THSe2MPeBwgIZVSH5zLdBBU90TOxarvhK9d04IDY2AmVS8j2Jz2LIWtwsGOU3lu2I5jCN7FNvVfY2+XyF+mg==}
+
+ hachure-fill@0.5.2:
+ resolution: {integrity: sha512-3GKBOn+m2LX9iq+JC1064cSFprJY4jL1jCXTcpnfER5HYE2l/4EfWSGzkPa/ZDBmYI0ZOEj5VHV/eKnPGkHuOg==}
+
+ has-flag@5.0.1:
+ resolution: {integrity: sha512-CsNUt5x9LUdx6hnk/E2SZLsDyvfqANZSUq4+D3D8RzDJ2M+HDTIkF60ibS1vHaK55vzgiZw1bEPFG9yH7l33wA==}
+ engines: {node: '>=12'}
+
+ hast-util-embedded@3.0.0:
+ resolution: {integrity: sha512-naH8sld4Pe2ep03qqULEtvYr7EjrLK2QHY8KJR6RJkTUjPGObe1vnx585uzem2hGra+s1q08DZZpfgDVYRbaXA==}
+
+ hast-util-format@1.1.0:
+ resolution: {integrity: sha512-yY1UDz6bC9rDvCWHpx12aIBGRG7krurX0p0Fm6pT547LwDIZZiNr8a+IHDogorAdreULSEzP82Nlv5SZkHZcjA==}
+
+ hast-util-from-html@2.0.3:
+ resolution: {integrity: sha512-CUSRHXyKjzHov8yKsQjGOElXy/3EKpyX56ELnkHH34vDVw1N1XSQ1ZcAvTyAPtGqLTuKP/uxM+aLkSPqF/EtMw==}
+
+ hast-util-from-parse5@8.0.3:
+ resolution: {integrity: sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==}
+
+ hast-util-has-property@3.0.0:
+ resolution: {integrity: sha512-MNilsvEKLFpV604hwfhVStK0usFY/QmM5zX16bo7EjnAEGofr5YyI37kzopBlZJkHD4t887i+q/C8/tr5Q94cA==}
+
+ hast-util-is-body-ok-link@3.0.1:
+ resolution: {integrity: sha512-0qpnzOBLztXHbHQenVB8uNuxTnm/QBFUOmdOSsEn7GnBtyY07+ENTWVFBAnXd/zEgd9/SUG3lRY7hSIBWRgGpQ==}
+
+ hast-util-is-element@3.0.0:
+ resolution: {integrity: sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g==}
+
+ hast-util-minify-whitespace@1.0.1:
+ resolution: {integrity: sha512-L96fPOVpnclQE0xzdWb/D12VT5FabA7SnZOUMtL1DbXmYiHJMXZvFkIZfiMmTCNJHUeO2K9UYNXoVyfz+QHuOw==}
+
+ hast-util-parse-selector@4.0.0:
+ resolution: {integrity: sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==}
+
+ hast-util-phrasing@3.0.1:
+ resolution: {integrity: sha512-6h60VfI3uBQUxHqTyMymMZnEbNl1XmEGtOxxKYL7stY2o601COo62AWAYBQR9lZbYXYSBoxag8UpPRXK+9fqSQ==}
+
+ hast-util-raw@9.1.0:
+ resolution: {integrity: sha512-Y8/SBAHkZGoNkpzqqfCldijcuUKh7/su31kEBp67cFY09Wy0mTRgtsLYsiIxMJxlu0f6AA5SUTbDR8K0rxnbUw==}
+
+ hast-util-select@6.0.4:
+ resolution: {integrity: sha512-RqGS1ZgI0MwxLaKLDxjprynNzINEkRHY2i8ln4DDjgv9ZhcYVIHN9rlpiYsqtFwrgpYU361SyWDQcGNIBVu3lw==}
+
+ hast-util-to-estree@3.1.3:
+ resolution: {integrity: sha512-48+B/rJWAp0jamNbAAf9M7Uf//UVqAoMmgXhBdxTDJLGKY+LRnZ99qcG+Qjl5HfMpYNzS5v4EAwVEF34LeAj7w==}
+
+ hast-util-to-html@9.0.5:
+ resolution: {integrity: sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==}
+
+ hast-util-to-jsx-runtime@2.3.6:
+ resolution: {integrity: sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==}
+
+ hast-util-to-mdast@10.1.2:
+ resolution: {integrity: sha512-FiCRI7NmOvM4y+f5w32jPRzcxDIz+PUqDwEqn1A+1q2cdp3B8Gx7aVrXORdOKjMNDQsD1ogOr896+0jJHW1EFQ==}
+
+ hast-util-to-parse5@8.0.1:
+ resolution: {integrity: sha512-MlWT6Pjt4CG9lFCjiz4BH7l9wmrMkfkJYCxFwKQic8+RTZgWPuWxwAfjJElsXkex7DJjfSJsQIt931ilUgmwdA==}
+
+ hast-util-to-string@3.0.1:
+ resolution: {integrity: sha512-XelQVTDWvqcl3axRfI0xSeoVKzyIFPwsAGSLIsKdJKQMXDYJS4WYrBNF/8J7RdhIcFI2BOHgAifggsvsxp/3+A==}
+
+ hast-util-to-text@4.0.2:
+ resolution: {integrity: sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A==}
+
+ hast-util-whitespace@3.0.0:
+ resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==}
+
+ hastscript@9.0.1:
+ resolution: {integrity: sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==}
+
+ html-escaper@3.0.3:
+ resolution: {integrity: sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==}
+
+ html-void-elements@3.0.0:
+ resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==}
+
+ html-whitespace-sensitive-tag-names@3.0.1:
+ resolution: {integrity: sha512-q+310vW8zmymYHALr1da4HyXUQ0zgiIwIicEfotYPWGN0OJVEN/58IJ3A4GBYcEq3LGAZqKb+ugvP0GNB9CEAA==}
+
+ http-cache-semantics@4.2.0:
+ resolution: {integrity: sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==}
+
+ i18next@26.1.0:
+ resolution: {integrity: sha512-dIU6td04DvQuIqVst5S9g0GviTmhZ0DYD4b9ociVGJmuCa5vZ2de/t+Enf4olvj87mF8Y2lwjNQBwC9QZsvzKQ==}
+ peerDependencies:
+ typescript: ^5 || ^6
+ peerDependenciesMeta:
+ typescript:
+ optional: true
+
+ iconv-lite@0.6.3:
+ resolution: {integrity: sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==}
+ engines: {node: '>=0.10.0'}
+
+ inline-style-parser@0.2.7:
+ resolution: {integrity: sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==}
+
+ internmap@1.0.1:
+ resolution: {integrity: sha512-lDB5YccMydFBtasVtxnZ3MRBHuaoE8GKsppq+EchKL2U4nK/DmEpPHNH8MZe5HkMtpSiTSOZwfN0tzYjO/lJEw==}
+
+ internmap@2.0.3:
+ resolution: {integrity: sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg==}
+ engines: {node: '>=12'}
+
+ iron-webcrypto@1.2.1:
+ resolution: {integrity: sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==}
+
+ is-absolute-url@4.0.1:
+ resolution: {integrity: sha512-/51/TKE88Lmm7Gc4/8btclNXWS+g50wXhYJq8HWIBAGUBnoAdRu1aXeh364t/O7wXDAcTJDP8PNuNKWUDWie+A==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ is-absolute-url@5.0.0:
+ resolution: {integrity: sha512-sdJyNpBnQHuVnBunfzjAecOhZr2+A30ywfFvu3EnxtKLUWfwGgyWUmqHbGZiU6vTfHpCPm5GvLe4BAvlU9n8VQ==}
+ engines: {node: '>=20'}
+
+ is-alphabetical@2.0.1:
+ resolution: {integrity: sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==}
+
+ is-alphanumerical@2.0.1:
+ resolution: {integrity: sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==}
+
+ is-decimal@2.0.1:
+ resolution: {integrity: sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==}
+
+ is-docker@3.0.0:
+ resolution: {integrity: sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+ hasBin: true
+
+ is-docker@4.0.0:
+ resolution: {integrity: sha512-LHE+wROyG/Y/0ZnbktRCoTix2c1RhgWaZraMZ8o1Q7zCh0VSrICJQO5oqIIISrcSBtrXv0o233w1IYwsWCjTzA==}
+ engines: {node: '>=20'}
+ hasBin: true
+
+ is-hexadecimal@2.0.1:
+ resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==}
+
+ is-inside-container@1.0.0:
+ resolution: {integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==}
+ engines: {node: '>=14.16'}
+ hasBin: true
+
+ is-number@7.0.0:
+ resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
+ engines: {node: '>=0.12.0'}
+
+ is-plain-obj@4.1.0:
+ resolution: {integrity: sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==}
+ engines: {node: '>=12'}
+
+ is-wsl@3.1.1:
+ resolution: {integrity: sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==}
+ engines: {node: '>=16'}
+
+ isexe@4.0.0:
+ resolution: {integrity: sha512-FFUtZMpoZ8RqHS3XeXEmHWLA4thH+ZxCv2lOiPIn1Xc7CxrqhWzNSDzD+/chS/zbYezmiwWLdQC09JdQKmthOw==}
+ engines: {node: '>=20'}
+
+ jiti@2.6.1:
+ resolution: {integrity: sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==}
+ hasBin: true
+
+ js-yaml@4.1.1:
+ resolution: {integrity: sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==}
+ hasBin: true
+
+ jsonc-parser@3.3.1:
+ resolution: {integrity: sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==}
+
+ katex@0.16.45:
+ resolution: {integrity: sha512-pQpZbdBu7wCTmQUh7ufPmLr0pFoObnGUoL/yhtwJDgmmQpbkg/0HSVti25Fu4rmd1oCR6NGWe9vqTWuWv3GcNA==}
+ hasBin: true
+
+ khroma@2.1.0:
+ resolution: {integrity: sha512-Ls993zuzfayK269Svk9hzpeGUKob/sIgZzyHYdjQoAdQetRKpOLj+k/QQQ/6Qi0Yz65mlROrfd+Ev+1+7dz9Kw==}
+
+ klona@2.0.6:
+ resolution: {integrity: sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA==}
+ engines: {node: '>= 8'}
+
+ layout-base@1.0.2:
+ resolution: {integrity: sha512-8h2oVEZNktL4BH2JCOI90iD1yXwL6iNW7KcCKT2QZgQJR2vbqDsldCTPRU9NifTCqHZci57XvQQ15YTu+sTYPg==}
+
+ layout-base@2.0.1:
+ resolution: {integrity: sha512-dp3s92+uNI1hWIpPGH3jK2kxE2lMjdXdr+DH8ynZHpd6PUlH6x6cbuXnoMmiNumznqaNO31xu9e79F0uuZ0JFg==}
+
+ lodash-es@4.18.1:
+ resolution: {integrity: sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==}
+
+ longest-streak@3.1.0:
+ resolution: {integrity: sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==}
+
+ lru-cache@11.5.0:
+ resolution: {integrity: sha512-5YgH9UJd7wVb9hIouI2adWpgqrrICkt070Dnj8EUY1+B4B2P9eRLPAkAAo6NICA7CEhOIeBHl46u9zSNpNu7zA==}
+ engines: {node: 20 || >=22}
+
+ magic-string@0.30.21:
+ resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
+
+ magicast@0.5.3:
+ resolution: {integrity: sha512-pVKE4UdSQ7DvHzivsCIFx2BJn1mHG6KsyrFcaxFx6tONdneEuThrDx0Cj3AMg58KyN4pzYT+LHOotxDQDjNvkw==}
+
+ markdown-extensions@2.0.0:
+ resolution: {integrity: sha512-o5vL7aDWatOTX8LzaS1WMoaoxIiLRQJuIKKe2wAw6IeULDHaqbiqiggmx+pKvZDb1Sj+pE46Sn1T7lCqfFtg1Q==}
+ engines: {node: '>=16'}
+
+ markdown-table@3.0.4:
+ resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
+
+ marked@16.4.2:
+ resolution: {integrity: sha512-TI3V8YYWvkVf3KJe1dRkpnjs68JUPyEa5vjKrp1XEEJUAOaQc+Qj+L1qWbPd0SJuAdQkFU0h73sXXqwDYxsiDA==}
+ engines: {node: '>= 20'}
+ hasBin: true
+
+ mdast-util-definitions@6.0.0:
+ resolution: {integrity: sha512-scTllyX6pnYNZH/AIp/0ePz6s4cZtARxImwoPJ7kS42n+MnVsI4XbnG6d4ibehRIldYMWM2LD7ImQblVhUejVQ==}
+
+ mdast-util-directive@3.1.0:
+ resolution: {integrity: sha512-I3fNFt+DHmpWCYAT7quoM6lHf9wuqtI+oCOfvILnoicNIqjh5E3dEJWiXuYME2gNe8vl1iMQwyUHa7bgFmak6Q==}
+
+ mdast-util-find-and-replace@3.0.2:
+ resolution: {integrity: sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg==}
+
+ mdast-util-from-markdown@2.0.3:
+ resolution: {integrity: sha512-W4mAWTvSlKvf8L6J+VN9yLSqQ9AOAAvHuoDAmPkz4dHf553m5gVj2ejadHJhoJmcmxEnOv6Pa8XJhpxE93kb8Q==}
+
+ mdast-util-gfm-autolink-literal@2.0.1:
+ resolution: {integrity: sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==}
+
+ mdast-util-gfm-footnote@2.1.0:
+ resolution: {integrity: sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==}
+
+ mdast-util-gfm-strikethrough@2.0.0:
+ resolution: {integrity: sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==}
+
+ mdast-util-gfm-table@2.0.0:
+ resolution: {integrity: sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==}
+
+ mdast-util-gfm-task-list-item@2.0.0:
+ resolution: {integrity: sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==}
+
+ mdast-util-gfm@3.1.0:
+ resolution: {integrity: sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==}
+
+ mdast-util-mdx-expression@2.0.1:
+ resolution: {integrity: sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==}
+
+ mdast-util-mdx-jsx@3.2.0:
+ resolution: {integrity: sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==}
+
+ mdast-util-mdx@3.0.0:
+ resolution: {integrity: sha512-JfbYLAW7XnYTTbUsmpu0kdBUVe+yKVJZBItEjwyYJiDJuZ9w4eeaqks4HQO+R7objWgS2ymV60GYpI14Ug554w==}
+
+ mdast-util-mdxjs-esm@2.0.1:
+ resolution: {integrity: sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==}
+
+ mdast-util-phrasing@4.1.0:
+ resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==}
+
+ mdast-util-to-hast@13.2.1:
+ resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==}
+
+ mdast-util-to-markdown@2.1.2:
+ resolution: {integrity: sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==}
+
+ mdast-util-to-string@4.0.0:
+ resolution: {integrity: sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==}
+
+ mdn-data@2.0.28:
+ resolution: {integrity: sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g==}
+
+ mdn-data@2.27.1:
+ resolution: {integrity: sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==}
+
+ mermaid@11.15.0:
+ resolution: {integrity: sha512-pTMbcf3rWdtLiYGpmoTjHEpeY8seiy6sR+9nD7LOs8KfUbHE4lOUAprTRqRAcWSQ6MQpdX+YEsxShtGsINtPtw==}
+
+ micromark-core-commonmark@2.0.3:
+ resolution: {integrity: sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==}
+
+ micromark-extension-directive@4.0.0:
+ resolution: {integrity: sha512-/C2nqVmXXmiseSSuCdItCMho7ybwwop6RrrRPk0KbOHW21JKoCldC+8rFOaundDoRBUWBnJJcxeA/Kvi34WQXg==}
+
+ micromark-extension-gfm-autolink-literal@2.1.0:
+ resolution: {integrity: sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==}
+
+ micromark-extension-gfm-footnote@2.1.0:
+ resolution: {integrity: sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==}
+
+ micromark-extension-gfm-strikethrough@2.1.0:
+ resolution: {integrity: sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==}
+
+ micromark-extension-gfm-table@2.1.1:
+ resolution: {integrity: sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==}
+
+ micromark-extension-gfm-tagfilter@2.0.0:
+ resolution: {integrity: sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==}
+
+ micromark-extension-gfm-task-list-item@2.1.0:
+ resolution: {integrity: sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==}
+
+ micromark-extension-gfm@3.0.0:
+ resolution: {integrity: sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==}
+
+ micromark-extension-mdx-expression@3.0.1:
+ resolution: {integrity: sha512-dD/ADLJ1AeMvSAKBwO22zG22N4ybhe7kFIZ3LsDI0GlsNr2A3KYxb0LdC1u5rj4Nw+CHKY0RVdnHX8vj8ejm4Q==}
+
+ micromark-extension-mdx-jsx@3.0.2:
+ resolution: {integrity: sha512-e5+q1DjMh62LZAJOnDraSSbDMvGJ8x3cbjygy2qFEi7HCeUT4BDKCvMozPozcD6WmOt6sVvYDNBKhFSz3kjOVQ==}
+
+ micromark-extension-mdx-md@2.0.0:
+ resolution: {integrity: sha512-EpAiszsB3blw4Rpba7xTOUptcFeBFi+6PY8VnJ2hhimH+vCQDirWgsMpz7w1XcZE7LVrSAUGb9VJpG9ghlYvYQ==}
+
+ micromark-extension-mdxjs-esm@3.0.0:
+ resolution: {integrity: sha512-DJFl4ZqkErRpq/dAPyeWp15tGrcrrJho1hKK5uBS70BCtfrIFg81sqcTVu3Ta+KD1Tk5vAtBNElWxtAa+m8K9A==}
+
+ micromark-extension-mdxjs@3.0.0:
+ resolution: {integrity: sha512-A873fJfhnJ2siZyUrJ31l34Uqwy4xIFmvPY1oj+Ean5PHcPBYzEsvqvWGaWcfEIr11O5Dlw3p2y0tZWpKHDejQ==}
+
+ micromark-factory-destination@2.0.1:
+ resolution: {integrity: sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==}
+
+ micromark-factory-label@2.0.1:
+ resolution: {integrity: sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==}
+
+ micromark-factory-mdx-expression@2.0.3:
+ resolution: {integrity: sha512-kQnEtA3vzucU2BkrIa8/VaSAsP+EJ3CKOvhMuJgOEGg9KDC6OAY6nSnNDVRiVNRqj7Y4SlSzcStaH/5jge8JdQ==}
+
+ micromark-factory-space@2.0.1:
+ resolution: {integrity: sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==}
+
+ micromark-factory-title@2.0.1:
+ resolution: {integrity: sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==}
+
+ micromark-factory-whitespace@2.0.1:
+ resolution: {integrity: sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==}
+
+ micromark-util-character@2.1.1:
+ resolution: {integrity: sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==}
+
+ micromark-util-chunked@2.0.1:
+ resolution: {integrity: sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==}
+
+ micromark-util-classify-character@2.0.1:
+ resolution: {integrity: sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==}
+
+ micromark-util-combine-extensions@2.0.1:
+ resolution: {integrity: sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==}
+
+ micromark-util-decode-numeric-character-reference@2.0.2:
+ resolution: {integrity: sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==}
+
+ micromark-util-decode-string@2.0.1:
+ resolution: {integrity: sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==}
+
+ micromark-util-encode@2.0.1:
+ resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==}
+
+ micromark-util-events-to-acorn@2.0.3:
+ resolution: {integrity: sha512-jmsiEIiZ1n7X1Rr5k8wVExBQCg5jy4UXVADItHmNk1zkwEVhBuIUKRu3fqv+hs4nxLISi2DQGlqIOGiFxgbfHg==}
+
+ micromark-util-html-tag-name@2.0.1:
+ resolution: {integrity: sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==}
+
+ micromark-util-normalize-identifier@2.0.1:
+ resolution: {integrity: sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==}
+
+ micromark-util-resolve-all@2.0.1:
+ resolution: {integrity: sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==}
+
+ micromark-util-sanitize-uri@2.0.1:
+ resolution: {integrity: sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==}
+
+ micromark-util-subtokenize@2.1.0:
+ resolution: {integrity: sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==}
+
+ micromark-util-symbol@2.0.1:
+ resolution: {integrity: sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==}
+
+ micromark-util-types@2.0.2:
+ resolution: {integrity: sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==}
+
+ micromark@4.0.2:
+ resolution: {integrity: sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==}
+
+ micromatch@4.0.8:
+ resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}
+ engines: {node: '>=8.6'}
+
+ minipass@7.1.3:
+ resolution: {integrity: sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==}
+ engines: {node: '>=16 || 14 >=14.17'}
+
+ minizlib@3.1.0:
+ resolution: {integrity: sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==}
+ engines: {node: '>= 18'}
+
+ mlly@1.8.2:
+ resolution: {integrity: sha512-d+ObxMQFmbt10sretNDytwt85VrbkhhUA/JBGm1MPaWJ65Cl4wOgLaB1NYvJSZ0Ef03MMEU/0xpPMXUIQ29UfA==}
+
+ mrmime@2.0.1:
+ resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==}
+ engines: {node: '>=10'}
+
+ ms@2.1.3:
+ resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
+
+ nanoid@3.3.12:
+ resolution: {integrity: sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==}
+ engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
+ hasBin: true
+
+ neotraverse@0.6.18:
+ resolution: {integrity: sha512-Z4SmBUweYa09+o6pG+eASabEpP6QkQ70yHj351pQoEXIs8uHbaU2DWVmzBANKgflPa47A50PtB2+NgRpQvr7vA==}
+ engines: {node: '>= 10'}
+
+ nlcst-to-string@4.0.0:
+ resolution: {integrity: sha512-YKLBCcUYKAg0FNlOBT6aI91qFmSiFKiluk655WzPF+DDMA02qIyy8uiRqI8QXtcFpEvll12LpL5MXqEmAZ+dcA==}
+
+ node-addon-api@8.8.0:
+ resolution: {integrity: sha512-c5Ko1fZJIJmzhFIkhRN76WTq+fC6tWnGy9CXA0fA+XygsWZmEwG8vmbkNqxMyoaa0Tin4djul49NzdVcJJcjeA==}
+ engines: {node: ^18 || ^20 || >= 21}
+
+ node-fetch-native@1.6.7:
+ resolution: {integrity: sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==}
+
+ node-gyp@12.3.0:
+ resolution: {integrity: sha512-QNcUWM+HgJplcPzBvFBZ9VXacyGZ4+VTOb80PwWR+TlVzoHbRKULNEzpRsnaoxG3Wzr7Qh7BYxGDU3CbKib2Yg==}
+ engines: {node: ^20.17.0 || >=22.9.0}
+ hasBin: true
+
+ node-mock-http@1.0.4:
+ resolution: {integrity: sha512-8DY+kFsDkNXy1sJglUfuODx1/opAGJGyrTuFqEoN90oRc2Vk0ZbD4K2qmKXBBEhZQzdKHIVfEJpDU8Ak2NJEvQ==}
+
+ nopt@9.0.0:
+ resolution: {integrity: sha512-Zhq3a+yFKrYwSBluL4H9XP3m3y5uvQkB/09CwDruCiRmR/UJYnn9W4R48ry0uGC70aeTPKLynBtscP9efFFcPw==}
+ engines: {node: ^20.17.0 || >=22.9.0}
+ hasBin: true
+
+ normalize-path@3.0.0:
+ resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}
+ engines: {node: '>=0.10.0'}
+
+ nth-check@2.1.1:
+ resolution: {integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==}
+
+ obug@2.1.1:
+ resolution: {integrity: sha512-uTqF9MuPraAQ+IsnPf366RG4cP9RtUi7MLO1N3KEc+wb0a6yKpeL0lmk2IB1jY5KHPAlTc6T/JRdC/YqxHNwkQ==}
+
+ ofetch@1.5.1:
+ resolution: {integrity: sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==}
+
+ ohash@2.0.11:
+ resolution: {integrity: sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==}
+
+ oniguruma-parser@0.12.1:
+ resolution: {integrity: sha512-8Unqkvk1RYc6yq2WBYRj4hdnsAxVze8i7iPfQr8e4uSP3tRv0rpZcbGUDvxfQQcdwHt/e9PrMvGCsa8OqG9X3w==}
+
+ oniguruma-parser@0.12.2:
+ resolution: {integrity: sha512-6HVa5oIrgMC6aA6WF6XyyqbhRPJrKR02L20+2+zpDtO5QAzGHAUGw5TKQvwi5vctNnRHkJYmjAhRVQF2EKdTQw==}
+
+ oniguruma-to-es@4.3.5:
+ resolution: {integrity: sha512-Zjygswjpsewa0NLTsiizVuMQZbp0MDyM6lIt66OxsF21npUDlzpHi1Mgb/qhQdkb+dWFTzJmFbEWdvZgRho8eQ==}
+
+ oniguruma-to-es@4.3.6:
+ resolution: {integrity: sha512-csuQ9x3Yr0cEIs/Zgx/OEt9iBw9vqIunAPQkx19R/fiMq2oGVTgcMqO/V3Ybqefr1TBvosI6jU539ksaBULJyA==}
+
+ p-limit@7.3.0:
+ resolution: {integrity: sha512-7cIXg/Z0M5WZRblrsOla88S4wAK+zOQQWeBYfV3qJuJXMr+LnbYjaadrFaS0JILfEDPVqHyKnZ1Z/1d6J9VVUw==}
+ engines: {node: '>=20'}
+
+ p-queue@9.3.0:
+ resolution: {integrity: sha512-7NED7xhQ74Ngp4JP/2e0VZHp7vSWfJfqeiR92jPgxsz6m0Se4P03YoTKa9dDXyZ3r6P616gUXttrB6nnHYKang==}
+ engines: {node: '>=20'}
+
+ p-timeout@7.0.1:
+ resolution: {integrity: sha512-AxTM2wDGORHGEkPCt8yqxOTMgpfbEHqF51f/5fJCmwFC3C/zNcGT63SymH2ttOAaiIws2zVg4+izQCjrakcwHg==}
+ engines: {node: '>=20'}
+
+ package-manager-detector@1.6.0:
+ resolution: {integrity: sha512-61A5ThoTiDG/C8s8UMZwSorAGwMJ0ERVGj2OjoW5pAalsNOg15+iQiPzrLJ4jhZ1HJzmC2PIHT2oEiH3R5fzNA==}
+
+ pagefind@1.5.2:
+ resolution: {integrity: sha512-XTUaK0hXMCu2jszWE584JGQT7y284TmMV9l/HX3rnG5uo3rHI/uHU56XTyyyPFjeWEBxECbAi0CaFDJOONtG0Q==}
+ hasBin: true
+
+ parse-entities@4.0.2:
+ resolution: {integrity: sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==}
+
+ parse-latin@7.0.0:
+ resolution: {integrity: sha512-mhHgobPPua5kZ98EF4HWiH167JWBfl4pvAIXXdbaVohtK7a6YBOy56kvhCqduqyo/f3yrHFWmqmiMg/BkBkYYQ==}
+
+ parse5@7.3.0:
+ resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==}
+
+ path-data-parser@0.1.0:
+ resolution: {integrity: sha512-NOnmBpt5Y2RWbuv0LMzsayp3lVylAHLPUTut412ZA3l+C4uw4ZVkQbjShYCQ8TCpUMdPapr4YjUqLYD6v68j+w==}
+
+ pathe@2.0.3:
+ resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
+
+ piccolore@0.1.3:
+ resolution: {integrity: sha512-o8bTeDWjE086iwKrROaDf31K0qC/BENdm15/uH9usSC/uZjJOKb2YGiVHfLY4GhwsERiPI1jmwI2XrA7ACOxVw==}
+
+ picocolors@1.1.1:
+ resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}
+
+ picomatch@2.3.2:
+ resolution: {integrity: sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==}
+ engines: {node: '>=8.6'}
+
+ picomatch@4.0.4:
+ resolution: {integrity: sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==}
+ engines: {node: '>=12'}
+
+ pkg-types@1.3.1:
+ resolution: {integrity: sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==}
+
+ points-on-curve@0.2.0:
+ resolution: {integrity: sha512-0mYKnYYe9ZcqMCWhUjItv/oHjvgEsfKvnUTg8sAtnHr3GVy7rGkXCb6d5cSyqrWqL4k81b9CPg3urd+T7aop3A==}
+
+ points-on-path@0.2.1:
+ resolution: {integrity: sha512-25ClnWWuw7JbWZcgqY/gJ4FQWadKxGWk+3kR/7kD0tCaDtPPMj7oHu2ToLaVhfpnHrZzYby2w6tUA0eOIuUg8g==}
+
+ postcss-nested@6.2.0:
+ resolution: {integrity: sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ==}
+ engines: {node: '>=12.0'}
+ peerDependencies:
+ postcss: ^8.2.14
+
+ postcss-selector-parser@6.1.2:
+ resolution: {integrity: sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==}
+ engines: {node: '>=4'}
+
+ postcss@8.5.14:
+ resolution: {integrity: sha512-SoSL4+OSEtR99LHFZQiJLkT59C5B1amGO1NzTwj7TT1qCUgUO6hxOvzkOYxD+vMrXBM3XJIKzokoERdqQq/Zmg==}
+ engines: {node: ^10 || ^12 || >=14}
+
+ postcss@8.5.15:
+ resolution: {integrity: sha512-FfR8sjd4em2T6fb3I2MwAJU7HWVMr9zba+enmQeeWFfCbm+UOC/0X4DS8XtpUTMwWMGbjKYP7xjfNekzyGmB3A==}
+ engines: {node: ^10 || ^12 || >=14}
+
+ prismjs@1.30.0:
+ resolution: {integrity: sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==}
+ engines: {node: '>=6'}
+
+ proc-log@6.1.0:
+ resolution: {integrity: sha512-iG+GYldRf2BQ0UDUAd6JQ/RwzaQy6mXmsk/IzlYyal4A4SNFw54MeH4/tLkF4I5WoWG9SQwuqWzS99jaFQHBuQ==}
+ engines: {node: ^20.17.0 || >=22.9.0}
+
+ property-information@7.1.0:
+ resolution: {integrity: sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ==}
+
+ radix3@1.1.2:
+ resolution: {integrity: sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==}
+
+ readdirp@5.0.0:
+ resolution: {integrity: sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==}
+ engines: {node: '>= 20.19.0'}
+
+ recma-build-jsx@1.0.0:
+ resolution: {integrity: sha512-8GtdyqaBcDfva+GUKDr3nev3VpKAhup1+RvkMvUxURHpW7QyIvk9F5wz7Vzo06CEMSilw6uArgRqhpiUcWp8ew==}
+
+ recma-jsx@1.0.1:
+ resolution: {integrity: sha512-huSIy7VU2Z5OLv6oFLosQGGDqPqdO1iq6bWNAdhzMxSJP7RAso4fCZ1cKu8j9YHCZf3TPrq4dw3okhrylgcd7w==}
+ peerDependencies:
+ acorn: ^6.0.0 || ^7.0.0 || ^8.0.0
+
+ recma-parse@1.0.0:
+ resolution: {integrity: sha512-OYLsIGBB5Y5wjnSnQW6t3Xg7q3fQ7FWbw/vcXtORTnyaSFscOtABg+7Pnz6YZ6c27fG1/aN8CjfwoUEUIdwqWQ==}
+
+ recma-stringify@1.0.0:
+ resolution: {integrity: sha512-cjwII1MdIIVloKvC9ErQ+OgAtwHBmcZ0Bg4ciz78FtbT8In39aAYbaA7zvxQ61xVMSPE8WxhLwLbhif4Js2C+g==}
+
+ regex-recursion@6.0.2:
+ resolution: {integrity: sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==}
+
+ regex-utilities@2.3.0:
+ resolution: {integrity: sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==}
+
+ regex@6.1.0:
+ resolution: {integrity: sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==}
+
+ rehype-expressive-code@0.42.0:
+ resolution: {integrity: sha512-8rp/1YMEVVSYbtz+bFBx+uSx3vA4i4T8RwRm5Q/IWbucQnnQqQ0hDqtmKOr8tv+59Cik6cu5aH3WPo0I7csuTA==}
+
+ rehype-external-links@3.0.0:
+ resolution: {integrity: sha512-yp+e5N9V3C6bwBeAC4n796kc86M4gJCdlVhiMTxIrJG5UHDMh+PJANf9heqORJbt1nrCbDwIlAZKjANIaVBbvw==}
+
+ rehype-format@5.0.1:
+ resolution: {integrity: sha512-zvmVru9uB0josBVpr946OR8ui7nJEdzZobwLOOqHb/OOD88W0Vk2SqLwoVOj0fM6IPCCO6TaV9CvQvJMWwukFQ==}
+
+ rehype-minify-whitespace@6.0.2:
+ resolution: {integrity: sha512-Zk0pyQ06A3Lyxhe9vGtOtzz3Z0+qZ5+7icZ/PL/2x1SHPbKao5oB/g/rlc6BCTajqBb33JcOe71Ye1oFsuYbnw==}
+
+ rehype-parse@9.0.1:
+ resolution: {integrity: sha512-ksCzCD0Fgfh7trPDxr2rSylbwq9iYDkSn8TCDmEJ49ljEUBxDVCzCHv7QNzZOfODanX4+bWQ4WZqLCRWYLfhag==}
+
+ rehype-raw@7.0.0:
+ resolution: {integrity: sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==}
+
+ rehype-recma@1.0.0:
+ resolution: {integrity: sha512-lqA4rGUf1JmacCNWWZx0Wv1dHqMwxzsDWYMTowuplHF3xH0N/MmrZ/G3BDZnzAkRmxDadujCjaKM2hqYdCBOGw==}
+
+ rehype-remark@10.0.1:
+ resolution: {integrity: sha512-EmDndlb5NVwXGfUa4c9GPK+lXeItTilLhE6ADSaQuHr4JUlKw9MidzGzx4HpqZrNCt6vnHmEifXQiiA+CEnjYQ==}
+
+ rehype-stringify@10.0.1:
+ resolution: {integrity: sha512-k9ecfXHmIPuFVI61B9DeLPN0qFHfawM6RsuX48hoqlaKSF61RskNjSm1lI8PhBEM0MRdLxVVm4WmTqJQccH9mA==}
+
+ rehype@13.0.2:
+ resolution: {integrity: sha512-j31mdaRFrwFRUIlxGeuPXXKWQxet52RBQRvCmzl5eCefn/KGbomK5GMHNMsOJf55fgo3qw5tST5neDuarDYR2A==}
+
+ remark-directive@4.0.0:
+ resolution: {integrity: sha512-7sxn4RfF1o3izevPV1DheyGDD6X4c9hrGpfdUpm7uC++dqrnJxIZVkk7CoKqcLm0VUMAuOol7Mno3m6g8cfMuA==}
+
+ remark-gfm@4.0.1:
+ resolution: {integrity: sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==}
+
+ remark-mdx@3.1.1:
+ resolution: {integrity: sha512-Pjj2IYlUY3+D8x00UJsIOg5BEvfMyeI+2uLPn9VO9Wg4MEtN/VTIq2NEJQfde9PnX15KgtHyl9S0BcTnWrIuWg==}
+
+ remark-parse@11.0.0:
+ resolution: {integrity: sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==}
+
+ remark-rehype@11.1.2:
+ resolution: {integrity: sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==}
+
+ remark-smartypants@3.0.2:
+ resolution: {integrity: sha512-ILTWeOriIluwEvPjv67v7Blgrcx+LZOkAUVtKI3putuhlZm84FnqDORNXPPm+HY3NdZOMhyDwZ1E+eZB/Df5dA==}
+ engines: {node: '>=16.0.0'}
+
+ remark-stringify@11.0.0:
+ resolution: {integrity: sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==}
+
+ resolve-pkg-maps@1.0.0:
+ resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
+
+ retext-latin@4.0.0:
+ resolution: {integrity: sha512-hv9woG7Fy0M9IlRQloq/N6atV82NxLGveq+3H2WOi79dtIYWN8OaxogDm77f8YnVXJL2VD3bbqowu5E3EMhBYA==}
+
+ retext-smartypants@6.2.0:
+ resolution: {integrity: sha512-kk0jOU7+zGv//kfjXEBjdIryL1Acl4i9XNkHxtM7Tm5lFiCog576fjNC9hjoR7LTKQ0DsPWy09JummSsH1uqfQ==}
+
+ retext-stringify@4.0.0:
+ resolution: {integrity: sha512-rtfN/0o8kL1e+78+uxPTqu1Klt0yPzKuQ2BfWwwfgIUSayyzxpM1PJzkKt4V8803uB9qSy32MvI7Xep9khTpiA==}
+
+ retext@9.0.0:
+ resolution: {integrity: sha512-sbMDcpHCNjvlheSgMfEcVrZko3cDzdbe1x/e7G66dFp0Ff7Mldvi2uv6JkJQzdRcvLYE8CA8Oe8siQx8ZOgTcA==}
+
+ robust-predicates@3.0.3:
+ resolution: {integrity: sha512-NS3levdsRIUOmiJ8FZWCP7LG3QpJyrs/TE0Zpf1yvZu8cAJJ6QMW92H1c7kWpdIHo8RvmLxN/o2JXTKHp74lUA==}
+
+ rollup@4.60.4:
+ resolution: {integrity: sha512-WHeFSbZYsPu3+bLoNRUuAO+wavNlocOPf3wSHTP7hcFKVnJeWsYlCDbr3mTS14FCizf9ccIxXA8sGL8zKeQN3g==}
+ engines: {node: '>=18.0.0', npm: '>=8.0.0'}
+ hasBin: true
+
+ roughjs@4.6.6:
+ resolution: {integrity: sha512-ZUz/69+SYpFN/g/lUlo2FXcIjRkSu3nDarreVdGGndHEBJ6cXPdKguS8JGxwj5HA5xIbVKSmLgr5b3AWxtRfvQ==}
+
+ rw@1.3.3:
+ resolution: {integrity: sha512-PdhdWy89SiZogBLaw42zdeqtRJ//zFd2PgQavcICDUgJT5oW10QCRKbJ6bg4r0/UY2M6BWd5tkxuGFRvCkgfHQ==}
+
+ safer-buffer@2.1.2:
+ resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==}
+
+ sax@1.6.0:
+ resolution: {integrity: sha512-6R3J5M4AcbtLUdZmRv2SygeVaM7IhrLXu9BmnOGmmACak8fiUtOsYNWUS4uK7upbmHIBbLBeFeI//477BKLBzA==}
+ engines: {node: '>=11.0.0'}
+
+ semver@7.7.4:
+ resolution: {integrity: sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==}
+ engines: {node: '>=10'}
+ hasBin: true
+
+ semver@7.8.1:
+ resolution: {integrity: sha512-rkVq3IXh+4FDGch+KwzX3aV9W3kO54GyEgpvBzSyctDA6Xtd7RJQV1xmXbeQp5v7+VzLOfVqiutSE6GICgPFvg==}
+ engines: {node: '>=10'}
+ hasBin: true
+
+ sharp@0.34.5:
+ resolution: {integrity: sha512-Ou9I5Ft9WNcCbXrU9cMgPBcCK8LiwLqcbywW3t4oDV37n1pzpuNLsYiAV8eODnjbtQlSDwZ2cUEeQz4E54Hltg==}
+ engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+
+ shiki@4.0.2:
+ resolution: {integrity: sha512-eAVKTMedR5ckPo4xne/PjYQYrU3qx78gtJZ+sHlXEg5IHhhoQhMfZVzetTYuaJS0L2Ef3AcCRzCHV8T0WI6nIQ==}
+ engines: {node: '>=20'}
+
+ shiki@4.1.0:
+ resolution: {integrity: sha512-l/ABZPUR5v70jI10EzqfMS/I96vjSGv2y0ihUV+WYFzv0EfvW4s54m0Lg8wCrrL+2IkwBzFTuxkZjPf8b2NX9Q==}
+ engines: {node: '>=20'}
+
+ sisteransi@1.0.5:
+ resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==}
+
+ sitemap@9.0.1:
+ resolution: {integrity: sha512-S6hzjGJSG3d6if0YoF5kTyeRJvia6FSTBroE5fQ0bu1QNxyJqhhinfUsXi9fH3MgtXODWvwo2BDyQSnhPQ88uQ==}
+ engines: {node: '>=20.19.5', npm: '>=10.8.2'}
+ hasBin: true
+
+ smol-toml@1.6.1:
+ resolution: {integrity: sha512-dWUG8F5sIIARXih1DTaQAX4SsiTXhInKf1buxdY9DIg4ZYPZK5nGM1VRIYmEbDbsHt7USo99xSLFu5Q1IqTmsg==}
+ engines: {node: '>= 18'}
+
+ source-map-js@1.2.1:
+ resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
+ engines: {node: '>=0.10.0'}
+
+ source-map@0.7.6:
+ resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==}
+ engines: {node: '>= 12'}
+
+ space-separated-tokens@2.0.2:
+ resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==}
+
+ starlight-changelogs@0.5.0:
+ resolution: {integrity: sha512-bqBAHle6N4jApkLz8qlN+k8nmaJUXvYunrJeYWTZats15SeEmsT+1N7KdshODCky2AzLfIBy4Qa2v1YSQNrjxQ==}
+ engines: {node: '>=22.12.0'}
+ peerDependencies:
+ '@astrojs/starlight': '>=0.38.0'
+
+ starlight-contextual-menu@0.1.5:
+ resolution: {integrity: sha512-MYQ6eFDIBBnKrEh3XqR7RZ6YDJ641ADmrSjj93d+cVJGPvrCHrd6VYiKeehhczsrn6GqjaCCFAn4xUd69gcfcQ==}
+ peerDependencies:
+ astro: ^5.0.0
+ starlight-markdown: ^0.1.5
+
+ starlight-links-validator@0.24.0:
+ resolution: {integrity: sha512-bsZf77oRJmY92KWOcu3vYK8Y12KJNvO3jQca1BgOBs+XskNfjPXrkgVtT7ls/FnLoomfsIV0wLdJfJs7kzGojA==}
+ engines: {node: '>=22.12.0'}
+ peerDependencies:
+ '@astrojs/starlight': '>=0.38.0'
+ astro: '>=6.0.0'
+
+ starlight-llms-txt@0.10.0:
+ resolution: {integrity: sha512-LgkSjkvdACsGHkFq1ES00F0BU4lRepjJoaUmOgxBxNWx4txwpySVPtntKdAvDvlhinyN0ZBRpnAsN/sVQ1UEfA==}
+ peerDependencies:
+ '@astrojs/starlight': '>=0.38.0'
+ astro: ^6.0.0
+
+ starlight-markdown@0.1.5:
+ resolution: {integrity: sha512-23LXRaZp7pyE+r/HP6rxHfwic8HfvUBT4EImECA6encs/eTtrF0Z+7svANofdtfbiNt31D5q26i03B6FtcSmGg==}
+ peerDependencies:
+ astro: ^5.0.0
+
+ stream-replace-string@2.0.0:
+ resolution: {integrity: sha512-TlnjJ1C0QrmxRNrON00JvaFFlNh5TTG00APw23j74ET7gkQpTASi6/L2fuiav8pzK715HXtUeClpBTw2NPSn6w==}
+
+ stringify-entities@4.0.4:
+ resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==}
+
+ style-to-js@1.1.21:
+ resolution: {integrity: sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==}
+
+ style-to-object@1.0.14:
+ resolution: {integrity: sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==}
+
+ stylis@4.3.6:
+ resolution: {integrity: sha512-yQ3rwFWRfwNUY7H5vpU0wfdkNSnvnJinhF9830Swlaxl03zsOjCfmX0ugac+3LtK0lYSgwL/KXc8oYL3mG4YFQ==}
+
+ supports-color@10.2.2:
+ resolution: {integrity: sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==}
+ engines: {node: '>=18'}
+
+ supports-hyperlinks@4.4.0:
+ resolution: {integrity: sha512-UKbpT93hN5Nr9go5UY7bopIB9YQlMz9nm/ct4IXt/irb5YRkn9WaqrOBJGZ5Pwvsd5FQzSVeYlGdXoCAPQZrPg==}
+ engines: {node: '>=20'}
+
+ svgo@4.0.1:
+ resolution: {integrity: sha512-XDpWUOPC6FEibaLzjfe0ucaV0YrOjYotGJO1WpF0Zd+n6ZGEQUsSugaoLq9QkEZtAfQIxT42UChcssDVPP3+/w==}
+ engines: {node: '>=16'}
+ hasBin: true
+
+ tar@7.5.15:
+ resolution: {integrity: sha512-dzGK0boVlC4W5QFuQN1EFSl3bIDYsk7Tj40U6eIBnK2k/8ml7TZ5agbI5j5+qnoVcAA+rNtBml8SEiLxZpNqRQ==}
+ engines: {node: '>=18'}
+
+ terminal-link@5.0.0:
+ resolution: {integrity: sha512-qFAy10MTMwjzjU8U16YS4YoZD+NQLHzLssFMNqgravjbvIPNiqkGFR4yjhJfmY9R5OFU7+yHxc6y+uGHkKwLRA==}
+ engines: {node: '>=20'}
+
+ tiny-inflate@1.0.3:
+ resolution: {integrity: sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==}
+
+ tinyclip@0.1.12:
+ resolution: {integrity: sha512-Ae3OVUqifDw0wBriIBS7yVaW44Dp6eSHQcyq4Igc7eN2TJH/2YsicswaW+J/OuMvhpDPOKEgpAZCjkb4hpoyeA==}
+ engines: {node: ^16.14.0 || >= 17.3.0}
+
+ tinyexec@1.0.4:
+ resolution: {integrity: sha512-u9r3uZC0bdpGOXtlxUIdwf9pkmvhqJdrVCH9fapQtgy/OeTTMZ1nqH7agtvEfmGui6e1XxjcdrlxvxJvc3sMqw==}
+ engines: {node: '>=18'}
+
+ tinyexec@1.2.2:
+ resolution: {integrity: sha512-M/Q0B2cp4K7kynaT/vnED1j8TlLY+Pp7C6Wl2bl/7u/F0mUVwdyOpwomQb8JpYLitHUssAJRmLZdMCGsrx7i+g==}
+ engines: {node: '>=18'}
+
+ tinyglobby@0.2.16:
+ resolution: {integrity: sha512-pn99VhoACYR8nFHhxqix+uvsbXineAasWm5ojXoN8xEwK5Kd3/TrhNn1wByuD52UxWRLy8pu+kRMniEi6Eq9Zg==}
+ engines: {node: '>=12.0.0'}
+
+ to-regex-range@5.0.1:
+ resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}
+ engines: {node: '>=8.0'}
+
+ trim-lines@3.0.1:
+ resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==}
+
+ trim-trailing-lines@2.1.0:
+ resolution: {integrity: sha512-5UR5Biq4VlVOtzqkm2AZlgvSlDJtME46uV0br0gENbwN4l5+mMKT4b9gJKqWtuL2zAIqajGJGuvbCbcAJUZqBg==}
+
+ trough@2.2.0:
+ resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==}
+
+ ts-dedent@2.2.0:
+ resolution: {integrity: sha512-q5W7tVM71e2xjHZTlgfTDoPF/SmqKG5hddq9SzR49CH2hayqRKJtQ4mtRlSxKaJlR/+9rEM+mnBHf7I2/BQcpQ==}
+ engines: {node: '>=6.10'}
+
+ tslib@2.8.1:
+ resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
+
+ ufo@1.6.3:
+ resolution: {integrity: sha512-yDJTmhydvl5lJzBmy/hyOAA0d+aqCBuwl818haVdYCRrWV84o7YyeVm4QlVHStqNrrJSTb6jKuFAVqAFsr+K3Q==}
+
+ ufo@1.6.4:
+ resolution: {integrity: sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==}
+
+ ultrahtml@1.6.0:
+ resolution: {integrity: sha512-R9fBn90VTJrqqLDwyMph+HGne8eqY1iPfYhPzZrvKpIfwkWZbcYlfpsb8B9dTvBfpy1/hqAD7Wi8EKfP9e8zdw==}
+
+ uncrypto@0.1.3:
+ resolution: {integrity: sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==}
+
+ undici-types@7.16.0:
+ resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==}
+
+ undici@6.25.0:
+ resolution: {integrity: sha512-ZgpWDC5gmNiuY9CnLVXEH8rl50xhRCuLNA97fAUnKi8RRuV4E6KG31pDTsLVUKnohJE0I3XDrTeEydAXRw47xg==}
+ engines: {node: '>=18.17'}
+
+ unified@11.0.5:
+ resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==}
+
+ unifont@0.7.4:
+ resolution: {integrity: sha512-oHeis4/xl42HUIeHuNZRGEvxj5AaIKR+bHPNegRq5LV1gdc3jundpONbjglKpihmJf+dswygdMJn3eftGIMemg==}
+
+ unist-util-find-after@5.0.0:
+ resolution: {integrity: sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ==}
+
+ unist-util-is@6.0.1:
+ resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==}
+
+ unist-util-modify-children@4.0.0:
+ resolution: {integrity: sha512-+tdN5fGNddvsQdIzUF3Xx82CU9sMM+fA0dLgR9vOmT0oPT2jH+P1nd5lSqfCfXAw+93NhcXNY2qqvTUtE4cQkw==}
+
+ unist-util-position-from-estree@2.0.0:
+ resolution: {integrity: sha512-KaFVRjoqLyF6YXCbVLNad/eS4+OfPQQn2yOd7zF/h5T/CSL2v8NpN6a5TPvtbXthAGw5nG+PuTtq+DdIZr+cRQ==}
+
+ unist-util-position@5.0.0:
+ resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==}
+
+ unist-util-remove-position@5.0.0:
+ resolution: {integrity: sha512-Hp5Kh3wLxv0PHj9m2yZhhLt58KzPtEYKQQ4yxfYFEO7EvHwzyDYnduhHnY1mDxoqr7VUwVuHXk9RXKIiYS1N8Q==}
+
+ unist-util-remove@4.0.0:
+ resolution: {integrity: sha512-b4gokeGId57UVRX/eVKej5gXqGlc9+trkORhFJpu9raqZkZhU0zm8Doi05+HaiBsMEIJowL+2WtQ5ItjsngPXg==}
+
+ unist-util-stringify-position@4.0.0:
+ resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==}
+
+ unist-util-visit-children@3.0.0:
+ resolution: {integrity: sha512-RgmdTfSBOg04sdPcpTSD1jzoNBjt9a80/ZCzp5cI9n1qPzLZWF9YdvWGN2zmTumP1HWhXKdUWexjy/Wy/lJ7tA==}
+
+ unist-util-visit-parents@6.0.2:
+ resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==}
+
+ unist-util-visit@5.1.0:
+ resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==}
+
+ unstorage@1.17.5:
+ resolution: {integrity: sha512-0i3iqvRfx29hkNntHyQvJTpf5W9dQ9ZadSoRU8+xVlhVtT7jAX57fazYO9EHvcRCfBCyi5YRya7XCDOsbTgkPg==}
+ peerDependencies:
+ '@azure/app-configuration': ^1.8.0
+ '@azure/cosmos': ^4.2.0
+ '@azure/data-tables': ^13.3.0
+ '@azure/identity': ^4.6.0
+ '@azure/keyvault-secrets': ^4.9.0
+ '@azure/storage-blob': ^12.26.0
+ '@capacitor/preferences': ^6 || ^7 || ^8
+ '@deno/kv': '>=0.9.0'
+ '@netlify/blobs': ^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0
+ '@planetscale/database': ^1.19.0
+ '@upstash/redis': ^1.34.3
+ '@vercel/blob': '>=0.27.1'
+ '@vercel/functions': ^2.2.12 || ^3.0.0
+ '@vercel/kv': ^1 || ^2 || ^3
+ aws4fetch: ^1.0.20
+ db0: '>=0.2.1'
+ idb-keyval: ^6.2.1
+ ioredis: ^5.4.2
+ uploadthing: ^7.4.4
+ peerDependenciesMeta:
+ '@azure/app-configuration':
+ optional: true
+ '@azure/cosmos':
+ optional: true
+ '@azure/data-tables':
+ optional: true
+ '@azure/identity':
+ optional: true
+ '@azure/keyvault-secrets':
+ optional: true
+ '@azure/storage-blob':
+ optional: true
+ '@capacitor/preferences':
+ optional: true
+ '@deno/kv':
+ optional: true
+ '@netlify/blobs':
+ optional: true
+ '@planetscale/database':
+ optional: true
+ '@upstash/redis':
+ optional: true
+ '@vercel/blob':
+ optional: true
+ '@vercel/functions':
+ optional: true
+ '@vercel/kv':
+ optional: true
+ aws4fetch:
+ optional: true
+ db0:
+ optional: true
+ idb-keyval:
+ optional: true
+ ioredis:
+ optional: true
+ uploadthing:
+ optional: true
+
+ util-deprecate@1.0.2:
+ resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
+
+ uuid@11.1.0:
+ resolution: {integrity: sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==}
+ hasBin: true
+
+ vfile-location@5.0.3:
+ resolution: {integrity: sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==}
+
+ vfile-message@4.0.3:
+ resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
+
+ vfile@6.0.3:
+ resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==}
+
+ vite@7.3.3:
+ resolution: {integrity: sha512-/4XH147Ui7OGTjg3HbdWe5arnZQSbfuRzdr9Ec7TQi5I7R+ir0Rlc9GIvD4v0XZurELqA035KVXJXpR61xhiTA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+ peerDependencies:
+ '@types/node': ^20.19.0 || >=22.12.0
+ jiti: '>=1.21.0'
+ less: ^4.0.0
+ lightningcss: ^1.21.0
+ sass: ^1.70.0
+ sass-embedded: ^1.70.0
+ stylus: '>=0.54.8'
+ sugarss: ^5.0.0
+ terser: ^5.16.0
+ tsx: ^4.8.1
+ yaml: ^2.4.2
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+ jiti:
+ optional: true
+ less:
+ optional: true
+ lightningcss:
+ optional: true
+ sass:
+ optional: true
+ sass-embedded:
+ optional: true
+ stylus:
+ optional: true
+ sugarss:
+ optional: true
+ terser:
+ optional: true
+ tsx:
+ optional: true
+ yaml:
+ optional: true
+
+ vitefu@1.1.3:
+ resolution: {integrity: sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg==}
+ peerDependencies:
+ vite: ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0
+ peerDependenciesMeta:
+ vite:
+ optional: true
+
+ web-namespaces@2.0.1:
+ resolution: {integrity: sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==}
+
+ which-pm-runs@1.1.0:
+ resolution: {integrity: sha512-n1brCuqClxfFfq/Rb0ICg9giSZqCS+pLtccdag6C2HyufBrh3fBOiy9nb6ggRMvWOVH5GrdJskj5iGTZNxd7SA==}
+ engines: {node: '>=4'}
+
+ which@6.0.1:
+ resolution: {integrity: sha512-oGLe46MIrCRqX7ytPUf66EAYvdeMIZYn3WaocqqKZAxrBpkqHfL/qvTyJ/bTk5+AqHCjXmrv3CEWgy368zhRUg==}
+ engines: {node: ^20.17.0 || >=22.9.0}
+ hasBin: true
+
+ xxhash-wasm@1.1.0:
+ resolution: {integrity: sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA==}
+
+ yallist@5.0.0:
+ resolution: {integrity: sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==}
+ engines: {node: '>=18'}
+
+ yaml@2.9.0:
+ resolution: {integrity: sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==}
+ engines: {node: '>= 14.6'}
+ hasBin: true
+
+ yargs-parser@22.0.0:
+ resolution: {integrity: sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==}
+ engines: {node: ^20.19.0 || ^22.12.0 || >=23}
+
+ yocto-queue@1.2.2:
+ resolution: {integrity: sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==}
+ engines: {node: '>=12.20'}
+
+ zod@4.4.3:
+ resolution: {integrity: sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ==}
+
+ zwitch@2.0.4:
+ resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==}
+
+snapshots:
+
+ '@antfu/install-pkg@1.1.0':
+ dependencies:
+ package-manager-detector: 1.6.0
+ tinyexec: 1.0.4
+
+ '@ascorbic/loader-utils@1.0.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))':
+ dependencies:
+ astro: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+
+ '@astrojs/compiler@4.0.0': {}
+
+ '@astrojs/internal-helpers@0.9.0':
+ dependencies:
+ picomatch: 4.0.4
+
+ '@astrojs/internal-helpers@0.9.1':
+ dependencies:
+ picomatch: 4.0.4
+
+ '@astrojs/markdown-remark@7.1.1':
+ dependencies:
+ '@astrojs/internal-helpers': 0.9.0
+ '@astrojs/prism': 4.0.1
+ github-slugger: 2.0.0
+ hast-util-from-html: 2.0.3
+ hast-util-to-text: 4.0.2
+ js-yaml: 4.1.1
+ mdast-util-definitions: 6.0.0
+ rehype-raw: 7.0.0
+ rehype-stringify: 10.0.1
+ remark-gfm: 4.0.1
+ remark-parse: 11.0.0
+ remark-rehype: 11.1.2
+ remark-smartypants: 3.0.2
+ retext-smartypants: 6.2.0
+ shiki: 4.0.2
+ smol-toml: 1.6.1
+ unified: 11.0.5
+ unist-util-remove-position: 5.0.0
+ unist-util-visit: 5.1.0
+ unist-util-visit-parents: 6.0.2
+ vfile: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@astrojs/markdown-remark@7.1.2':
+ dependencies:
+ '@astrojs/internal-helpers': 0.9.1
+ '@astrojs/prism': 4.0.2
+ github-slugger: 2.0.0
+ hast-util-from-html: 2.0.3
+ hast-util-to-text: 4.0.2
+ js-yaml: 4.1.1
+ mdast-util-definitions: 6.0.0
+ rehype-raw: 7.0.0
+ rehype-stringify: 10.0.1
+ remark-gfm: 4.0.1
+ remark-parse: 11.0.0
+ remark-rehype: 11.1.2
+ remark-smartypants: 3.0.2
+ retext-smartypants: 6.2.0
+ shiki: 4.1.0
+ smol-toml: 1.6.1
+ unified: 11.0.5
+ unist-util-remove-position: 5.0.0
+ unist-util-visit: 5.1.0
+ unist-util-visit-parents: 6.0.2
+ vfile: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@astrojs/mdx@5.0.4(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))':
+ dependencies:
+ '@astrojs/markdown-remark': 7.1.1
+ '@mdx-js/mdx': 3.1.1
+ acorn: 8.16.0
+ astro: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+ es-module-lexer: 2.1.0
+ estree-util-visit: 2.0.0
+ hast-util-to-html: 9.0.5
+ piccolore: 0.1.3
+ rehype-raw: 7.0.0
+ remark-gfm: 4.0.1
+ remark-smartypants: 3.0.2
+ source-map: 0.7.6
+ unist-util-visit: 5.1.0
+ vfile: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@astrojs/mdx@5.0.6(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))':
+ dependencies:
+ '@astrojs/markdown-remark': 7.1.2
+ '@mdx-js/mdx': 3.1.1
+ acorn: 8.16.0
+ astro: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+ es-module-lexer: 2.1.0
+ estree-util-visit: 2.0.0
+ hast-util-to-html: 9.0.5
+ piccolore: 0.1.3
+ rehype-raw: 7.0.0
+ remark-gfm: 4.0.1
+ remark-smartypants: 3.0.2
+ source-map: 0.7.6
+ unist-util-visit: 5.1.0
+ vfile: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@astrojs/prism@4.0.1':
+ dependencies:
+ prismjs: 1.30.0
+
+ '@astrojs/prism@4.0.2':
+ dependencies:
+ prismjs: 1.30.0
+
+ '@astrojs/sitemap@3.7.2':
+ dependencies:
+ sitemap: 9.0.1
+ stream-replace-string: 2.0.0
+ zod: 4.4.3
+
+ '@astrojs/starlight@0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))':
+ dependencies:
+ '@astrojs/markdown-remark': 7.1.1
+ '@astrojs/mdx': 5.0.4(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ '@astrojs/sitemap': 3.7.2
+ '@pagefind/default-ui': 1.5.2
+ '@types/hast': 3.0.4
+ '@types/js-yaml': 4.0.9
+ '@types/mdast': 4.0.4
+ astro: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+ astro-expressive-code: 0.42.0(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ bcp-47: 2.1.0
+ hast-util-from-html: 2.0.3
+ hast-util-select: 6.0.4
+ hast-util-to-string: 3.0.1
+ hastscript: 9.0.1
+ i18next: 26.1.0
+ js-yaml: 4.1.1
+ klona: 2.0.6
+ magic-string: 0.30.21
+ mdast-util-directive: 3.1.0
+ mdast-util-to-markdown: 2.1.2
+ mdast-util-to-string: 4.0.0
+ pagefind: 1.5.2
+ rehype: 13.0.2
+ rehype-format: 5.0.1
+ remark-directive: 4.0.0
+ ultrahtml: 1.6.0
+ unified: 11.0.5
+ unist-util-visit: 5.1.0
+ vfile: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+ - typescript
+
+ '@astrojs/telemetry@3.3.2':
+ dependencies:
+ ci-info: 4.4.0
+ dset: 3.1.4
+ is-docker: 4.0.0
+ is-wsl: 3.1.1
+ which-pm-runs: 1.1.0
+
+ '@babel/helper-string-parser@7.27.1': {}
+
+ '@babel/helper-validator-identifier@7.28.5': {}
+
+ '@babel/parser@7.29.3':
+ dependencies:
+ '@babel/types': 7.29.0
+
+ '@babel/types@7.29.0':
+ dependencies:
+ '@babel/helper-string-parser': 7.27.1
+ '@babel/helper-validator-identifier': 7.28.5
+
+ '@braintree/sanitize-url@7.1.2': {}
+
+ '@capsizecss/unpack@4.0.0':
+ dependencies:
+ fontkitten: 1.0.3
+
+ '@chevrotain/types@11.1.2': {}
+
+ '@clack/core@1.3.1':
+ dependencies:
+ fast-wrap-ansi: 0.2.2
+ sisteransi: 1.0.5
+
+ '@clack/prompts@1.4.0':
+ dependencies:
+ '@clack/core': 1.3.1
+ fast-string-width: 3.0.2
+ fast-wrap-ansi: 0.2.2
+ sisteransi: 1.0.5
+
+ '@ctrl/tinycolor@4.2.0': {}
+
+ '@emnapi/runtime@1.9.2':
+ dependencies:
+ tslib: 2.8.1
+ optional: true
+
+ '@esbuild/aix-ppc64@0.27.7':
+ optional: true
+
+ '@esbuild/android-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/android-arm@0.27.7':
+ optional: true
+
+ '@esbuild/android-x64@0.27.7':
+ optional: true
+
+ '@esbuild/darwin-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/darwin-x64@0.27.7':
+ optional: true
+
+ '@esbuild/freebsd-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/freebsd-x64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-arm@0.27.7':
+ optional: true
+
+ '@esbuild/linux-ia32@0.27.7':
+ optional: true
+
+ '@esbuild/linux-loong64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-mips64el@0.27.7':
+ optional: true
+
+ '@esbuild/linux-ppc64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-riscv64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-s390x@0.27.7':
+ optional: true
+
+ '@esbuild/linux-x64@0.27.7':
+ optional: true
+
+ '@esbuild/netbsd-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/netbsd-x64@0.27.7':
+ optional: true
+
+ '@esbuild/openbsd-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/openbsd-x64@0.27.7':
+ optional: true
+
+ '@esbuild/openharmony-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/sunos-x64@0.27.7':
+ optional: true
+
+ '@esbuild/win32-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/win32-ia32@0.27.7':
+ optional: true
+
+ '@esbuild/win32-x64@0.27.7':
+ optional: true
+
+ '@expressive-code/core@0.42.0':
+ dependencies:
+ '@ctrl/tinycolor': 4.2.0
+ hast-util-select: 6.0.4
+ hast-util-to-html: 9.0.5
+ hast-util-to-text: 4.0.2
+ hastscript: 9.0.1
+ postcss: 8.5.14
+ postcss-nested: 6.2.0(postcss@8.5.14)
+ unist-util-visit: 5.1.0
+ unist-util-visit-parents: 6.0.2
+
+ '@expressive-code/plugin-frames@0.42.0':
+ dependencies:
+ '@expressive-code/core': 0.42.0
+
+ '@expressive-code/plugin-shiki@0.42.0':
+ dependencies:
+ '@expressive-code/core': 0.42.0
+ shiki: 4.0.2
+
+ '@expressive-code/plugin-text-markers@0.42.0':
+ dependencies:
+ '@expressive-code/core': 0.42.0
+
+ '@fontsource-variable/inter@5.2.8': {}
+
+ '@fontsource-variable/roboto-mono@5.2.9': {}
+
+ '@iconify/types@2.0.0': {}
+
+ '@iconify/utils@3.1.0':
+ dependencies:
+ '@antfu/install-pkg': 1.1.0
+ '@iconify/types': 2.0.0
+ mlly: 1.8.2
+
+ '@img/colour@1.1.0': {}
+
+ '@img/sharp-darwin-arm64@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-darwin-arm64': 1.2.4
+ optional: true
+
+ '@img/sharp-darwin-x64@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-darwin-x64': 1.2.4
+ optional: true
+
+ '@img/sharp-libvips-darwin-arm64@1.2.4':
+ optional: true
+
+ '@img/sharp-libvips-darwin-x64@1.2.4':
+ optional: true
+
+ '@img/sharp-libvips-linux-arm64@1.2.4':
+ optional: true
+
+ '@img/sharp-libvips-linux-arm@1.2.4':
+ optional: true
+
+ '@img/sharp-libvips-linux-ppc64@1.2.4':
+ optional: true
+
+ '@img/sharp-libvips-linux-riscv64@1.2.4':
+ optional: true
+
+ '@img/sharp-libvips-linux-s390x@1.2.4':
+ optional: true
+
+ '@img/sharp-libvips-linux-x64@1.2.4':
+ optional: true
+
+ '@img/sharp-libvips-linuxmusl-arm64@1.2.4':
+ optional: true
+
+ '@img/sharp-libvips-linuxmusl-x64@1.2.4':
+ optional: true
+
+ '@img/sharp-linux-arm64@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-linux-arm64': 1.2.4
+ optional: true
+
+ '@img/sharp-linux-arm@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-linux-arm': 1.2.4
+ optional: true
+
+ '@img/sharp-linux-ppc64@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-linux-ppc64': 1.2.4
+ optional: true
+
+ '@img/sharp-linux-riscv64@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-linux-riscv64': 1.2.4
+ optional: true
+
+ '@img/sharp-linux-s390x@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-linux-s390x': 1.2.4
+ optional: true
+
+ '@img/sharp-linux-x64@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-linux-x64': 1.2.4
+ optional: true
+
+ '@img/sharp-linuxmusl-arm64@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-linuxmusl-arm64': 1.2.4
+ optional: true
+
+ '@img/sharp-linuxmusl-x64@0.34.5':
+ optionalDependencies:
+ '@img/sharp-libvips-linuxmusl-x64': 1.2.4
+ optional: true
+
+ '@img/sharp-wasm32@0.34.5':
+ dependencies:
+ '@emnapi/runtime': 1.9.2
+ optional: true
+
+ '@img/sharp-win32-arm64@0.34.5':
+ optional: true
+
+ '@img/sharp-win32-ia32@0.34.5':
+ optional: true
+
+ '@img/sharp-win32-x64@0.34.5':
+ optional: true
+
+ '@isaacs/fs-minipass@4.0.1':
+ dependencies:
+ minipass: 7.1.3
+
+ '@jridgewell/sourcemap-codec@1.5.5': {}
+
+ '@mdx-js/mdx@3.1.1':
+ dependencies:
+ '@types/estree': 1.0.8
+ '@types/estree-jsx': 1.0.5
+ '@types/hast': 3.0.4
+ '@types/mdx': 2.0.13
+ acorn: 8.16.0
+ collapse-white-space: 2.1.0
+ devlop: 1.1.0
+ estree-util-is-identifier-name: 3.0.0
+ estree-util-scope: 1.0.0
+ estree-walker: 3.0.3
+ hast-util-to-jsx-runtime: 2.3.6
+ markdown-extensions: 2.0.0
+ recma-build-jsx: 1.0.0
+ recma-jsx: 1.0.1(acorn@8.16.0)
+ recma-stringify: 1.0.0
+ rehype-recma: 1.0.0
+ remark-mdx: 3.1.1
+ remark-parse: 11.0.0
+ remark-rehype: 11.1.2
+ source-map: 0.7.6
+ unified: 11.0.5
+ unist-util-position-from-estree: 2.0.0
+ unist-util-stringify-position: 4.0.0
+ unist-util-visit: 5.1.0
+ vfile: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@mermaid-js/parser@1.1.1':
+ dependencies:
+ '@chevrotain/types': 11.1.2
+
+ '@oslojs/encoding@1.1.0': {}
+
+ '@pagefind/darwin-arm64@1.5.2':
+ optional: true
+
+ '@pagefind/darwin-x64@1.5.2':
+ optional: true
+
+ '@pagefind/default-ui@1.5.2': {}
+
+ '@pagefind/freebsd-x64@1.5.2':
+ optional: true
+
+ '@pagefind/linux-arm64@1.5.2':
+ optional: true
+
+ '@pagefind/linux-x64@1.5.2':
+ optional: true
+
+ '@pagefind/windows-arm64@1.5.2':
+ optional: true
+
+ '@pagefind/windows-x64@1.5.2':
+ optional: true
+
+ '@rollup/pluginutils@5.3.0(rollup@4.60.4)':
+ dependencies:
+ '@types/estree': 1.0.9
+ estree-walker: 2.0.2
+ picomatch: 4.0.4
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/rollup-android-arm-eabi@4.60.4':
+ optional: true
+
+ '@rollup/rollup-android-arm64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-darwin-arm64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-darwin-x64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-freebsd-arm64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-freebsd-x64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-arm-gnueabihf@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-arm-musleabihf@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-arm64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-arm64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-loong64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-loong64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-ppc64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-ppc64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-riscv64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-riscv64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-s390x-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-x64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-x64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-openbsd-x64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-openharmony-arm64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-win32-arm64-msvc@4.60.4':
+ optional: true
+
+ '@rollup/rollup-win32-ia32-msvc@4.60.4':
+ optional: true
+
+ '@rollup/rollup-win32-x64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-win32-x64-msvc@4.60.4':
+ optional: true
+
+ '@shikijs/core@4.0.2':
+ dependencies:
+ '@shikijs/primitive': 4.0.2
+ '@shikijs/types': 4.0.2
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+ hast-util-to-html: 9.0.5
+
+ '@shikijs/core@4.1.0':
+ dependencies:
+ '@shikijs/primitive': 4.1.0
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+ hast-util-to-html: 9.0.5
+
+ '@shikijs/engine-javascript@4.0.2':
+ dependencies:
+ '@shikijs/types': 4.0.2
+ '@shikijs/vscode-textmate': 10.0.2
+ oniguruma-to-es: 4.3.5
+
+ '@shikijs/engine-javascript@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+ oniguruma-to-es: 4.3.6
+
+ '@shikijs/engine-oniguruma@4.0.2':
+ dependencies:
+ '@shikijs/types': 4.0.2
+ '@shikijs/vscode-textmate': 10.0.2
+
+ '@shikijs/engine-oniguruma@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+
+ '@shikijs/langs@4.0.2':
+ dependencies:
+ '@shikijs/types': 4.0.2
+
+ '@shikijs/langs@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+
+ '@shikijs/primitive@4.0.2':
+ dependencies:
+ '@shikijs/types': 4.0.2
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+
+ '@shikijs/primitive@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+
+ '@shikijs/themes@4.0.2':
+ dependencies:
+ '@shikijs/types': 4.0.2
+
+ '@shikijs/themes@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+
+ '@shikijs/types@4.0.2':
+ dependencies:
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+
+ '@shikijs/types@4.1.0':
+ dependencies:
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+
+ '@shikijs/vscode-textmate@10.0.2': {}
+
+ '@types/braces@3.0.5': {}
+
+ '@types/d3-array@3.2.2': {}
+
+ '@types/d3-axis@3.0.6':
+ dependencies:
+ '@types/d3-selection': 3.0.11
+
+ '@types/d3-brush@3.0.6':
+ dependencies:
+ '@types/d3-selection': 3.0.11
+
+ '@types/d3-chord@3.0.6': {}
+
+ '@types/d3-color@3.1.3': {}
+
+ '@types/d3-contour@3.0.6':
+ dependencies:
+ '@types/d3-array': 3.2.2
+ '@types/geojson': 7946.0.16
+
+ '@types/d3-delaunay@6.0.4': {}
+
+ '@types/d3-dispatch@3.0.7': {}
+
+ '@types/d3-drag@3.0.7':
+ dependencies:
+ '@types/d3-selection': 3.0.11
+
+ '@types/d3-dsv@3.0.7': {}
+
+ '@types/d3-ease@3.0.2': {}
+
+ '@types/d3-fetch@3.0.7':
+ dependencies:
+ '@types/d3-dsv': 3.0.7
+
+ '@types/d3-force@3.0.10': {}
+
+ '@types/d3-format@3.0.4': {}
+
+ '@types/d3-geo@3.1.0':
+ dependencies:
+ '@types/geojson': 7946.0.16
+
+ '@types/d3-hierarchy@3.1.7': {}
+
+ '@types/d3-interpolate@3.0.4':
+ dependencies:
+ '@types/d3-color': 3.1.3
+
+ '@types/d3-path@3.1.1': {}
+
+ '@types/d3-polygon@3.0.2': {}
+
+ '@types/d3-quadtree@3.0.6': {}
+
+ '@types/d3-random@3.0.3': {}
+
+ '@types/d3-scale-chromatic@3.1.0': {}
+
+ '@types/d3-scale@4.0.9':
+ dependencies:
+ '@types/d3-time': 3.0.4
+
+ '@types/d3-selection@3.0.11': {}
+
+ '@types/d3-shape@3.1.8':
+ dependencies:
+ '@types/d3-path': 3.1.1
+
+ '@types/d3-time-format@4.0.3': {}
+
+ '@types/d3-time@3.0.4': {}
+
+ '@types/d3-timer@3.0.2': {}
+
+ '@types/d3-transition@3.0.9':
+ dependencies:
+ '@types/d3-selection': 3.0.11
+
+ '@types/d3-zoom@3.0.8':
+ dependencies:
+ '@types/d3-interpolate': 3.0.4
+ '@types/d3-selection': 3.0.11
+
+ '@types/d3@7.4.3':
+ dependencies:
+ '@types/d3-array': 3.2.2
+ '@types/d3-axis': 3.0.6
+ '@types/d3-brush': 3.0.6
+ '@types/d3-chord': 3.0.6
+ '@types/d3-color': 3.1.3
+ '@types/d3-contour': 3.0.6
+ '@types/d3-delaunay': 6.0.4
+ '@types/d3-dispatch': 3.0.7
+ '@types/d3-drag': 3.0.7
+ '@types/d3-dsv': 3.0.7
+ '@types/d3-ease': 3.0.2
+ '@types/d3-fetch': 3.0.7
+ '@types/d3-force': 3.0.10
+ '@types/d3-format': 3.0.4
+ '@types/d3-geo': 3.1.0
+ '@types/d3-hierarchy': 3.1.7
+ '@types/d3-interpolate': 3.0.4
+ '@types/d3-path': 3.1.1
+ '@types/d3-polygon': 3.0.2
+ '@types/d3-quadtree': 3.0.6
+ '@types/d3-random': 3.0.3
+ '@types/d3-scale': 4.0.9
+ '@types/d3-scale-chromatic': 3.1.0
+ '@types/d3-selection': 3.0.11
+ '@types/d3-shape': 3.1.8
+ '@types/d3-time': 3.0.4
+ '@types/d3-time-format': 4.0.3
+ '@types/d3-timer': 3.0.2
+ '@types/d3-transition': 3.0.9
+ '@types/d3-zoom': 3.0.8
+
+ '@types/debug@4.1.13':
+ dependencies:
+ '@types/ms': 2.1.0
+
+ '@types/estree-jsx@1.0.5':
+ dependencies:
+ '@types/estree': 1.0.8
+
+ '@types/estree@1.0.8': {}
+
+ '@types/estree@1.0.9': {}
+
+ '@types/geojson@7946.0.16': {}
+
+ '@types/hast@3.0.4':
+ dependencies:
+ '@types/unist': 3.0.3
+
+ '@types/js-yaml@4.0.9': {}
+
+ '@types/mdast@4.0.4':
+ dependencies:
+ '@types/unist': 3.0.3
+
+ '@types/mdx@2.0.13': {}
+
+ '@types/micromatch@4.0.10':
+ dependencies:
+ '@types/braces': 3.0.5
+
+ '@types/ms@2.1.0': {}
+
+ '@types/nlcst@2.0.3':
+ dependencies:
+ '@types/unist': 3.0.3
+
+ '@types/node@24.12.3':
+ dependencies:
+ undici-types: 7.16.0
+
+ '@types/picomatch@4.0.3': {}
+
+ '@types/sax@1.2.7':
+ dependencies:
+ '@types/node': 24.12.3
+
+ '@types/trusted-types@2.0.7':
+ optional: true
+
+ '@types/unist@2.0.11': {}
+
+ '@types/unist@3.0.3': {}
+
+ '@ungap/structured-clone@1.3.0': {}
+
+ '@ungap/structured-clone@1.3.1': {}
+
+ '@upsetjs/venn.js@2.0.0':
+ optionalDependencies:
+ d3-selection: 3.0.0
+ d3-transition: 3.0.1(d3-selection@3.0.0)
+
+ abbrev@4.0.0: {}
+
+ acorn-jsx@5.3.2(acorn@8.16.0):
+ dependencies:
+ acorn: 8.16.0
+
+ acorn@8.16.0: {}
+
+ ansi-escapes@7.3.0:
+ dependencies:
+ environment: 1.1.0
+
+ anymatch@3.1.3:
+ dependencies:
+ normalize-path: 3.0.0
+ picomatch: 2.3.2
+
+ arg@5.0.2: {}
+
+ argparse@2.0.1: {}
+
+ aria-query@5.3.2: {}
+
+ array-iterate@2.0.1: {}
+
+ astring@1.9.0: {}
+
+ astro-expressive-code@0.42.0(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)):
+ dependencies:
+ astro: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+ rehype-expressive-code: 0.42.0
+
+ astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0):
+ dependencies:
+ '@astrojs/compiler': 4.0.0
+ '@astrojs/internal-helpers': 0.9.1
+ '@astrojs/markdown-remark': 7.1.2
+ '@astrojs/telemetry': 3.3.2
+ '@capsizecss/unpack': 4.0.0
+ '@clack/prompts': 1.4.0
+ '@oslojs/encoding': 1.1.0
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ aria-query: 5.3.2
+ axobject-query: 4.1.0
+ ci-info: 4.4.0
+ clsx: 2.1.1
+ common-ancestor-path: 2.0.0
+ cookie: 1.1.1
+ devalue: 5.8.1
+ diff: 8.0.4
+ dset: 3.1.4
+ es-module-lexer: 2.1.0
+ esbuild: 0.27.7
+ flattie: 1.1.1
+ fontace: 0.4.1
+ get-tsconfig: 5.0.0-beta.4
+ github-slugger: 2.0.0
+ html-escaper: 3.0.3
+ http-cache-semantics: 4.2.0
+ js-yaml: 4.1.1
+ jsonc-parser: 3.3.1
+ magic-string: 0.30.21
+ magicast: 0.5.3
+ mrmime: 2.0.1
+ neotraverse: 0.6.18
+ obug: 2.1.1
+ p-limit: 7.3.0
+ p-queue: 9.3.0
+ package-manager-detector: 1.6.0
+ piccolore: 0.1.3
+ picomatch: 4.0.4
+ rehype: 13.0.2
+ semver: 7.8.1
+ shiki: 4.1.0
+ smol-toml: 1.6.1
+ svgo: 4.0.1
+ tinyclip: 0.1.12
+ tinyexec: 1.2.2
+ tinyglobby: 0.2.16
+ ultrahtml: 1.6.0
+ unifont: 0.7.4
+ unist-util-visit: 5.1.0
+ unstorage: 1.17.5
+ vfile: 6.0.3
+ vite: 7.3.3(@types/node@24.12.3)(jiti@2.6.1)(yaml@2.9.0)
+ vitefu: 1.1.3(vite@7.3.3(@types/node@24.12.3)(jiti@2.6.1)(yaml@2.9.0))
+ xxhash-wasm: 1.1.0
+ yargs-parser: 22.0.0
+ zod: 4.4.3
+ optionalDependencies:
+ sharp: 0.34.5
+ transitivePeerDependencies:
+ - '@azure/app-configuration'
+ - '@azure/cosmos'
+ - '@azure/data-tables'
+ - '@azure/identity'
+ - '@azure/keyvault-secrets'
+ - '@azure/storage-blob'
+ - '@capacitor/preferences'
+ - '@deno/kv'
+ - '@netlify/blobs'
+ - '@planetscale/database'
+ - '@types/node'
+ - '@upstash/redis'
+ - '@vercel/blob'
+ - '@vercel/functions'
+ - '@vercel/kv'
+ - aws4fetch
+ - db0
+ - idb-keyval
+ - ioredis
+ - jiti
+ - less
+ - lightningcss
+ - rollup
+ - sass
+ - sass-embedded
+ - stylus
+ - sugarss
+ - supports-color
+ - terser
+ - tsx
+ - uploadthing
+ - yaml
+
+ axobject-query@4.1.0: {}
+
+ bail@2.0.2: {}
+
+ bcp-47-match@2.0.3: {}
+
+ bcp-47@2.1.0:
+ dependencies:
+ is-alphabetical: 2.0.1
+ is-alphanumerical: 2.0.1
+ is-decimal: 2.0.1
+
+ boolbase@1.0.0: {}
+
+ braces@3.0.3:
+ dependencies:
+ fill-range: 7.1.1
+
+ ccount@2.0.1: {}
+
+ character-entities-html4@2.1.0: {}
+
+ character-entities-legacy@3.0.0: {}
+
+ character-entities@2.0.2: {}
+
+ character-reference-invalid@2.0.1: {}
+
+ chokidar@5.0.0:
+ dependencies:
+ readdirp: 5.0.0
+
+ chownr@3.0.0: {}
+
+ ci-info@4.4.0: {}
+
+ clsx@2.1.1: {}
+
+ collapse-white-space@2.1.0: {}
+
+ comma-separated-tokens@2.0.3: {}
+
+ commander@11.1.0: {}
+
+ commander@7.2.0: {}
+
+ commander@8.3.0: {}
+
+ common-ancestor-path@2.0.0: {}
+
+ confbox@0.1.8: {}
+
+ cookie-es@1.2.3: {}
+
+ cookie@1.1.1: {}
+
+ cose-base@1.0.3:
+ dependencies:
+ layout-base: 1.0.2
+
+ cose-base@2.2.0:
+ dependencies:
+ layout-base: 2.0.1
+
+ crossws@0.3.5:
+ dependencies:
+ uncrypto: 0.1.3
+
+ css-select@5.2.2:
+ dependencies:
+ boolbase: 1.0.0
+ css-what: 6.2.2
+ domhandler: 5.0.3
+ domutils: 3.2.2
+ nth-check: 2.1.1
+
+ css-selector-parser@3.3.0: {}
+
+ css-tree@2.2.1:
+ dependencies:
+ mdn-data: 2.0.28
+ source-map-js: 1.2.1
+
+ css-tree@3.2.1:
+ dependencies:
+ mdn-data: 2.27.1
+ source-map-js: 1.2.1
+
+ css-what@6.2.2: {}
+
+ cssesc@3.0.0: {}
+
+ csso@5.0.5:
+ dependencies:
+ css-tree: 2.2.1
+
+ cytoscape-cose-bilkent@4.1.0(cytoscape@3.33.2):
+ dependencies:
+ cose-base: 1.0.3
+ cytoscape: 3.33.2
+
+ cytoscape-fcose@2.2.0(cytoscape@3.33.2):
+ dependencies:
+ cose-base: 2.2.0
+ cytoscape: 3.33.2
+
+ cytoscape@3.33.2: {}
+
+ d3-array@2.12.1:
+ dependencies:
+ internmap: 1.0.1
+
+ d3-array@3.2.4:
+ dependencies:
+ internmap: 2.0.3
+
+ d3-axis@3.0.0: {}
+
+ d3-brush@3.0.0:
+ dependencies:
+ d3-dispatch: 3.0.1
+ d3-drag: 3.0.0
+ d3-interpolate: 3.0.1
+ d3-selection: 3.0.0
+ d3-transition: 3.0.1(d3-selection@3.0.0)
+
+ d3-chord@3.0.1:
+ dependencies:
+ d3-path: 3.1.0
+
+ d3-color@3.1.0: {}
+
+ d3-contour@4.0.2:
+ dependencies:
+ d3-array: 3.2.4
+
+ d3-delaunay@6.0.4:
+ dependencies:
+ delaunator: 5.1.0
+
+ d3-dispatch@3.0.1: {}
+
+ d3-drag@3.0.0:
+ dependencies:
+ d3-dispatch: 3.0.1
+ d3-selection: 3.0.0
+
+ d3-dsv@3.0.1:
+ dependencies:
+ commander: 7.2.0
+ iconv-lite: 0.6.3
+ rw: 1.3.3
+
+ d3-ease@3.0.1: {}
+
+ d3-fetch@3.0.1:
+ dependencies:
+ d3-dsv: 3.0.1
+
+ d3-force@3.0.0:
+ dependencies:
+ d3-dispatch: 3.0.1
+ d3-quadtree: 3.0.1
+ d3-timer: 3.0.1
+
+ d3-format@3.1.2: {}
+
+ d3-geo@3.1.1:
+ dependencies:
+ d3-array: 3.2.4
+
+ d3-hierarchy@3.1.2: {}
+
+ d3-interpolate@3.0.1:
+ dependencies:
+ d3-color: 3.1.0
+
+ d3-path@1.0.9: {}
+
+ d3-path@3.1.0: {}
+
+ d3-polygon@3.0.1: {}
+
+ d3-quadtree@3.0.1: {}
+
+ d3-random@3.0.1: {}
+
+ d3-sankey@0.12.3:
+ dependencies:
+ d3-array: 2.12.1
+ d3-shape: 1.3.7
+
+ d3-scale-chromatic@3.1.0:
+ dependencies:
+ d3-color: 3.1.0
+ d3-interpolate: 3.0.1
+
+ d3-scale@4.0.2:
+ dependencies:
+ d3-array: 3.2.4
+ d3-format: 3.1.2
+ d3-interpolate: 3.0.1
+ d3-time: 3.1.0
+ d3-time-format: 4.1.0
+
+ d3-selection@3.0.0: {}
+
+ d3-shape@1.3.7:
+ dependencies:
+ d3-path: 1.0.9
+
+ d3-shape@3.2.0:
+ dependencies:
+ d3-path: 3.1.0
+
+ d3-time-format@4.1.0:
+ dependencies:
+ d3-time: 3.1.0
+
+ d3-time@3.1.0:
+ dependencies:
+ d3-array: 3.2.4
+
+ d3-timer@3.0.1: {}
+
+ d3-transition@3.0.1(d3-selection@3.0.0):
+ dependencies:
+ d3-color: 3.1.0
+ d3-dispatch: 3.0.1
+ d3-ease: 3.0.1
+ d3-interpolate: 3.0.1
+ d3-selection: 3.0.0
+ d3-timer: 3.0.1
+
+ d3-zoom@3.0.0:
+ dependencies:
+ d3-dispatch: 3.0.1
+ d3-drag: 3.0.0
+ d3-interpolate: 3.0.1
+ d3-selection: 3.0.0
+ d3-transition: 3.0.1(d3-selection@3.0.0)
+
+ d3@7.9.0:
+ dependencies:
+ d3-array: 3.2.4
+ d3-axis: 3.0.0
+ d3-brush: 3.0.0
+ d3-chord: 3.0.1
+ d3-color: 3.1.0
+ d3-contour: 4.0.2
+ d3-delaunay: 6.0.4
+ d3-dispatch: 3.0.1
+ d3-drag: 3.0.0
+ d3-dsv: 3.0.1
+ d3-ease: 3.0.1
+ d3-fetch: 3.0.1
+ d3-force: 3.0.0
+ d3-format: 3.1.2
+ d3-geo: 3.1.1
+ d3-hierarchy: 3.1.2
+ d3-interpolate: 3.0.1
+ d3-path: 3.1.0
+ d3-polygon: 3.0.1
+ d3-quadtree: 3.0.1
+ d3-random: 3.0.1
+ d3-scale: 4.0.2
+ d3-scale-chromatic: 3.1.0
+ d3-selection: 3.0.0
+ d3-shape: 3.2.0
+ d3-time: 3.1.0
+ d3-time-format: 4.1.0
+ d3-timer: 3.0.1
+ d3-transition: 3.0.1(d3-selection@3.0.0)
+ d3-zoom: 3.0.0
+
+ dagre-d3-es@7.0.14:
+ dependencies:
+ d3: 7.9.0
+ lodash-es: 4.18.1
+
+ dayjs@1.11.20: {}
+
+ debug@4.4.3:
+ dependencies:
+ ms: 2.1.3
+
+ decode-named-character-reference@1.3.0:
+ dependencies:
+ character-entities: 2.0.2
+
+ defu@6.1.7: {}
+
+ delaunator@5.1.0:
+ dependencies:
+ robust-predicates: 3.0.3
+
+ dequal@2.0.3: {}
+
+ destr@2.0.5: {}
+
+ detect-libc@2.1.2: {}
+
+ devalue@5.8.1: {}
+
+ devlop@1.1.0:
+ dependencies:
+ dequal: 2.0.3
+
+ diff@8.0.4: {}
+
+ direction@2.0.1: {}
+
+ dom-serializer@2.0.0:
+ dependencies:
+ domelementtype: 2.3.0
+ domhandler: 5.0.3
+ entities: 4.5.0
+
+ domelementtype@2.3.0: {}
+
+ domhandler@5.0.3:
+ dependencies:
+ domelementtype: 2.3.0
+
+ dompurify@3.3.3:
+ optionalDependencies:
+ '@types/trusted-types': 2.0.7
+
+ domutils@3.2.2:
+ dependencies:
+ dom-serializer: 2.0.0
+ domelementtype: 2.3.0
+ domhandler: 5.0.3
+
+ dset@3.1.4: {}
+
+ entities@4.5.0: {}
+
+ entities@6.0.1: {}
+
+ env-paths@2.2.1: {}
+
+ environment@1.1.0: {}
+
+ es-module-lexer@2.1.0: {}
+
+ es-toolkit@1.46.1: {}
+
+ esast-util-from-estree@2.0.0:
+ dependencies:
+ '@types/estree-jsx': 1.0.5
+ devlop: 1.1.0
+ estree-util-visit: 2.0.0
+ unist-util-position-from-estree: 2.0.0
+
+ esast-util-from-js@2.0.1:
+ dependencies:
+ '@types/estree-jsx': 1.0.5
+ acorn: 8.16.0
+ esast-util-from-estree: 2.0.0
+ vfile-message: 4.0.3
+
+ esbuild@0.27.7:
+ optionalDependencies:
+ '@esbuild/aix-ppc64': 0.27.7
+ '@esbuild/android-arm': 0.27.7
+ '@esbuild/android-arm64': 0.27.7
+ '@esbuild/android-x64': 0.27.7
+ '@esbuild/darwin-arm64': 0.27.7
+ '@esbuild/darwin-x64': 0.27.7
+ '@esbuild/freebsd-arm64': 0.27.7
+ '@esbuild/freebsd-x64': 0.27.7
+ '@esbuild/linux-arm': 0.27.7
+ '@esbuild/linux-arm64': 0.27.7
+ '@esbuild/linux-ia32': 0.27.7
+ '@esbuild/linux-loong64': 0.27.7
+ '@esbuild/linux-mips64el': 0.27.7
+ '@esbuild/linux-ppc64': 0.27.7
+ '@esbuild/linux-riscv64': 0.27.7
+ '@esbuild/linux-s390x': 0.27.7
+ '@esbuild/linux-x64': 0.27.7
+ '@esbuild/netbsd-arm64': 0.27.7
+ '@esbuild/netbsd-x64': 0.27.7
+ '@esbuild/openbsd-arm64': 0.27.7
+ '@esbuild/openbsd-x64': 0.27.7
+ '@esbuild/openharmony-arm64': 0.27.7
+ '@esbuild/sunos-x64': 0.27.7
+ '@esbuild/win32-arm64': 0.27.7
+ '@esbuild/win32-ia32': 0.27.7
+ '@esbuild/win32-x64': 0.27.7
+
+ escape-string-regexp@5.0.0: {}
+
+ estree-util-attach-comments@3.0.0:
+ dependencies:
+ '@types/estree': 1.0.8
+
+ estree-util-build-jsx@3.0.1:
+ dependencies:
+ '@types/estree-jsx': 1.0.5
+ devlop: 1.1.0
+ estree-util-is-identifier-name: 3.0.0
+ estree-walker: 3.0.3
+
+ estree-util-is-identifier-name@3.0.0: {}
+
+ estree-util-scope@1.0.0:
+ dependencies:
+ '@types/estree': 1.0.8
+ devlop: 1.1.0
+
+ estree-util-to-js@2.0.0:
+ dependencies:
+ '@types/estree-jsx': 1.0.5
+ astring: 1.9.0
+ source-map: 0.7.6
+
+ estree-util-visit@2.0.0:
+ dependencies:
+ '@types/estree-jsx': 1.0.5
+ '@types/unist': 3.0.3
+
+ estree-walker@2.0.2: {}
+
+ estree-walker@3.0.3:
+ dependencies:
+ '@types/estree': 1.0.8
+
+ eventemitter3@5.0.4: {}
+
+ exponential-backoff@3.1.3: {}
+
+ expressive-code@0.42.0:
+ dependencies:
+ '@expressive-code/core': 0.42.0
+ '@expressive-code/plugin-frames': 0.42.0
+ '@expressive-code/plugin-shiki': 0.42.0
+ '@expressive-code/plugin-text-markers': 0.42.0
+
+ extend@3.0.2: {}
+
+ fast-string-truncated-width@3.0.3: {}
+
+ fast-string-width@3.0.2:
+ dependencies:
+ fast-string-truncated-width: 3.0.3
+
+ fast-wrap-ansi@0.2.2:
+ dependencies:
+ fast-string-width: 3.0.2
+
+ fdir@6.5.0(picomatch@4.0.4):
+ optionalDependencies:
+ picomatch: 4.0.4
+
+ fill-range@7.1.1:
+ dependencies:
+ to-regex-range: 5.0.1
+
+ flattie@1.1.1: {}
+
+ fontace@0.4.1:
+ dependencies:
+ fontkitten: 1.0.3
+
+ fontkitten@1.0.3:
+ dependencies:
+ tiny-inflate: 1.0.3
+
+ fsevents@2.3.3:
+ optional: true
+
+ get-tsconfig@5.0.0-beta.4:
+ dependencies:
+ resolve-pkg-maps: 1.0.0
+
+ github-slugger@2.0.0: {}
+
+ graceful-fs@4.2.11: {}
+
+ h3@1.15.11:
+ dependencies:
+ cookie-es: 1.2.3
+ crossws: 0.3.5
+ defu: 6.1.7
+ destr: 2.0.5
+ iron-webcrypto: 1.2.1
+ node-mock-http: 1.0.4
+ radix3: 1.1.2
+ ufo: 1.6.4
+ uncrypto: 0.1.3
+
+ hachure-fill@0.5.2: {}
+
+ has-flag@5.0.1: {}
+
+ hast-util-embedded@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-is-element: 3.0.0
+
+ hast-util-format@1.1.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-embedded: 3.0.0
+ hast-util-minify-whitespace: 1.0.1
+ hast-util-phrasing: 3.0.1
+ hast-util-whitespace: 3.0.0
+ html-whitespace-sensitive-tag-names: 3.0.1
+ unist-util-visit-parents: 6.0.2
+
+ hast-util-from-html@2.0.3:
+ dependencies:
+ '@types/hast': 3.0.4
+ devlop: 1.1.0
+ hast-util-from-parse5: 8.0.3
+ parse5: 7.3.0
+ vfile: 6.0.3
+ vfile-message: 4.0.3
+
+ hast-util-from-parse5@8.0.3:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ devlop: 1.1.0
+ hastscript: 9.0.1
+ property-information: 7.1.0
+ vfile: 6.0.3
+ vfile-location: 5.0.3
+ web-namespaces: 2.0.1
+
+ hast-util-has-property@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-is-body-ok-link@3.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-is-element@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-minify-whitespace@1.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-embedded: 3.0.0
+ hast-util-is-element: 3.0.0
+ hast-util-whitespace: 3.0.0
+ unist-util-is: 6.0.1
+
+ hast-util-parse-selector@4.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-phrasing@3.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-embedded: 3.0.0
+ hast-util-has-property: 3.0.0
+ hast-util-is-body-ok-link: 3.0.1
+ hast-util-is-element: 3.0.0
+
+ hast-util-raw@9.1.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ '@ungap/structured-clone': 1.3.0
+ hast-util-from-parse5: 8.0.3
+ hast-util-to-parse5: 8.0.1
+ html-void-elements: 3.0.0
+ mdast-util-to-hast: 13.2.1
+ parse5: 7.3.0
+ unist-util-position: 5.0.0
+ unist-util-visit: 5.1.0
+ vfile: 6.0.3
+ web-namespaces: 2.0.1
+ zwitch: 2.0.4
+
+ hast-util-select@6.0.4:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ bcp-47-match: 2.0.3
+ comma-separated-tokens: 2.0.3
+ css-selector-parser: 3.3.0
+ devlop: 1.1.0
+ direction: 2.0.1
+ hast-util-has-property: 3.0.0
+ hast-util-to-string: 3.0.1
+ hast-util-whitespace: 3.0.0
+ nth-check: 2.1.1
+ property-information: 7.1.0
+ space-separated-tokens: 2.0.2
+ unist-util-visit: 5.1.0
+ zwitch: 2.0.4
+
+ hast-util-to-estree@3.1.3:
+ dependencies:
+ '@types/estree': 1.0.8
+ '@types/estree-jsx': 1.0.5
+ '@types/hast': 3.0.4
+ comma-separated-tokens: 2.0.3
+ devlop: 1.1.0
+ estree-util-attach-comments: 3.0.0
+ estree-util-is-identifier-name: 3.0.0
+ hast-util-whitespace: 3.0.0
+ mdast-util-mdx-expression: 2.0.1
+ mdast-util-mdx-jsx: 3.2.0
+ mdast-util-mdxjs-esm: 2.0.1
+ property-information: 7.1.0
+ space-separated-tokens: 2.0.2
+ style-to-js: 1.1.21
+ unist-util-position: 5.0.0
+ zwitch: 2.0.4
+ transitivePeerDependencies:
+ - supports-color
+
+ hast-util-to-html@9.0.5:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ ccount: 2.0.1
+ comma-separated-tokens: 2.0.3
+ hast-util-whitespace: 3.0.0
+ html-void-elements: 3.0.0
+ mdast-util-to-hast: 13.2.1
+ property-information: 7.1.0
+ space-separated-tokens: 2.0.2
+ stringify-entities: 4.0.4
+ zwitch: 2.0.4
+
+ hast-util-to-jsx-runtime@2.3.6:
+ dependencies:
+ '@types/estree': 1.0.8
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ comma-separated-tokens: 2.0.3
+ devlop: 1.1.0
+ estree-util-is-identifier-name: 3.0.0
+ hast-util-whitespace: 3.0.0
+ mdast-util-mdx-expression: 2.0.1
+ mdast-util-mdx-jsx: 3.2.0
+ mdast-util-mdxjs-esm: 2.0.1
+ property-information: 7.1.0
+ space-separated-tokens: 2.0.2
+ style-to-js: 1.1.21
+ unist-util-position: 5.0.0
+ vfile-message: 4.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ hast-util-to-mdast@10.1.2:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ '@ungap/structured-clone': 1.3.1
+ hast-util-phrasing: 3.0.1
+ hast-util-to-html: 9.0.5
+ hast-util-to-text: 4.0.2
+ hast-util-whitespace: 3.0.0
+ mdast-util-phrasing: 4.1.0
+ mdast-util-to-hast: 13.2.1
+ mdast-util-to-string: 4.0.0
+ rehype-minify-whitespace: 6.0.2
+ trim-trailing-lines: 2.1.0
+ unist-util-position: 5.0.0
+ unist-util-visit: 5.1.0
+
+ hast-util-to-parse5@8.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ comma-separated-tokens: 2.0.3
+ devlop: 1.1.0
+ property-information: 7.1.0
+ space-separated-tokens: 2.0.2
+ web-namespaces: 2.0.1
+ zwitch: 2.0.4
+
+ hast-util-to-string@3.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-to-text@4.0.2:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ hast-util-is-element: 3.0.0
+ unist-util-find-after: 5.0.0
+
+ hast-util-whitespace@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hastscript@9.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ comma-separated-tokens: 2.0.3
+ hast-util-parse-selector: 4.0.0
+ property-information: 7.1.0
+ space-separated-tokens: 2.0.2
+
+ html-escaper@3.0.3: {}
+
+ html-void-elements@3.0.0: {}
+
+ html-whitespace-sensitive-tag-names@3.0.1: {}
+
+ http-cache-semantics@4.2.0: {}
+
+ i18next@26.1.0: {}
+
+ iconv-lite@0.6.3:
+ dependencies:
+ safer-buffer: 2.1.2
+
+ inline-style-parser@0.2.7: {}
+
+ internmap@1.0.1: {}
+
+ internmap@2.0.3: {}
+
+ iron-webcrypto@1.2.1: {}
+
+ is-absolute-url@4.0.1: {}
+
+ is-absolute-url@5.0.0: {}
+
+ is-alphabetical@2.0.1: {}
+
+ is-alphanumerical@2.0.1:
+ dependencies:
+ is-alphabetical: 2.0.1
+ is-decimal: 2.0.1
+
+ is-decimal@2.0.1: {}
+
+ is-docker@3.0.0: {}
+
+ is-docker@4.0.0: {}
+
+ is-hexadecimal@2.0.1: {}
+
+ is-inside-container@1.0.0:
+ dependencies:
+ is-docker: 3.0.0
+
+ is-number@7.0.0: {}
+
+ is-plain-obj@4.1.0: {}
+
+ is-wsl@3.1.1:
+ dependencies:
+ is-inside-container: 1.0.0
+
+ isexe@4.0.0: {}
+
+ jiti@2.6.1:
+ optional: true
+
+ js-yaml@4.1.1:
+ dependencies:
+ argparse: 2.0.1
+
+ jsonc-parser@3.3.1: {}
+
+ katex@0.16.45:
+ dependencies:
+ commander: 8.3.0
+
+ khroma@2.1.0: {}
+
+ klona@2.0.6: {}
+
+ layout-base@1.0.2: {}
+
+ layout-base@2.0.1: {}
+
+ lodash-es@4.18.1: {}
+
+ longest-streak@3.1.0: {}
+
+ lru-cache@11.5.0: {}
+
+ magic-string@0.30.21:
+ dependencies:
+ '@jridgewell/sourcemap-codec': 1.5.5
+
+ magicast@0.5.3:
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@babel/types': 7.29.0
+ source-map-js: 1.2.1
+
+ markdown-extensions@2.0.0: {}
+
+ markdown-table@3.0.4: {}
+
+ marked@16.4.2: {}
+
+ mdast-util-definitions@6.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ '@types/unist': 3.0.3
+ unist-util-visit: 5.1.0
+
+ mdast-util-directive@3.1.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ '@types/unist': 3.0.3
+ ccount: 2.0.1
+ devlop: 1.1.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ parse-entities: 4.0.2
+ stringify-entities: 4.0.4
+ unist-util-visit-parents: 6.0.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-find-and-replace@3.0.2:
+ dependencies:
+ '@types/mdast': 4.0.4
+ escape-string-regexp: 5.0.0
+ unist-util-is: 6.0.1
+ unist-util-visit-parents: 6.0.2
+
+ mdast-util-from-markdown@2.0.3:
+ dependencies:
+ '@types/mdast': 4.0.4
+ '@types/unist': 3.0.3
+ decode-named-character-reference: 1.3.0
+ devlop: 1.1.0
+ mdast-util-to-string: 4.0.0
+ micromark: 4.0.2
+ micromark-util-decode-numeric-character-reference: 2.0.2
+ micromark-util-decode-string: 2.0.1
+ micromark-util-normalize-identifier: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ unist-util-stringify-position: 4.0.0
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm-autolink-literal@2.0.1:
+ dependencies:
+ '@types/mdast': 4.0.4
+ ccount: 2.0.1
+ devlop: 1.1.0
+ mdast-util-find-and-replace: 3.0.2
+ micromark-util-character: 2.1.1
+
+ mdast-util-gfm-footnote@2.1.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ micromark-util-normalize-identifier: 2.0.1
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm-strikethrough@2.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm-table@2.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ markdown-table: 3.0.4
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm-task-list-item@2.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm@3.1.0:
+ dependencies:
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-gfm-autolink-literal: 2.0.1
+ mdast-util-gfm-footnote: 2.1.0
+ mdast-util-gfm-strikethrough: 2.0.0
+ mdast-util-gfm-table: 2.0.0
+ mdast-util-gfm-task-list-item: 2.0.0
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-mdx-expression@2.0.1:
+ dependencies:
+ '@types/estree-jsx': 1.0.5
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-mdx-jsx@3.2.0:
+ dependencies:
+ '@types/estree-jsx': 1.0.5
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ '@types/unist': 3.0.3
+ ccount: 2.0.1
+ devlop: 1.1.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ parse-entities: 4.0.2
+ stringify-entities: 4.0.4
+ unist-util-stringify-position: 4.0.0
+ vfile-message: 4.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-mdx@3.0.0:
+ dependencies:
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-mdx-expression: 2.0.1
+ mdast-util-mdx-jsx: 3.2.0
+ mdast-util-mdxjs-esm: 2.0.1
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-mdxjs-esm@2.0.1:
+ dependencies:
+ '@types/estree-jsx': 1.0.5
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-phrasing@4.1.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ unist-util-is: 6.0.1
+
+ mdast-util-to-hast@13.2.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ '@ungap/structured-clone': 1.3.0
+ devlop: 1.1.0
+ micromark-util-sanitize-uri: 2.0.1
+ trim-lines: 3.0.1
+ unist-util-position: 5.0.0
+ unist-util-visit: 5.1.0
+ vfile: 6.0.3
+
+ mdast-util-to-markdown@2.1.2:
+ dependencies:
+ '@types/mdast': 4.0.4
+ '@types/unist': 3.0.3
+ longest-streak: 3.1.0
+ mdast-util-phrasing: 4.1.0
+ mdast-util-to-string: 4.0.0
+ micromark-util-classify-character: 2.0.1
+ micromark-util-decode-string: 2.0.1
+ unist-util-visit: 5.1.0
+ zwitch: 2.0.4
+
+ mdast-util-to-string@4.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+
+ mdn-data@2.0.28: {}
+
+ mdn-data@2.27.1: {}
+
+ mermaid@11.15.0:
+ dependencies:
+ '@braintree/sanitize-url': 7.1.2
+ '@iconify/utils': 3.1.0
+ '@mermaid-js/parser': 1.1.1
+ '@types/d3': 7.4.3
+ '@upsetjs/venn.js': 2.0.0
+ cytoscape: 3.33.2
+ cytoscape-cose-bilkent: 4.1.0(cytoscape@3.33.2)
+ cytoscape-fcose: 2.2.0(cytoscape@3.33.2)
+ d3: 7.9.0
+ d3-sankey: 0.12.3
+ dagre-d3-es: 7.0.14
+ dayjs: 1.11.20
+ dompurify: 3.3.3
+ es-toolkit: 1.46.1
+ katex: 0.16.45
+ khroma: 2.1.0
+ marked: 16.4.2
+ roughjs: 4.6.6
+ stylis: 4.3.6
+ ts-dedent: 2.2.0
+ uuid: 11.1.0
+
+ micromark-core-commonmark@2.0.3:
+ dependencies:
+ decode-named-character-reference: 1.3.0
+ devlop: 1.1.0
+ micromark-factory-destination: 2.0.1
+ micromark-factory-label: 2.0.1
+ micromark-factory-space: 2.0.1
+ micromark-factory-title: 2.0.1
+ micromark-factory-whitespace: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-chunked: 2.0.1
+ micromark-util-classify-character: 2.0.1
+ micromark-util-html-tag-name: 2.0.1
+ micromark-util-normalize-identifier: 2.0.1
+ micromark-util-resolve-all: 2.0.1
+ micromark-util-subtokenize: 2.1.0
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-directive@4.0.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-factory-space: 2.0.1
+ micromark-factory-whitespace: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ parse-entities: 4.0.2
+
+ micromark-extension-gfm-autolink-literal@2.1.0:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-sanitize-uri: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-footnote@2.1.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-core-commonmark: 2.0.3
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-normalize-identifier: 2.0.1
+ micromark-util-sanitize-uri: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-strikethrough@2.1.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-util-chunked: 2.0.1
+ micromark-util-classify-character: 2.0.1
+ micromark-util-resolve-all: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-table@2.1.1:
+ dependencies:
+ devlop: 1.1.0
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-tagfilter@2.0.0:
+ dependencies:
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-task-list-item@2.1.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm@3.0.0:
+ dependencies:
+ micromark-extension-gfm-autolink-literal: 2.1.0
+ micromark-extension-gfm-footnote: 2.1.0
+ micromark-extension-gfm-strikethrough: 2.1.0
+ micromark-extension-gfm-table: 2.1.1
+ micromark-extension-gfm-tagfilter: 2.0.0
+ micromark-extension-gfm-task-list-item: 2.1.0
+ micromark-util-combine-extensions: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-mdx-expression@3.0.1:
+ dependencies:
+ '@types/estree': 1.0.8
+ devlop: 1.1.0
+ micromark-factory-mdx-expression: 2.0.3
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-events-to-acorn: 2.0.3
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-mdx-jsx@3.0.2:
+ dependencies:
+ '@types/estree': 1.0.8
+ devlop: 1.1.0
+ estree-util-is-identifier-name: 3.0.0
+ micromark-factory-mdx-expression: 2.0.3
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-events-to-acorn: 2.0.3
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ vfile-message: 4.0.3
+
+ micromark-extension-mdx-md@2.0.0:
+ dependencies:
+ micromark-util-types: 2.0.2
+
+ micromark-extension-mdxjs-esm@3.0.0:
+ dependencies:
+ '@types/estree': 1.0.8
+ devlop: 1.1.0
+ micromark-core-commonmark: 2.0.3
+ micromark-util-character: 2.1.1
+ micromark-util-events-to-acorn: 2.0.3
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ unist-util-position-from-estree: 2.0.0
+ vfile-message: 4.0.3
+
+ micromark-extension-mdxjs@3.0.0:
+ dependencies:
+ acorn: 8.16.0
+ acorn-jsx: 5.3.2(acorn@8.16.0)
+ micromark-extension-mdx-expression: 3.0.1
+ micromark-extension-mdx-jsx: 3.0.2
+ micromark-extension-mdx-md: 2.0.0
+ micromark-extension-mdxjs-esm: 3.0.0
+ micromark-util-combine-extensions: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-destination@2.0.1:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-label@2.0.1:
+ dependencies:
+ devlop: 1.1.0
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-mdx-expression@2.0.3:
+ dependencies:
+ '@types/estree': 1.0.8
+ devlop: 1.1.0
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-events-to-acorn: 2.0.3
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ unist-util-position-from-estree: 2.0.0
+ vfile-message: 4.0.3
+
+ micromark-factory-space@2.0.1:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-title@2.0.1:
+ dependencies:
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-whitespace@2.0.1:
+ dependencies:
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-character@2.1.1:
+ dependencies:
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-chunked@2.0.1:
+ dependencies:
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-classify-character@2.0.1:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-combine-extensions@2.0.1:
+ dependencies:
+ micromark-util-chunked: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-decode-numeric-character-reference@2.0.2:
+ dependencies:
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-decode-string@2.0.1:
+ dependencies:
+ decode-named-character-reference: 1.3.0
+ micromark-util-character: 2.1.1
+ micromark-util-decode-numeric-character-reference: 2.0.2
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-encode@2.0.1: {}
+
+ micromark-util-events-to-acorn@2.0.3:
+ dependencies:
+ '@types/estree': 1.0.8
+ '@types/unist': 3.0.3
+ devlop: 1.1.0
+ estree-util-visit: 2.0.0
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ vfile-message: 4.0.3
+
+ micromark-util-html-tag-name@2.0.1: {}
+
+ micromark-util-normalize-identifier@2.0.1:
+ dependencies:
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-resolve-all@2.0.1:
+ dependencies:
+ micromark-util-types: 2.0.2
+
+ micromark-util-sanitize-uri@2.0.1:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-encode: 2.0.1
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-subtokenize@2.1.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-util-chunked: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-symbol@2.0.1: {}
+
+ micromark-util-types@2.0.2: {}
+
+ micromark@4.0.2:
+ dependencies:
+ '@types/debug': 4.1.13
+ debug: 4.4.3
+ decode-named-character-reference: 1.3.0
+ devlop: 1.1.0
+ micromark-core-commonmark: 2.0.3
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-chunked: 2.0.1
+ micromark-util-combine-extensions: 2.0.1
+ micromark-util-decode-numeric-character-reference: 2.0.2
+ micromark-util-encode: 2.0.1
+ micromark-util-normalize-identifier: 2.0.1
+ micromark-util-resolve-all: 2.0.1
+ micromark-util-sanitize-uri: 2.0.1
+ micromark-util-subtokenize: 2.1.0
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ transitivePeerDependencies:
+ - supports-color
+
+ micromatch@4.0.8:
+ dependencies:
+ braces: 3.0.3
+ picomatch: 2.3.2
+
+ minipass@7.1.3: {}
+
+ minizlib@3.1.0:
+ dependencies:
+ minipass: 7.1.3
+
+ mlly@1.8.2:
+ dependencies:
+ acorn: 8.16.0
+ pathe: 2.0.3
+ pkg-types: 1.3.1
+ ufo: 1.6.3
+
+ mrmime@2.0.1: {}
+
+ ms@2.1.3: {}
+
+ nanoid@3.3.12: {}
+
+ neotraverse@0.6.18: {}
+
+ nlcst-to-string@4.0.0:
+ dependencies:
+ '@types/nlcst': 2.0.3
+
+ node-addon-api@8.8.0: {}
+
+ node-fetch-native@1.6.7: {}
+
+ node-gyp@12.3.0:
+ dependencies:
+ env-paths: 2.2.1
+ exponential-backoff: 3.1.3
+ graceful-fs: 4.2.11
+ nopt: 9.0.0
+ proc-log: 6.1.0
+ semver: 7.8.1
+ tar: 7.5.15
+ tinyglobby: 0.2.16
+ undici: 6.25.0
+ which: 6.0.1
+
+ node-mock-http@1.0.4: {}
+
+ nopt@9.0.0:
+ dependencies:
+ abbrev: 4.0.0
+
+ normalize-path@3.0.0: {}
+
+ nth-check@2.1.1:
+ dependencies:
+ boolbase: 1.0.0
+
+ obug@2.1.1: {}
+
+ ofetch@1.5.1:
+ dependencies:
+ destr: 2.0.5
+ node-fetch-native: 1.6.7
+ ufo: 1.6.4
+
+ ohash@2.0.11: {}
+
+ oniguruma-parser@0.12.1: {}
+
+ oniguruma-parser@0.12.2: {}
+
+ oniguruma-to-es@4.3.5:
+ dependencies:
+ oniguruma-parser: 0.12.1
+ regex: 6.1.0
+ regex-recursion: 6.0.2
+
+ oniguruma-to-es@4.3.6:
+ dependencies:
+ oniguruma-parser: 0.12.2
+ regex: 6.1.0
+ regex-recursion: 6.0.2
+
+ p-limit@7.3.0:
+ dependencies:
+ yocto-queue: 1.2.2
+
+ p-queue@9.3.0:
+ dependencies:
+ eventemitter3: 5.0.4
+ p-timeout: 7.0.1
+
+ p-timeout@7.0.1: {}
+
+ package-manager-detector@1.6.0: {}
+
+ pagefind@1.5.2:
+ optionalDependencies:
+ '@pagefind/darwin-arm64': 1.5.2
+ '@pagefind/darwin-x64': 1.5.2
+ '@pagefind/freebsd-x64': 1.5.2
+ '@pagefind/linux-arm64': 1.5.2
+ '@pagefind/linux-x64': 1.5.2
+ '@pagefind/windows-arm64': 1.5.2
+ '@pagefind/windows-x64': 1.5.2
+
+ parse-entities@4.0.2:
+ dependencies:
+ '@types/unist': 2.0.11
+ character-entities-legacy: 3.0.0
+ character-reference-invalid: 2.0.1
+ decode-named-character-reference: 1.3.0
+ is-alphanumerical: 2.0.1
+ is-decimal: 2.0.1
+ is-hexadecimal: 2.0.1
+
+ parse-latin@7.0.0:
+ dependencies:
+ '@types/nlcst': 2.0.3
+ '@types/unist': 3.0.3
+ nlcst-to-string: 4.0.0
+ unist-util-modify-children: 4.0.0
+ unist-util-visit-children: 3.0.0
+ vfile: 6.0.3
+
+ parse5@7.3.0:
+ dependencies:
+ entities: 6.0.1
+
+ path-data-parser@0.1.0: {}
+
+ pathe@2.0.3: {}
+
+ piccolore@0.1.3: {}
+
+ picocolors@1.1.1: {}
+
+ picomatch@2.3.2: {}
+
+ picomatch@4.0.4: {}
+
+ pkg-types@1.3.1:
+ dependencies:
+ confbox: 0.1.8
+ mlly: 1.8.2
+ pathe: 2.0.3
+
+ points-on-curve@0.2.0: {}
+
+ points-on-path@0.2.1:
+ dependencies:
+ path-data-parser: 0.1.0
+ points-on-curve: 0.2.0
+
+ postcss-nested@6.2.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-selector-parser: 6.1.2
+
+ postcss-selector-parser@6.1.2:
+ dependencies:
+ cssesc: 3.0.0
+ util-deprecate: 1.0.2
+
+ postcss@8.5.14:
+ dependencies:
+ nanoid: 3.3.12
+ picocolors: 1.1.1
+ source-map-js: 1.2.1
+
+ postcss@8.5.15:
+ dependencies:
+ nanoid: 3.3.12
+ picocolors: 1.1.1
+ source-map-js: 1.2.1
+
+ prismjs@1.30.0: {}
+
+ proc-log@6.1.0: {}
+
+ property-information@7.1.0: {}
+
+ radix3@1.1.2: {}
+
+ readdirp@5.0.0: {}
+
+ recma-build-jsx@1.0.0:
+ dependencies:
+ '@types/estree': 1.0.8
+ estree-util-build-jsx: 3.0.1
+ vfile: 6.0.3
+
+ recma-jsx@1.0.1(acorn@8.16.0):
+ dependencies:
+ acorn: 8.16.0
+ acorn-jsx: 5.3.2(acorn@8.16.0)
+ estree-util-to-js: 2.0.0
+ recma-parse: 1.0.0
+ recma-stringify: 1.0.0
+ unified: 11.0.5
+
+ recma-parse@1.0.0:
+ dependencies:
+ '@types/estree': 1.0.8
+ esast-util-from-js: 2.0.1
+ unified: 11.0.5
+ vfile: 6.0.3
+
+ recma-stringify@1.0.0:
+ dependencies:
+ '@types/estree': 1.0.8
+ estree-util-to-js: 2.0.0
+ unified: 11.0.5
+ vfile: 6.0.3
+
+ regex-recursion@6.0.2:
+ dependencies:
+ regex-utilities: 2.3.0
+
+ regex-utilities@2.3.0: {}
+
+ regex@6.1.0:
+ dependencies:
+ regex-utilities: 2.3.0
+
+ rehype-expressive-code@0.42.0:
+ dependencies:
+ expressive-code: 0.42.0
+
+ rehype-external-links@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@ungap/structured-clone': 1.3.0
+ hast-util-is-element: 3.0.0
+ is-absolute-url: 4.0.1
+ space-separated-tokens: 2.0.2
+ unist-util-visit: 5.1.0
+
+ rehype-format@5.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-format: 1.1.0
+
+ rehype-minify-whitespace@6.0.2:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-minify-whitespace: 1.0.1
+
+ rehype-parse@9.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-from-html: 2.0.3
+ unified: 11.0.5
+
+ rehype-raw@7.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-raw: 9.1.0
+ vfile: 6.0.3
+
+ rehype-recma@1.0.0:
+ dependencies:
+ '@types/estree': 1.0.8
+ '@types/hast': 3.0.4
+ hast-util-to-estree: 3.1.3
+ transitivePeerDependencies:
+ - supports-color
+
+ rehype-remark@10.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ hast-util-to-mdast: 10.1.2
+ unified: 11.0.5
+ vfile: 6.0.3
+
+ rehype-stringify@10.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-to-html: 9.0.5
+ unified: 11.0.5
+
+ rehype@13.0.2:
+ dependencies:
+ '@types/hast': 3.0.4
+ rehype-parse: 9.0.1
+ rehype-stringify: 10.0.1
+ unified: 11.0.5
+
+ remark-directive@4.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ mdast-util-directive: 3.1.0
+ micromark-extension-directive: 4.0.0
+ unified: 11.0.5
+ transitivePeerDependencies:
+ - supports-color
+
+ remark-gfm@4.0.1:
+ dependencies:
+ '@types/mdast': 4.0.4
+ mdast-util-gfm: 3.1.0
+ micromark-extension-gfm: 3.0.0
+ remark-parse: 11.0.0
+ remark-stringify: 11.0.0
+ unified: 11.0.5
+ transitivePeerDependencies:
+ - supports-color
+
+ remark-mdx@3.1.1:
+ dependencies:
+ mdast-util-mdx: 3.0.0
+ micromark-extension-mdxjs: 3.0.0
+ transitivePeerDependencies:
+ - supports-color
+
+ remark-parse@11.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ mdast-util-from-markdown: 2.0.3
+ micromark-util-types: 2.0.2
+ unified: 11.0.5
+ transitivePeerDependencies:
+ - supports-color
+
+ remark-rehype@11.1.2:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ mdast-util-to-hast: 13.2.1
+ unified: 11.0.5
+ vfile: 6.0.3
+
+ remark-smartypants@3.0.2:
+ dependencies:
+ retext: 9.0.0
+ retext-smartypants: 6.2.0
+ unified: 11.0.5
+ unist-util-visit: 5.1.0
+
+ remark-stringify@11.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ mdast-util-to-markdown: 2.1.2
+ unified: 11.0.5
+
+ resolve-pkg-maps@1.0.0: {}
+
+ retext-latin@4.0.0:
+ dependencies:
+ '@types/nlcst': 2.0.3
+ parse-latin: 7.0.0
+ unified: 11.0.5
+
+ retext-smartypants@6.2.0:
+ dependencies:
+ '@types/nlcst': 2.0.3
+ nlcst-to-string: 4.0.0
+ unist-util-visit: 5.1.0
+
+ retext-stringify@4.0.0:
+ dependencies:
+ '@types/nlcst': 2.0.3
+ nlcst-to-string: 4.0.0
+ unified: 11.0.5
+
+ retext@9.0.0:
+ dependencies:
+ '@types/nlcst': 2.0.3
+ retext-latin: 4.0.0
+ retext-stringify: 4.0.0
+ unified: 11.0.5
+
+ robust-predicates@3.0.3: {}
+
+ rollup@4.60.4:
+ dependencies:
+ '@types/estree': 1.0.8
+ optionalDependencies:
+ '@rollup/rollup-android-arm-eabi': 4.60.4
+ '@rollup/rollup-android-arm64': 4.60.4
+ '@rollup/rollup-darwin-arm64': 4.60.4
+ '@rollup/rollup-darwin-x64': 4.60.4
+ '@rollup/rollup-freebsd-arm64': 4.60.4
+ '@rollup/rollup-freebsd-x64': 4.60.4
+ '@rollup/rollup-linux-arm-gnueabihf': 4.60.4
+ '@rollup/rollup-linux-arm-musleabihf': 4.60.4
+ '@rollup/rollup-linux-arm64-gnu': 4.60.4
+ '@rollup/rollup-linux-arm64-musl': 4.60.4
+ '@rollup/rollup-linux-loong64-gnu': 4.60.4
+ '@rollup/rollup-linux-loong64-musl': 4.60.4
+ '@rollup/rollup-linux-ppc64-gnu': 4.60.4
+ '@rollup/rollup-linux-ppc64-musl': 4.60.4
+ '@rollup/rollup-linux-riscv64-gnu': 4.60.4
+ '@rollup/rollup-linux-riscv64-musl': 4.60.4
+ '@rollup/rollup-linux-s390x-gnu': 4.60.4
+ '@rollup/rollup-linux-x64-gnu': 4.60.4
+ '@rollup/rollup-linux-x64-musl': 4.60.4
+ '@rollup/rollup-openbsd-x64': 4.60.4
+ '@rollup/rollup-openharmony-arm64': 4.60.4
+ '@rollup/rollup-win32-arm64-msvc': 4.60.4
+ '@rollup/rollup-win32-ia32-msvc': 4.60.4
+ '@rollup/rollup-win32-x64-gnu': 4.60.4
+ '@rollup/rollup-win32-x64-msvc': 4.60.4
+ fsevents: 2.3.3
+
+ roughjs@4.6.6:
+ dependencies:
+ hachure-fill: 0.5.2
+ path-data-parser: 0.1.0
+ points-on-curve: 0.2.0
+ points-on-path: 0.2.1
+
+ rw@1.3.3: {}
+
+ safer-buffer@2.1.2: {}
+
+ sax@1.6.0: {}
+
+ semver@7.7.4: {}
+
+ semver@7.8.1: {}
+
+ sharp@0.34.5:
+ dependencies:
+ '@img/colour': 1.1.0
+ detect-libc: 2.1.2
+ semver: 7.7.4
+ optionalDependencies:
+ '@img/sharp-darwin-arm64': 0.34.5
+ '@img/sharp-darwin-x64': 0.34.5
+ '@img/sharp-libvips-darwin-arm64': 1.2.4
+ '@img/sharp-libvips-darwin-x64': 1.2.4
+ '@img/sharp-libvips-linux-arm': 1.2.4
+ '@img/sharp-libvips-linux-arm64': 1.2.4
+ '@img/sharp-libvips-linux-ppc64': 1.2.4
+ '@img/sharp-libvips-linux-riscv64': 1.2.4
+ '@img/sharp-libvips-linux-s390x': 1.2.4
+ '@img/sharp-libvips-linux-x64': 1.2.4
+ '@img/sharp-libvips-linuxmusl-arm64': 1.2.4
+ '@img/sharp-libvips-linuxmusl-x64': 1.2.4
+ '@img/sharp-linux-arm': 0.34.5
+ '@img/sharp-linux-arm64': 0.34.5
+ '@img/sharp-linux-ppc64': 0.34.5
+ '@img/sharp-linux-riscv64': 0.34.5
+ '@img/sharp-linux-s390x': 0.34.5
+ '@img/sharp-linux-x64': 0.34.5
+ '@img/sharp-linuxmusl-arm64': 0.34.5
+ '@img/sharp-linuxmusl-x64': 0.34.5
+ '@img/sharp-wasm32': 0.34.5
+ '@img/sharp-win32-arm64': 0.34.5
+ '@img/sharp-win32-ia32': 0.34.5
+ '@img/sharp-win32-x64': 0.34.5
+
+ shiki@4.0.2:
+ dependencies:
+ '@shikijs/core': 4.0.2
+ '@shikijs/engine-javascript': 4.0.2
+ '@shikijs/engine-oniguruma': 4.0.2
+ '@shikijs/langs': 4.0.2
+ '@shikijs/themes': 4.0.2
+ '@shikijs/types': 4.0.2
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+
+ shiki@4.1.0:
+ dependencies:
+ '@shikijs/core': 4.1.0
+ '@shikijs/engine-javascript': 4.1.0
+ '@shikijs/engine-oniguruma': 4.1.0
+ '@shikijs/langs': 4.1.0
+ '@shikijs/themes': 4.1.0
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+
+ sisteransi@1.0.5: {}
+
+ sitemap@9.0.1:
+ dependencies:
+ '@types/node': 24.12.3
+ '@types/sax': 1.2.7
+ arg: 5.0.2
+ sax: 1.6.0
+
+ smol-toml@1.6.1: {}
+
+ source-map-js@1.2.1: {}
+
+ source-map@0.7.6: {}
+
+ space-separated-tokens@2.0.2: {}
+
+ starlight-changelogs@0.5.0(@astrojs/starlight@0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)))(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)):
+ dependencies:
+ '@ascorbic/loader-utils': 1.0.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ '@astrojs/starlight': 0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ github-slugger: 2.0.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ mdast-util-to-string: 4.0.0
+ unist-util-visit: 5.1.0
+ transitivePeerDependencies:
+ - astro
+ - supports-color
+
+ starlight-contextual-menu@0.1.5(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))(starlight-markdown@0.1.5(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))):
+ dependencies:
+ astro: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+ starlight-markdown: 0.1.5(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+
+ starlight-links-validator@0.24.0(@astrojs/starlight@0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)))(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)):
+ dependencies:
+ '@astrojs/starlight': 0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ '@types/picomatch': 4.0.3
+ astro: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+ github-slugger: 2.0.0
+ hast-util-from-html: 2.0.3
+ is-absolute-url: 5.0.0
+ mdast-util-mdx-jsx: 3.2.0
+ mdast-util-to-hast: 13.2.1
+ picomatch: 4.0.4
+ terminal-link: 5.0.0
+ unist-util-visit: 5.1.0
+ yaml: 2.9.0
+ transitivePeerDependencies:
+ - supports-color
+
+ starlight-llms-txt@0.10.0(@astrojs/starlight@0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)))(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)):
+ dependencies:
+ '@astrojs/mdx': 5.0.6(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ '@astrojs/starlight': 0.39.2(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0))
+ '@types/hast': 3.0.4
+ '@types/micromatch': 4.0.10
+ astro: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+ github-slugger: 2.0.0
+ hast-util-select: 6.0.4
+ micromatch: 4.0.8
+ rehype-parse: 9.0.1
+ rehype-remark: 10.0.1
+ remark-gfm: 4.0.1
+ remark-stringify: 11.0.0
+ unified: 11.0.5
+ unist-util-remove: 4.0.0
+ transitivePeerDependencies:
+ - supports-color
+
+ starlight-markdown@0.1.5(astro@6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)):
+ dependencies:
+ astro: 6.3.7(@types/node@24.12.3)(jiti@2.6.1)(rollup@4.60.4)(yaml@2.9.0)
+
+ stream-replace-string@2.0.0: {}
+
+ stringify-entities@4.0.4:
+ dependencies:
+ character-entities-html4: 2.1.0
+ character-entities-legacy: 3.0.0
+
+ style-to-js@1.1.21:
+ dependencies:
+ style-to-object: 1.0.14
+
+ style-to-object@1.0.14:
+ dependencies:
+ inline-style-parser: 0.2.7
+
+ stylis@4.3.6: {}
+
+ supports-color@10.2.2: {}
+
+ supports-hyperlinks@4.4.0:
+ dependencies:
+ has-flag: 5.0.1
+ supports-color: 10.2.2
+
+ svgo@4.0.1:
+ dependencies:
+ commander: 11.1.0
+ css-select: 5.2.2
+ css-tree: 3.2.1
+ css-what: 6.2.2
+ csso: 5.0.5
+ picocolors: 1.1.1
+ sax: 1.6.0
+
+ tar@7.5.15:
+ dependencies:
+ '@isaacs/fs-minipass': 4.0.1
+ chownr: 3.0.0
+ minipass: 7.1.3
+ minizlib: 3.1.0
+ yallist: 5.0.0
+
+ terminal-link@5.0.0:
+ dependencies:
+ ansi-escapes: 7.3.0
+ supports-hyperlinks: 4.4.0
+
+ tiny-inflate@1.0.3: {}
+
+ tinyclip@0.1.12: {}
+
+ tinyexec@1.0.4: {}
+
+ tinyexec@1.2.2: {}
+
+ tinyglobby@0.2.16:
+ dependencies:
+ fdir: 6.5.0(picomatch@4.0.4)
+ picomatch: 4.0.4
+
+ to-regex-range@5.0.1:
+ dependencies:
+ is-number: 7.0.0
+
+ trim-lines@3.0.1: {}
+
+ trim-trailing-lines@2.1.0: {}
+
+ trough@2.2.0: {}
+
+ ts-dedent@2.2.0: {}
+
+ tslib@2.8.1:
+ optional: true
+
+ ufo@1.6.3: {}
+
+ ufo@1.6.4: {}
+
+ ultrahtml@1.6.0: {}
+
+ uncrypto@0.1.3: {}
+
+ undici-types@7.16.0: {}
+
+ undici@6.25.0: {}
+
+ unified@11.0.5:
+ dependencies:
+ '@types/unist': 3.0.3
+ bail: 2.0.2
+ devlop: 1.1.0
+ extend: 3.0.2
+ is-plain-obj: 4.1.0
+ trough: 2.2.0
+ vfile: 6.0.3
+
+ unifont@0.7.4:
+ dependencies:
+ css-tree: 3.2.1
+ ofetch: 1.5.1
+ ohash: 2.0.11
+
+ unist-util-find-after@5.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-is: 6.0.1
+
+ unist-util-is@6.0.1:
+ dependencies:
+ '@types/unist': 3.0.3
+
+ unist-util-modify-children@4.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+ array-iterate: 2.0.1
+
+ unist-util-position-from-estree@2.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+
+ unist-util-position@5.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+
+ unist-util-remove-position@5.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-visit: 5.1.0
+
+ unist-util-remove@4.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-is: 6.0.1
+ unist-util-visit-parents: 6.0.2
+
+ unist-util-stringify-position@4.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+
+ unist-util-visit-children@3.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+
+ unist-util-visit-parents@6.0.2:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-is: 6.0.1
+
+ unist-util-visit@5.1.0:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-is: 6.0.1
+ unist-util-visit-parents: 6.0.2
+
+ unstorage@1.17.5:
+ dependencies:
+ anymatch: 3.1.3
+ chokidar: 5.0.0
+ destr: 2.0.5
+ h3: 1.15.11
+ lru-cache: 11.5.0
+ node-fetch-native: 1.6.7
+ ofetch: 1.5.1
+ ufo: 1.6.4
+
+ util-deprecate@1.0.2: {}
+
+ uuid@11.1.0: {}
+
+ vfile-location@5.0.3:
+ dependencies:
+ '@types/unist': 3.0.3
+ vfile: 6.0.3
+
+ vfile-message@4.0.3:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-stringify-position: 4.0.0
+
+ vfile@6.0.3:
+ dependencies:
+ '@types/unist': 3.0.3
+ vfile-message: 4.0.3
+
+ vite@7.3.3(@types/node@24.12.3)(jiti@2.6.1)(yaml@2.9.0):
+ dependencies:
+ esbuild: 0.27.7
+ fdir: 6.5.0(picomatch@4.0.4)
+ picomatch: 4.0.4
+ postcss: 8.5.15
+ rollup: 4.60.4
+ tinyglobby: 0.2.16
+ optionalDependencies:
+ '@types/node': 24.12.3
+ fsevents: 2.3.3
+ jiti: 2.6.1
+ yaml: 2.9.0
+
+ vitefu@1.1.3(vite@7.3.3(@types/node@24.12.3)(jiti@2.6.1)(yaml@2.9.0)):
+ optionalDependencies:
+ vite: 7.3.3(@types/node@24.12.3)(jiti@2.6.1)(yaml@2.9.0)
+
+ web-namespaces@2.0.1: {}
+
+ which-pm-runs@1.1.0: {}
+
+ which@6.0.1:
+ dependencies:
+ isexe: 4.0.0
+
+ xxhash-wasm@1.1.0: {}
+
+ yallist@5.0.0: {}
+
+ yaml@2.9.0: {}
+
+ yargs-parser@22.0.0: {}
+
+ yocto-queue@1.2.2: {}
+
+ zod@4.4.3: {}
+
+ zwitch@2.0.4: {}
diff --git a/docs/pnpm-workspace.yaml b/docs/pnpm-workspace.yaml
new file mode 100644
index 00000000000..d0b7dbe2294
--- /dev/null
+++ b/docs/pnpm-workspace.yaml
@@ -0,0 +1,3 @@
+onlyBuiltDependencies:
+ - esbuild
+ - sharp
diff --git a/docs/public/CNAME b/docs/public/CNAME
new file mode 100644
index 00000000000..91547b2904f
--- /dev/null
+++ b/docs/public/CNAME
@@ -0,0 +1 @@
+invoke.ai
diff --git a/docs/public/coverimage.png b/docs/public/coverimage.png
new file mode 100644
index 00000000000..6586d8ba738
Binary files /dev/null and b/docs/public/coverimage.png differ
diff --git a/docs/public/favicon.svg b/docs/public/favicon.svg
new file mode 100644
index 00000000000..28d6a6d08e5
--- /dev/null
+++ b/docs/public/favicon.svg
@@ -0,0 +1,11 @@
+
diff --git a/docs/scripts/validate-redirect-targets.mjs b/docs/scripts/validate-redirect-targets.mjs
new file mode 100644
index 00000000000..1ec6e7f0898
--- /dev/null
+++ b/docs/scripts/validate-redirect-targets.mjs
@@ -0,0 +1,65 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const docsRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+const contentRoot = join(docsRoot, 'src', 'content', 'docs');
+const redirectsFile = join(docsRoot, 'src', 'config', 'redirects.ts');
+
+const normalizeRoute = (route) => {
+ const normalized = route
+ .replace(/^\/+|\/+$/g, '')
+ .split('/')
+ .filter(Boolean)
+ .map((segment) => segment.toLowerCase().replaceAll(' ', '-'))
+ .join('/');
+
+ return normalized ? `/${normalized}` : '/';
+};
+
+const collectDocsRoutes = (dir, routes = new Set()) => {
+ for (const entry of readdirSync(dir)) {
+ const entryPath = join(dir, entry);
+ const stats = statSync(entryPath);
+
+ if (stats.isDirectory()) {
+ collectDocsRoutes(entryPath, routes);
+ continue;
+ }
+
+ if (!entry.endsWith('.md') && !entry.endsWith('.mdx')) {
+ continue;
+ }
+
+ const relativePath = relative(contentRoot, entryPath).replace(/\\/g, '/').replace(/\.mdx?$/, '');
+ const route = relativePath.endsWith('/index') ? relativePath.slice(0, -'/index'.length) : relativePath;
+ routes.add(normalizeRoute(route));
+
+ const segments = route.split('/').filter(Boolean);
+ for (let index = 1; index < segments.length; index++) {
+ routes.add(normalizeRoute(segments.slice(0, index).join('/')));
+ }
+ }
+
+ return routes;
+};
+
+if (!existsSync(contentRoot)) {
+ throw new Error(`Docs content directory not found: ${contentRoot}`);
+}
+
+const redirectsSource = readFileSync(redirectsFile, 'utf8');
+const redirectMatches = redirectsSource.matchAll(/^\s*['"]([^'"]+)['"]:\s*['"]([^'"]+)['"]/gm);
+const redirectTargets = Array.from(redirectMatches, ([, from, to]) => ({ from, to }));
+const docsRoutes = collectDocsRoutes(contentRoot);
+const missingTargets = redirectTargets.filter(({ to }) => !docsRoutes.has(normalizeRoute(to)));
+
+if (missingTargets.length > 0) {
+ console.error('Redirect targets must resolve to generated docs routes:');
+ for (const { from, to } of missingTargets) {
+ console.error(` ${from} -> ${to}`);
+ }
+ process.exit(1);
+}
+
+console.log(`Validated ${redirectTargets.length} redirect targets.`);
diff --git a/docs/scripts/verify-deploy-output.mjs b/docs/scripts/verify-deploy-output.mjs
new file mode 100644
index 00000000000..885d1f44baa
--- /dev/null
+++ b/docs/scripts/verify-deploy-output.mjs
@@ -0,0 +1,70 @@
+import { readFileSync } from 'node:fs';
+
+const deployTarget = process.env.DEPLOY_TARGET ?? 'custom';
+const base = deployTarget === 'ghpages' ? '/InvokeAI' : '';
+const withBase = (path) => `${base}${path}`;
+
+const expectations = [
+ {
+ file: 'index.html',
+ includes: [
+ `href="${withBase('/_astro/')}`,
+ `src="${withBase('/_astro/')}`,
+ `href="${withBase('/start-here/installation/')}`,
+ ],
+ excludes: deployTarget === 'custom' ? ['href="/InvokeAI/', 'src="/InvokeAI/'] : ['href="/_astro/', 'src="/_astro/'],
+ },
+ {
+ file: 'contributing/index.html',
+ includes: [`href="${withBase('/contributing/new-contributor-guide/')}`],
+ excludes: [
+ deployTarget === 'custom'
+ ? 'href="/InvokeAI/contributing/new-contributor-guide/"'
+ : 'href="/contributing/new-contributor-guide/"',
+ 'newContributorChecklist.md',
+ ],
+ },
+ {
+ file: 'contributing/contribution_guides/newContributorChecklist/index.html',
+ includes: [
+ `Redirecting to: ${withBase('/contributing/new-contributor-guide')}`,
+ `content="0;url=${withBase('/contributing/new-contributor-guide')}`,
+ `href="${withBase('/contributing/new-contributor-guide')}`,
+ ],
+ excludes: deployTarget === 'custom'
+ ? [
+ 'Redirecting to: /InvokeAI/contributing/new-contributor-guide',
+ 'content="0;url=/InvokeAI/contributing/new-contributor-guide',
+ 'href="/InvokeAI/contributing/new-contributor-guide',
+ ]
+ : [
+ 'Redirecting to: /contributing/new-contributor-guide',
+ 'content="0;url=/contributing/new-contributor-guide',
+ 'href="/contributing/new-contributor-guide',
+ ],
+ },
+];
+
+const errors = [];
+
+for (const { file, includes = [], excludes = [] } of expectations) {
+ const html = readFileSync(new URL(`../dist/${file}`, import.meta.url), 'utf8');
+
+ for (const expected of includes) {
+ if (!html.includes(expected)) {
+ errors.push(`${file} is missing ${expected}`);
+ }
+ }
+
+ for (const unexpected of excludes) {
+ if (html.includes(unexpected)) {
+ errors.push(`${file} still contains ${unexpected}`);
+ }
+ }
+}
+
+if (errors.length > 0) {
+ throw new Error(`${deployTarget} output validation failed:\n- ${errors.join('\n- ')}`);
+}
+
+console.log(`${deployTarget} output links and assets look correct.`);
diff --git a/docs/src/assets/coverimage.png b/docs/src/assets/coverimage.png
new file mode 100644
index 00000000000..6586d8ba738
Binary files /dev/null and b/docs/src/assets/coverimage.png differ
diff --git a/docs/src/assets/invoke-icon-wide.svg b/docs/src/assets/invoke-icon-wide.svg
new file mode 100644
index 00000000000..cfeff994147
--- /dev/null
+++ b/docs/src/assets/invoke-icon-wide.svg
@@ -0,0 +1,12 @@
+
diff --git a/docs/src/assets/invoke-icon.svg b/docs/src/assets/invoke-icon.svg
new file mode 100644
index 00000000000..17cfdc77da7
--- /dev/null
+++ b/docs/src/assets/invoke-icon.svg
@@ -0,0 +1,3 @@
+
diff --git a/docs/src/config/head.ts b/docs/src/config/head.ts
new file mode 100644
index 00000000000..03fe1debd5f
--- /dev/null
+++ b/docs/src/config/head.ts
@@ -0,0 +1,79 @@
+import type { StarlightUserConfig } from '@astrojs/starlight/types';
+
+type HeadConfig = NonNullable;
+
+type CreateHeadConfigParams = {
+ base: string;
+ enableAnalytics: boolean;
+ isGhPages: boolean;
+ site: string;
+};
+
+const plausibleScriptUrl =
+ 'https://plausible.tracking.events/js/pa-BHcumuOemKz4XIQeWkTn4.js';
+const plausibleInitScript =
+ 'window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||{}};plausible.init()';
+
+function createHeadConfig({
+ base,
+ enableAnalytics,
+ isGhPages,
+ site,
+}: CreateHeadConfigParams): HeadConfig {
+ const coverImageUrl = new URL(`${base}/coverimage.png`, site).toString();
+
+ return [
+ {
+ tag: 'meta',
+ attrs: {
+ property: 'og:image',
+ content: coverImageUrl,
+ },
+ },
+ {
+ tag: 'meta',
+ attrs: {
+ property: 'og:image:width',
+ content: '1200',
+ },
+ },
+ {
+ tag: 'meta',
+ attrs: {
+ property: 'og:image:height',
+ content: '630',
+ },
+ },
+ {
+ tag: 'meta',
+ attrs: {
+ name: 'twitter:card',
+ content: 'summary_large_image',
+ },
+ },
+ {
+ tag: 'meta',
+ attrs: {
+ name: 'twitter:image',
+ content: coverImageUrl,
+ },
+ },
+ ...(enableAnalytics && !isGhPages
+ ? ([
+ {
+ tag: 'script',
+ attrs: {
+ async: true,
+ src: plausibleScriptUrl,
+ },
+ },
+ {
+ tag: 'script',
+ content: plausibleInitScript,
+ },
+ ] satisfies HeadConfig)
+ : []),
+ ] satisfies HeadConfig;
+}
+
+export { createHeadConfig };
diff --git a/docs/src/config/index.ts b/docs/src/config/index.ts
new file mode 100644
index 00000000000..6fdc64bfb21
--- /dev/null
+++ b/docs/src/config/index.ts
@@ -0,0 +1,4 @@
+export * from './head';
+export * from './redirects';
+export * from './sidebar';
+export * from './social';
diff --git a/docs/src/config/redirects.ts b/docs/src/config/redirects.ts
new file mode 100644
index 00000000000..8c2b3e69c7f
--- /dev/null
+++ b/docs/src/config/redirects.ts
@@ -0,0 +1,55 @@
+import type { AstroConfig } from 'astro';
+
+type RedirectsConfig = AstroConfig['redirects'];
+
+const redirects: RedirectsConfig = {
+ '/CODE_OF_CONDUCT': '/contributing/code-of-conduct',
+ '/RELEASE': '/development/process/release-process',
+ '/installation': '/start-here/installation',
+ '/installation/docker': '/configuration/docker',
+ '/installation/manual': '/start-here/manual',
+ '/installation/models': '/concepts/models',
+ '/installation/patchmatch': '/configuration/patchmatch',
+ '/installation/quick_start': '/start-here/installation',
+ '/installation/requirements': '/start-here/system-requirements',
+ '/configuration': '/configuration/invokeai-yaml',
+ '/features/low-vram/': '/configuration/low-vram-mode/',
+ '/features/lasso-tool': '/features/canvas/lasso-tool',
+ '/features/shapes-tool': '/features/canvas/shapes-tool',
+ '/faq': '/troubleshooting/faq',
+ '/help/SAMPLER_CONVERGENCE': '/concepts/parameters',
+ '/help/diffusion': '/concepts/diffusion',
+ '/help/gettingStartedWithAI': '/concepts/image-generation',
+ '/nodes/NODES': '/features/workflows/editor-interface',
+ '/nodes/NODES_MIGRATION_V3_V4': '/development/guides/api-development',
+ '/nodes/comfyToInvoke': '/features/workflows/comfyui-migration',
+ '/nodes/communityNodes': '/features/workflows/community-nodes',
+ '/nodes/contributingNodes': '/development/guides/creating-nodes',
+ '/nodes/detailedNodes/faceTools': '/features/workflows/face-tools',
+ '/nodes/invocation-api': '/development/guides/api-development',
+ '/contributing/ARCHITECTURE': '/development/architecture/overview',
+ '/contributing/DOWNLOAD_QUEUE': '/development/architecture/model-manager',
+ '/contributing/HOTKEYS': '/features/hotkeys',
+ '/contributing/INVOCATIONS': '/development/architecture/invocations',
+ '/contributing/LOCAL_DEVELOPMENT': '/development/setup/dev-environment',
+ '/contributing/MODEL_MANAGER': '/development/architecture/model-manager',
+ '/contributing/NEW_MODEL_INTEGRATION': '/development/guides/models',
+ '/contributing/PR-MERGE-POLICY': '/development/process/pr-merge-policy',
+ '/contributing/TESTS': '/development/guides/tests',
+ '/contributing/contribution_guides/development': '/development',
+ '/contributing/contribution_guides/newContributorChecklist':
+ '/contributing/new-contributor-guide',
+ '/contributing/dev-environment': '/development/setup/dev-environment',
+ '/contributing/frontend': '/development/front-end',
+ '/contributing/frontend/state-management':
+ '/development/front-end/state-management',
+ '/contributing/frontend/workflows': '/development/front-end/workflows',
+};
+
+function createRedirects(base: string): RedirectsConfig {
+ return Object.fromEntries(
+ Object.entries(redirects).map(([from, to]) => [from, base + to]),
+ );
+}
+
+export { createRedirects };
diff --git a/docs/src/config/sidebar.ts b/docs/src/config/sidebar.ts
new file mode 100644
index 00000000000..7d85c5d2e1d
--- /dev/null
+++ b/docs/src/config/sidebar.ts
@@ -0,0 +1,80 @@
+import type { StarlightUserConfig } from '@astrojs/starlight/types';
+import { makeChangelogsSidebarLinks } from 'starlight-changelogs';
+
+type SidebarConfig = StarlightUserConfig['sidebar'];
+
+const sidebar: SidebarConfig = [
+ {
+ label: 'Start Here',
+ items: [
+ {
+ autogenerate: { directory: 'start-here' },
+ },
+ ],
+ },
+ {
+ label: 'Configuration',
+ items: [
+ {
+ autogenerate: { directory: 'configuration' },
+ },
+ ],
+ },
+ {
+ label: 'Concepts',
+ items: [
+ {
+ autogenerate: { directory: 'concepts' },
+ },
+ ],
+ },
+ {
+ label: 'Features',
+ items: [
+ {
+ autogenerate: { directory: 'features' },
+ },
+ ],
+ },
+ {
+ label: 'Development',
+ items: [
+ {
+ autogenerate: { directory: 'development', collapsed: true },
+ },
+ ],
+ collapsed: true,
+ },
+ {
+ label: 'Contributing',
+ items: [
+ {
+ autogenerate: { directory: 'contributing' },
+ },
+ ],
+ collapsed: true,
+ },
+ {
+ label: 'Troubleshooting',
+ items: [
+ {
+ autogenerate: { directory: 'troubleshooting' },
+ },
+ ],
+ collapsed: true,
+ },
+ {
+ label: 'Releases',
+ collapsed: true,
+ items: [
+ ...makeChangelogsSidebarLinks([
+ {
+ type: 'recent',
+ base: 'releases',
+ },
+ ]),
+ ],
+ },
+];
+
+export { sidebar as sidebarConfig };
diff --git a/docs/src/config/social.ts b/docs/src/config/social.ts
new file mode 100644
index 00000000000..8c7d416a004
--- /dev/null
+++ b/docs/src/config/social.ts
@@ -0,0 +1,23 @@
+import type { StarlightUserConfig } from '@astrojs/starlight/types';
+
+type SocialConfig = StarlightUserConfig['social'];
+
+const social: SocialConfig = [
+ {
+ icon: 'github',
+ label: 'GitHub',
+ href: 'https://github.com/invoke-ai/InvokeAI',
+ },
+ {
+ icon: 'discord',
+ label: 'Discord',
+ href: 'https://discord.gg/ZmtBAhwWhy',
+ },
+ {
+ icon: 'youtube',
+ label: 'YouTube',
+ href: 'https://www.youtube.com/@invokeai',
+ },
+];
+
+export { social as socialConfig };
diff --git a/docs/src/content.config.ts b/docs/src/content.config.ts
new file mode 100644
index 00000000000..5dbc874545d
--- /dev/null
+++ b/docs/src/content.config.ts
@@ -0,0 +1,22 @@
+import { defineCollection } from 'astro:content';
+import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
+import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
+
+import { changelogsLoader } from 'starlight-changelogs/loader';
+
+export const collections = {
+ docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+ i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }),
+ changelogs: defineCollection({
+ loader: changelogsLoader([
+ {
+ title: "Releases",
+ provider: 'github',
+ base: 'releases',
+ owner: 'invoke-ai',
+ repo: 'InvokeAI',
+ pagefind: false,
+ }
+ ]),
+ })
+};
diff --git a/docs/src/content/docs/assets/controlnets-parallax/city-canny.png b/docs/src/content/docs/assets/controlnets-parallax/city-canny.png
new file mode 100644
index 00000000000..f46ad56e1b5
Binary files /dev/null and b/docs/src/content/docs/assets/controlnets-parallax/city-canny.png differ
diff --git a/docs/src/content/docs/assets/controlnets-parallax/city-depth.png b/docs/src/content/docs/assets/controlnets-parallax/city-depth.png
new file mode 100644
index 00000000000..5ed305e8cd9
Binary files /dev/null and b/docs/src/content/docs/assets/controlnets-parallax/city-depth.png differ
diff --git a/docs/src/content/docs/assets/controlnets-parallax/city-og.png b/docs/src/content/docs/assets/controlnets-parallax/city-og.png
new file mode 100644
index 00000000000..25fd75cdf6e
Binary files /dev/null and b/docs/src/content/docs/assets/controlnets-parallax/city-og.png differ
diff --git a/docs/src/content/docs/assets/controlnets-parallax/city-ui-layers.png b/docs/src/content/docs/assets/controlnets-parallax/city-ui-layers.png
new file mode 100644
index 00000000000..6ddc0f74058
Binary files /dev/null and b/docs/src/content/docs/assets/controlnets-parallax/city-ui-layers.png differ
diff --git a/docs/assets/invoke-web-server-1.png b/docs/src/content/docs/assets/invoke-web-server-1.png
similarity index 100%
rename from docs/assets/invoke-web-server-1.png
rename to docs/src/content/docs/assets/invoke-web-server-1.png
diff --git a/docs/src/content/docs/assets/invoke-webui-canvas.png b/docs/src/content/docs/assets/invoke-webui-canvas.png
new file mode 100644
index 00000000000..29dda3baf42
Binary files /dev/null and b/docs/src/content/docs/assets/invoke-webui-canvas.png differ
diff --git a/docs/assets/invoke_ai_banner.png b/docs/src/content/docs/assets/splash-banner.png
similarity index 100%
rename from docs/assets/invoke_ai_banner.png
rename to docs/src/content/docs/assets/splash-banner.png
diff --git a/docs/src/content/docs/concepts/diffusion.mdx b/docs/src/content/docs/concepts/diffusion.mdx
new file mode 100644
index 00000000000..27030b2af4a
--- /dev/null
+++ b/docs/src/content/docs/concepts/diffusion.mdx
@@ -0,0 +1,77 @@
+---
+title: Diffusion
+lastUpdated: 2026-02-20
+sidebar:
+ order: 5
+---
+
+import { Card, CardGrid, Steps, Tabs, TabItem } from '@astrojs/starlight/components';
+
+Taking the time to understand the diffusion process will help you to understand how to more effectively use InvokeAI.
+
+## Image Space vs. Latent Space
+
+There are two main ways Stable Diffusion works — with images, and latents.
+
+
+
+ Represents images in pixel form that you look at. This is the final visual output you see.
+
+
+ Represents compressed inputs. It's in latent space that Stable Diffusion processes images.
+
+
+
+:::note[What is a VAE?]
+ A **VAE (Variational Auto Encoder)** is responsible for compressing and encoding inputs into *latent space*, as well as decoding outputs back into *image space*.
+:::
+
+## Core Components
+
+To fully understand the diffusion process, we need to understand a few more terms: **U-Net**, **CLIP**, and **conditioning**.
+
+
+
+ A model trained on a large number of latent images with known amounts of random noise added. The U-Net can be given a slightly noisy image and it will predict the pattern of noise needed to subtract from the image in order to recover the original.
+
+
+ **CLIP** is a model that tokenizes and encodes text into **conditioning**. This conditioning guides the model during the denoising steps to produce a new image.
+
+
+
+The U-Net and CLIP work together during the image generation process at each denoising step. The U-Net removes noise so that the result is similar to images in its training set, while CLIP guides the U-Net towards creating images that are most similar to your prompt.
+
+## The Generation Process
+
+
+
+ When you generate an image using text-to-image, multiple steps occur in latent space:
+
+
+ 1. **Noise Generation:** Random noise is generated at the chosen height and width. The noise's characteristics are dictated by the seed. This noise tensor is passed into latent space. We'll call this *noise A*.
+ 2. **Noise Prediction:** Using a model's U-Net, a noise predictor examines *noise A* and the words tokenized by CLIP from your prompt (conditioning). It generates its own noise tensor to predict what the final image might look like in latent space. We'll call this *noise B*.
+ 3. **Subtraction:** *Noise B* is subtracted from *noise A* in an attempt to create a latent image consistent with the prompt. This step is repeated for the number of sampler steps chosen.
+ 4. **Decoding:** The VAE decodes the final latent image from latent space into image space.
+
+
+
+ Image-to-image is a similar process, with only the first step being different:
+
+
+ 1. **Encoding & Adding Noise:** The input image is encoded from image space into latent space by the VAE. Noise is then added to the input latent image.
+ * **Denoising Strength** dictates how many noise steps are added, and the amount of noise added at each step.
+ * A strength of `0` means there are 0 steps and no noise added, resulting in an unchanged image.
+ * A strength of `1` results in the image being completely replaced with noise and a full set of denoising steps are performed.
+ 2. **Noise Prediction:** Using a model's U-Net, a noise predictor examines the noisy latent image and the conditioning from your prompt. It generates its own noise tensor to predict the final image.
+ 3. **Subtraction:** The predicted noise is subtracted from the current noise in an attempt to create a latent image consistent with the prompt. This step is repeated for the remaining sampler steps.
+ 4. **Decoding:** The VAE decodes the final latent image from latent space into image space.
+
+
+
+
+## Summary
+
+
+- A **Model** provides the CLIP prompt tokenizer, the VAE, and a U-Net (where noise prediction occurs given a prompt and initial noise tensor).
+- A **Noise Scheduler** (e.g. `DPM++ 2M Karras`) schedules the subtraction of noise from the latent image across the sampler steps chosen. Less noise is usually subtracted at higher sampler steps.
+
diff --git a/docs/src/content/docs/concepts/dynamic-prompting.mdx b/docs/src/content/docs/concepts/dynamic-prompting.mdx
new file mode 100644
index 00000000000..c345fea5fe4
--- /dev/null
+++ b/docs/src/content/docs/concepts/dynamic-prompting.mdx
@@ -0,0 +1,133 @@
+---
+title: Dynamic Prompting
+lastUpdated: 2026-03-30
+sidebar:
+ order: 4
+---
+
+import { Card, CardGrid, Steps, LinkCard } from '@astrojs/starlight/components';
+
+Dynamic prompting expands a single prompt into many prompt variations. It is useful for brainstorming, prompt exploration, and batch testing without rewriting the same prompt by hand.
+
+## Basic syntax
+
+Put alternatives inside braces and separate them with `|`.
+
+```text
+a {red|green|blue} balloon
+```
+
+This can expand into:
+
+```text
+a red balloon
+a green balloon
+a blue balloon
+```
+
+You can use more than one dynamic group in the same prompt:
+
+```text
+a {red|green} {balloon|kite}
+```
+
+That creates a set of prompt combinations such as `a red balloon`, `a red kite`, `a green balloon`, and `a green kite`.
+
+## Select more than one option with `$$`
+
+Prefix a group with a number and `$$` to choose multiple distinct options from the same set.
+
+```text
+portrait, {2$$rim light|fog|rain|neon reflections}
+```
+
+Possible results include:
+
+```text
+portrait, rim light, fog
+portrait, fog, rain
+portrait, rim light, neon reflections
+```
+
+This is useful when you want controlled variety without writing every combination by hand.
+
+## Random vs combinatorial expansion
+
+
+
+ Walks the possible prompt combinations systematically until `Max Prompts` is reached.
+
+
+ Samples prompt variations instead of enumerating every combination. A seed can make random expansion repeatable.
+
+
+
+InvokeAI supports both modes, but where you can choose them depends on the workflow.
+
+- In the current linear UI, dynamic prompt preview is driven from the positive prompt and currently follows the standard combinatorial expansion path.
+- In node and backend contexts, random and combinatorial generation are exposed more explicitly.
+
+## Max Prompts
+
+`Max Prompts` limits how many expanded prompts InvokeAI will generate.
+
+This matters because combinations grow quickly. For example:
+
+```text
+a {red|green|blue} balloon in {morning mist|golden hour|rain}
+```
+
+Even this small prompt already has nine possible combinations.
+
+:::tip[Start small]
+ Preview a handful of prompt variants first. Once the combinations look useful, increase `Max Prompts` for a larger batch.
+:::
+
+## Seed Behaviour
+
+In the current UI, the `Seed Behaviour` setting controls how seeds are reused across expanded prompts.
+
+
+
+ Uses one seed per iteration, so prompt variants in the same iteration share a seed. This is useful when you want to compare prompt wording more directly.
+
+
+ Uses a different seed for every generated image. This is useful when you want the widest possible variety.
+
+
+
+## Using dynamic prompting in the linear UI
+
+
+ 1. **Put dynamic prompt syntax in the positive prompt**
+
+ In the current linear UI, dynamic prompt expansion is driven from the positive prompt.
+
+ 2. **Open the preview**
+
+ Use `Show Dynamic Prompts` or the prompts preview to inspect the expanded list before you generate.
+
+ 3. **Set `Max Prompts`**
+
+ Keep the expansion under control before launching a large batch.
+
+ 4. **Choose the right seed behavior**
+
+ Use `Seed per Iteration` for easier comparison, or `Seed per Image` for more variety.
+
+ 5. **Generate a small batch first**
+
+ Sanity-check the combinations before scaling up.
+
+
+:::note[Current linear UI behavior]
+ The linear UI currently exposes `Max Prompts`, preview, and seed behavior. It does not expose a separate random-versus-combinatorial mode switch in the main positive prompt flow.
+:::
+
+## Tips
+
+- Keep each option group internally compatible.
+- Be careful with multiple groups, because the number of combinations grows quickly.
+- Review the expanded prompt list before launching a large batch.
+- Use dynamic prompting for variation, not to avoid thinking through the base prompt.
+- When one specific term needs more emphasis, use [Prompting Syntax](../prompt-syntax) instead of adding more dynamic groups.
diff --git a/docs/src/content/docs/concepts/image-generation.mdx b/docs/src/content/docs/concepts/image-generation.mdx
new file mode 100644
index 00000000000..6aa25f4b34c
--- /dev/null
+++ b/docs/src/content/docs/concepts/image-generation.mdx
@@ -0,0 +1,153 @@
+---
+title: Image Generation
+lastUpdated: 2026-03-30
+sidebar:
+ order: 1
+---
+
+import { Card, CardGrid, Steps, LinkCard } from '@astrojs/starlight/components';
+
+:::tip[New to image generation with AI?]
+ You're in the right place! This is a high-level walkthrough of some of the concepts and terms you'll see as you start using Invoke. Please note, this is not an exhaustive guide and may be out of date due to the rapidly changing nature of the space.
+:::
+
+## Using InvokeAI
+
+### Prompt Crafting
+
+Prompts are the basis of using InvokeAI, providing the models directions on what to generate. As a general rule of thumb, the more detailed your prompt is, the better your result will be.
+
+
+ To get started, here's an easy template to use for structuring your prompts:
+ **Subject, Style, Quality, Aesthetic**
+
+ - **Subject:** What your image will be about. E.g. “a futuristic city with trains”, “penguins floating on icebergs”, “friends sharing beers”.
+ - **Style:** The style or medium in which your image will be in. E.g. “photograph”, “pencil sketch”, “oil paints”, or “pop art”, “cubism”, “abstract”.
+ - **Quality:** A particular aspect or trait that you would like to see emphasized in your image. E.g. "award-winning", "featured in relevant set of high quality works", "professionally acclaimed". Many people often use "masterpiece".
+ - **Aesthetics:** The visual impact and design of the artwork. This can be colors, mood, lighting, setting, etc.
+
+
+There are two prompt boxes: **Positive Prompt** & **Negative Prompt**.
+
+- A **Positive Prompt** includes words you want the model to reference when creating an image.
+- A **Negative Prompt** is for anything you want the model to eliminate when creating an image. It doesn’t always interpret things exactly the way you would, but helps control the generation process. Always try to include a few terms - you can typically use lower quality image terms like “blurry” or “distorted” with good success.
+
+**Some example prompts you can try on your own:**
+
+- *A detailed oil painting of a tranquil forest at sunset with vibrant colors and soft, golden light filtering through the trees*
+- *friends sharing beers in a busy city, realistic colored pencil sketch, twilight, masterpiece, bright, lively*
+
+### Advanced Prompting
+
+
+
+
+
+
+
+### Generation Workflows
+
+Invoke offers a number of different workflows for interacting with models to produce images. Each is extremely powerful on its own, but together provide you an unparalleled way of producing high quality creative outputs that align with your vision.
+
+
+
+ Focuses on the key workflow of using a prompt to generate a new image. It includes other features that help control the generation process as well.
+
+
+ Provide an image as a reference (called the “initial image”), which provides more guidance around color and structure to the AI as it generates a new image.
+
+
+ An advanced AI-first image editing tool. Drag an image onto the canvas to regenerate elements, edit content or colors (**inpainting**), or extend the image with consistency and clarity (**outpainting**).
+
+
+
+### Improving Image Quality
+
+
+ 1. **Fine-tuning your prompt:**
+
+ The more specific you are, the closer the image will turn out to what is in your head. Adding more details in the Positive or Negative Prompt can help add or remove parts of the image. You can also use advanced techniques like upweighting and downweighting to control the influence of specific words. Learn more in the [Prompting Guide](../prompting-guide) and [Prompting Syntax](../prompt-syntax).
+
+ :::tip
+ If you're seeing poor results, try adding the things you don't like about the image to your negative prompt. E.g. *distorted, low quality, unrealistic, etc.*
+ :::
+
+ 2. **Explore different models:**
+
+ Other models can produce different results due to the data they've been trained on. Each model has specific language and settings it works best with; a model's documentation is your friend here. Play around with some and see what works best for you!
+
+ 3. **Increasing Steps:**
+
+ The number of steps used controls how much time the model is given to produce an image, and depends on the "Scheduler" used. More steps tends to mean better results, but will take longer. We recommend at least 30 steps for most.
+
+ 4. **Tweak and Iterate:**
+
+ Remember, it's best to change one thing at a time so you know what is working and what isn't. Sometimes you just need to try a new image, and other times using a new prompt might be the ticket.
+ *For testing, consider turning off the "random" Seed. Using the same seed with the same settings will produce the same image, which makes it the perfect way to learn exactly what your changes are doing.*
+
+ 5. **Explore Advanced Settings:**
+
+ InvokeAI has a full suite of tools available to allow you complete control over your image creation process. Check out our [features docs](../../features/gallery) if you want to learn more.
+
+
+## Terms & Concepts
+
+:::note
+ If you're interested in learning more, check out [this presentation](https://docs.google.com/presentation/d/1IO78i8oEXFTZ5peuHHYkVF-Y3e2M6iM5tCnc-YBfcCM/edit?usp=sharing) from one of our maintainers (@lstein).
+:::
+
+### Stable Diffusion
+
+Stable Diffusion is a deep learning, text-to-image model that is the foundation of the capabilities found in InvokeAI. Since the release of Stable Diffusion, there have been many subsequent models created based on Stable Diffusion that are designed to generate specific types of images.
+
+### Prompts
+
+Prompts provide the models directions on what to generate. As a general rule of thumb, the more detailed your prompt is, the better your result will be.
+
+### Models
+
+Models are the magic that power InvokeAI. These files represent the output of training a machine on understanding massive amounts of images - providing them with the capability to generate new images using just a text description of what you'd like to see.
+
+Invoke offers a simple way to download several different models upon installation, but many more can be discovered online, including at [civitai.com](https://civitai.com). Each model can produce a unique style of output, based on the images it was trained on.
+
+:::note
+ Models that contain "inpainting" in the name are designed for use with the inpainting feature of the Unified Canvas.
+:::
+
+### Schedulers & Steps
+
+**Schedulers** guide the process of removing noise (de-noising) from data. They determine:
+1. The number of steps to take to remove the noise.
+2. Whether the steps are random (stochastic) or predictable (deterministic).
+3. The specific method (algorithm) used for de-noising.
+
+**Steps** represent the number of de-noising iterations each generation goes through. Schedulers can be intricate and there's often a balance to strike between how quickly they can de-noise data and how well they can do it. It's typically advised to experiment with different schedulers to see which one gives the best results.
+
+### Additional Concepts
+
+
+
+ LoRAs are like a smaller, more focused version of models, intended to focus on training a better understanding of how a specific character, style, or concept looks.
+
+
+ Like LoRAs, embeddings assist with more easily prompting for certain characters, styles, or concepts. They are trained to update the relationship between a specific word (known as the "trigger") and the intended output.
+
+
+ ControlNets are neural network models that are able to extract key features from an existing image and use these features to guide the output of the image generation model.
+
+
+ A Variational Auto-Encoder (VAE) is an encode/decode model that translates the "latents" image produced during the image generation process to the large pixel images that we see.
+
+
diff --git a/docs/src/content/docs/concepts/models.mdx b/docs/src/content/docs/concepts/models.mdx
new file mode 100644
index 00000000000..3ebdf27c788
--- /dev/null
+++ b/docs/src/content/docs/concepts/models.mdx
@@ -0,0 +1,133 @@
+---
+title: Models
+sidebar:
+ order: 8
+---
+
+## Checkpoint and Diffusers Models
+
+The model checkpoint files (`*.ckpt`) are the Stable Diffusion "secret sauce". They are the product of training the AI on millions of captioned images gathered from multiple sources.
+
+Originally there was only a single Stable Diffusion weights file, which many people named `model.ckpt`.
+
+Today, there are thousands of models, fine tuned to excel at specific styles, genres, or themes.
+
+:::tip[Model Formats]
+ We also have two more popular model formats, both created by [HuggingFace](https://huggingface.co/):
+
+ - `safetensors`: Single file, like `.ckpt` files. Prevents malware from lurking in a model.
+ - `diffusers`: Splits the model components into separate files, allowing very fast loading.
+
+ InvokeAI supports all three formats.
+:::
+
+## Starter Models
+
+When you first start InvokeAI, you'll see a popup prompting you to install some starter models from the Model Manager. Click the `Starter Models` tab to see the list.
+
+You'll find a collection of popular and high-quality models available for easy download.
+
+Some models carry license terms that limit their use in commercial applications or on public servers. It's your responsibility to adhere to the license terms.
+
+## Other Models
+
+There are a few ways to install other models:
+
+- **URL or Local Path**: Provide the path to a model on your computer, or a direct link to the model. Some sites require you to use an API token to download models, which you can [set up in the config file]. You can also paste a HuggingFace Repo ID here directly — it is detected and routed to the HuggingFace installer automatically.
+- **HuggingFace**: Paste a HF Repo ID to install it. If there are multiple models in the repo, you'll get a list to choose from. Repo IDs look like this: `XpucT/Deliberate`. There is a copy button on each repo to copy the ID.
+- **Scan Folder**: Scan a local folder for models. You can install all of the detected models in one click.
+
+### Diffusers models in HF repo subfolders
+
+HuggingFace repos can be structured in any way. Some model authors include multiple models within the same folder.
+
+In this situation, you may need to provide some additional information to identify the model you want, by adding `:subfolder_name` to the repo ID.
+
+:::note[Example]
+ Say you have a repo ID `monster-labs/control_v1p_sd15_qrcode_monster`, and the model you want is inside the `v2` subfolder.
+
+ Add `:v2` to the repo ID and use that when installing the model: `monster-labs/control_v1p_sd15_qrcode_monster:v2`
+:::
+
+[set up in the config file]: ../../configuration/invokeai-yaml
+
+## Editing model metadata
+
+Every model has an editable **Source URL** field alongside its name and description. Use it to record where a model came from — for example a Civitai or HuggingFace page — independent of how it was originally installed. The URL is editable from the model's **Edit** view and appears as a clickable link in the model header once set. Models without a URL simply hide the field.
+
+This is purely metadata: the URL has no effect on loading and is not used to refresh or reinstall the model. It is mainly useful for going back to the model's documentation, license, or example prompts later.
+
+## Bulk actions in the Model Manager
+
+The Model Manager supports multi-selection for batch operations.
+
+- **Select multiple models** by clicking with **Ctrl** (Windows / Linux) or **Cmd** (macOS) held, or by using the checkboxes on each row. A sticky header at the top shows the current selection count and is always visible while you scroll.
+- Open the **Actions** dropdown for the selection. The available actions are:
+ - **Delete Models** — removes every selected model in a single confirmation step. Partial failures (e.g. permission issues) are reported per-model in the result toast.
+ - **Reidentify Models** — re-probes every selected model, updating fields that depend on the file contents (type, base, format, variant, etc.). This is the bulk version of the per-model reidentify action.
+
+:::caution[Reidentify resets custom settings]
+Reidentifying a model re-derives its configuration from the file on disk. Any custom settings you've adjusted on those models — default settings, descriptions, trigger phrases — may be overwritten. The confirmation modal warns you about this before running.
+:::
+
+Both actions handle partial failures: if some models succeed and others fail, the toast lists succeeded and failed counts and the list view updates immediately for the ones that worked.
+
+## Finding orphaned models
+
+If a model file is deleted or moved outside the Model Manager, its database entry sticks around. To find these orphaned entries:
+
+1. Open the Model Manager.
+2. Open the **type filter** dropdown and pick **Missing Files**.
+3. The list now shows only models whose files are no longer present on disk. Each one also displays a **Missing Files** badge in its row.
+
+Orphaned models are automatically excluded from selection dropdowns (main model, LoRA, VAE, etc.), so you cannot accidentally pick one for generation. Use the [bulk delete action](#bulk-actions-in-the-model-manager) to clean them out in one step.
+
+## Synchronizing orphaned model directories
+
+The **Missing Files** filter finds database records whose files are gone. InvokeAI also has a separate sync workflow for the opposite situation: model directories that still exist on disk but are not referenced in the database.
+
+This can happen after a failed import, a manual database edit, or deleting a model record while leaving files behind. The sync workflow scans the models directory for top-level folders containing model files with common model extensions, including `.safetensors`, `.ckpt`, `.pt`, `.pth`, `.bin`, `.onnx`, and `.gguf`.
+
+To review these directories:
+
+1. In multi-user mode, sign in as an administrator. In single-user mode, the Model Manager controls are available by default.
+2. Open the Model Manager.
+3. Click **Sync Models** to scan for orphaned model directories.
+4. Review each reported relative directory path, contained model files, and total size before deleting anything.
+
+:::caution[Deletion removes directories]
+Deleting an orphaned model directory removes the entire reported directory from disk. The server deletes it directly with recursive directory deletion, so make sure the directory contains only files you intend to remove.
+:::
+
+Only administrators can use this workflow in multi-user mode. The underlying API is `/api/v2/models/sync/orphaned`; API results also include the absolute path for each reported directory.
+
+## Exporting and Importing Model Settings
+
+Each installed model has an **Export Settings** and **Import Settings** action in the Model Manager. Use these to back up a model's configuration, move it to another install, or share a curated setup with someone else.
+
+### What gets exported
+
+The exported `.json` file captures the configuration you have set on the model, not the model weights themselves:
+
+- `default_settings` — steps, CFG / guidance, scheduler, dimensions, FP8 storage toggle, VAE precision, etc.
+- `trigger_phrases` — for LoRAs and similar.
+- `cpu_only` — for encoder-type models.
+- `name`, `description`, `source_url` — the model's identifying metadata.
+- `cover_image` — the model's thumbnail, embedded as a base64 data URL.
+
+Fields you have not set are omitted from the file. The format is forward and backward compatible: older clients ignore newer fields, and a file produced by a newer version still imports cleanly into an older one (it just skips the fields it does not understand).
+
+### Importing
+
+Importing applies the JSON to the currently selected model:
+
+- `default_settings`, `trigger_phrases`, `cpu_only`, `name`, `description`, and `source_url` are applied via the normal model update path. Any field that the target model type does not support (e.g. `cpu_only` on a model that has no such setting) is listed in a "skipped" toast — everything else still applies.
+- `cover_image` is uploaded and set as the model's thumbnail.
+
+Imports are validated before they run. The file is rejected if `source_url` is not an `http(s)://` URL or if `cover_image` is not a valid image data URL — so a malformed or hand-edited file cannot quietly poison a model's configuration.
+
+### Typical workflows
+
+- **Back up a model you've spent time tuning** so you can restore its settings after a reinstall, or roll back after experimenting.
+- **Copy settings between two installs of the same model** — e.g. between a desktop and a workstation.
+- **Share a curated setup** (name, description, thumbnail, default steps / CFG / scheduler, trigger phrases) for a model you have configured well.
diff --git a/docs/src/content/docs/concepts/nodes-workflows.mdx b/docs/src/content/docs/concepts/nodes-workflows.mdx
new file mode 100644
index 00000000000..019d999bb35
--- /dev/null
+++ b/docs/src/content/docs/concepts/nodes-workflows.mdx
@@ -0,0 +1,29 @@
+---
+title: Nodes and Workflows
+sidebar:
+ order: 7
+---
+
+import { Card, CardGrid } from '@astrojs/starlight/components';
+
+## What are Nodes?
+
+A **Node** is simply a single operation that takes in inputs and returns outputs. Multiple nodes can be linked together to create more complex functionality. All InvokeAI features are added through nodes.
+
+With nodes, you can easily extend the image generation capabilities of InvokeAI and build workflows that suit your specific needs.
+
+### Anatomy of a Node
+
+Individual nodes are made up of the following:
+
+
+
+ Edge points on the **left side** of the node window where you connect outputs from other nodes.
+
+
+ Edge points on the **right side** of the node window where you connect to inputs on other nodes.
+
+
+ Various options which are either manually configured, or overridden by connecting an output from another node to the input.
+
+
diff --git a/docs/src/content/docs/concepts/parameters.mdx b/docs/src/content/docs/concepts/parameters.mdx
new file mode 100644
index 00000000000..c4882de919e
--- /dev/null
+++ b/docs/src/content/docs/concepts/parameters.mdx
@@ -0,0 +1,143 @@
+---
+title: Generation Parameters
+lastUpdated: 2026-02-20
+sidebar:
+ order: 6
+---
+
+import { Card, CardGrid, Steps } from '@astrojs/starlight/components';
+
+# Sampler Convergence
+
+As features keep increasing, making the right choices for your needs can become increasingly difficult. What sampler to use? And for how many steps? Do you change the CFG value? Do you use prompt weighting? Do you allow variations?
+
+Even once you have a result, do you blend it with other images? Pass it through `img2img`? With what strength? Do you use inpainting to correct small details? Outpainting to extend cropped sections?
+
+The purpose of this series of documents is to help you better understand these tools, so you can make the best out of them. Feel free to contribute with your own findings!
+
+In this document, we will talk about **sampler convergence**.
+
+
+ Looking for a short version? Here is the summary:
+
+ - Results converge as steps (`-s`) are increased (except for `K_DPM_2_A` and `K_EULER_A`). Often at ≥ `-s100`, but may require ≥ `-s700`.
+ - Producing a batch of candidate images at low (`-s8` to `-s30`) step counts can save you hours of computation.
+ - `K_HEUN` and `K_DPM_2` converge in fewer steps (but are slower per step).
+ - `K_DPM_2_A` and `K_EULER_A` incorporate a lot of creativity and variability.
+
+
+## Sampler Performance Overview
+
+
+
+ *(Tested on M1 Max 64GB, 512x512, 3 sample average)*
+
+ | Sampler | it/s |
+ | :--- | :--- |
+ | `DDIM` | 1.89 |
+ | `PLMS` | 1.86 |
+ | `K_EULER` | 1.86 |
+ | `K_LMS` | **1.91** (Fastest) |
+ | `K_EULER_A` | 1.86 |
+ | `K_HEUN` | 0.95 *(Slower)* |
+ | `K_DPM_2` | 0.95 *(Slower)* |
+ | `K_DPM_2_A` | 0.95 *(Slower)* |
+
+
+
+ For most use cases, `K_LMS`, `K_HEUN` and `K_DPM_2` are the best choices.
+
+ While `K_HEUN` and `K_DPM_2` run half as fast, they tend to converge twice as quickly as `K_LMS`.
+
+ At very low steps (≤ `-s8`), `K_HEUN` and `K_DPM_2` are not recommended. Use `K_LMS` instead.
+
+ For high variability between steps, use `K_EULER_A` (which runs twice as fast as `K_DPM_2_A`).
+
+
+
+---
+
+## Sampler Results by Subject
+
+Let's start by choosing a prompt and using it with each of our 8 samplers, running it for 10, 20, 30, 40, 50 and 100 steps.
+
+### Anime
+> `"an anime girl" -W512 -H512 -C7.5 -S3031912972`
+
+
+
+Immediately, you can notice results tend to converge — that is, as `-s` (step) values increase, images look more and more similar until there comes a point where the image no longer changes.
+
+You can also notice how `DDIM` and `PLMS` eventually tend to converge to K-sampler results as steps are increased. Among K-samplers, `K_HEUN` and `K_DPM_2` seem to require the fewest steps to converge, and even at low step counts they are good indicators of the final result. Finally, `K_DPM_2_A` and `K_EULER_A` seem to do a bit of their own thing and don't keep much similarity with the rest of the samplers.
+
+### Nature
+Now, these results seem interesting, but do they hold for other topics? Let's try!
+
+> `"valley landscape wallpaper, d&d art, fantasy, painted, 4k, high detail, sharp focus, washed colors, elaborate excellent painted illustration" -W512 -H512 -C7.5 -S1458228930`
+
+
+
+With nature, you can see how initial results are even more indicative of the final result — more so than with characters/people. `K_HEUN` and `K_DPM_2` are again the quickest indicators, almost right from the start. Results also converge faster (e.g. `K_HEUN` converged at `-s21`).
+
+### Food
+> `"a hamburger with a bowl of french fries" -W512 -H512 -C7.5 -S4053222918`
+
+
+
+Again, `K_HEUN` and `K_DPM_2` take the fewest number of steps to be good indicators of the final result. `K_DPM_2_A` and `K_EULER_A` seem to incorporate a lot of creativity/variability, capable of producing rotten hamburgers, but also of adding lettuce to the mix. And they're the only samplers that produced an actual 'bowl of fries'!
+
+### Animals
+> `"grown tiger, full body" -W512 -H512 -C7.5 -S3721629802`
+
+
+
+`K_HEUN` and `K_DPM_2` once again require the least number of steps to be indicative of the final result (around `-s30`), while other samplers are still struggling with several tails or malformed back legs.
+
+It also takes longer to converge (for comparison, `K_HEUN` required around 150 steps to converge). This is normal, as producing human/animal faces/bodies is one of the things the model struggles the most with. For these topics, running for more steps will often increase coherence within the composition.
+
+### People
+> `"Ultra realistic photo, (Miranda Bloom-Kerr), young, stunning model, blue eyes, blond hair, beautiful face, intricate, highly detailed, smooth, art by artgerm and greg rutkowski and alphonse mucha, stained glass" -W512 -H512 -C7.5 -S2131956332`. *(This time, we will go up to 300 steps).*
+
+
+
+Observing the results, it again takes longer for all samplers to converge (`K_HEUN` took around 150 steps), but we can observe good indicative results much earlier (see: `K_HEUN`). Conversely, `DDIM` and `PLMS` are still undergoing moderate changes (see: lace around her neck), even at `-s300`.
+
+In fact, as we can see in this other experiment, some samplers can take 700+ steps to converge when generating people.
+
+
+
+Note also the point of convergence may not be the most desirable state (e.g. you might prefer an earlier version of the face that is more rounded), but it will probably be the most coherent regarding arms/hands/face attributes. You can always merge different images with a photo editing tool and pass it through `img2img` to smoothen the composition.
+
+---
+
+## Batch Generation Speedup
+
+This realization about convergence is very useful because it means you don't need to create a batch of 100 images (`-n100`) at `-s100` just to choose your favorite 2 or 3 images.
+
+You can produce the same 100 images at `-s10` to `-s30` using a K-sampler (since they converge faster), get a rough idea of the final result, choose your 2 or 3 favorite ones, and then run `-s100` on those specific images to polish details. This technique is **3-8x as quick**.
+
+:::tip[Time Savings Example]
+ Assuming 60 seconds per 100 steps:
+
+ - **Method A:** 60s * 100 images = **6000s** (100 images at `-s100`, manually picking 3 favorites). Total time: **1 hour and 40 minutes.**
+ - **Method B:** 6s * 100 images + 60s * 3 images = **780s** (100 images at `-s10`, manually picking 3 favorites, and running those 3 at `-s100` to polish details). Total time: **13 minutes.**
+:::
+
+## Three Key Takeaways
+
+Finally, it is relevant to mention that, in general, there are 3 important moments in the process of image formation as steps increase:
+
+
+1. **The Indicator Stage:**
+ The earliest point at which an image becomes a good indicator of the final result. This is useful for batch generation at low step values to preview outputs before committing to higher steps.
+2. **The Coherence Stage:**
+ The point at which an image becomes coherent, even if different from the final converged result. This is useful for low-step batch generation where quality is improved via other techniques (like inpainting) rather than raw step count.
+3. **The Convergence Stage:**
+ The point at which an image fully converges and stops changing.
+
+
+:::note[Workflow Dictates Strategy]
+ Remember that your workflow/strategy should define your optimal number of steps, even for the same prompt and seed. For example, if you seek full convergence, you may run `K_LMS` for `-s200`. However, running `K_LMS` for `-s20` (taking one-tenth the time) may perform just as well if your workflow includes adding small missing details via `img2img`.
+:::
+
+
diff --git a/docs/src/content/docs/concepts/prompt-syntax.mdx b/docs/src/content/docs/concepts/prompt-syntax.mdx
new file mode 100644
index 00000000000..5d26267c57a
--- /dev/null
+++ b/docs/src/content/docs/concepts/prompt-syntax.mdx
@@ -0,0 +1,138 @@
+---
+title: Prompting Syntax
+lastUpdated: 2026-03-30
+sidebar:
+ order: 3
+---
+
+import { Card, LinkCard, CardGrid } from '@astrojs/starlight/components';
+
+
+
+
+
+
+
+InvokeAI supports Compel-style prompt weighting and prompt functions for `SD 1.5` and `SDXL` text conditioning workflows. Recent model families, including `FLUX`, `Z-Image`, `CogView4`, and `Qwen Image`, bypass Compel and do not use the syntax documented on this page. This page documents syntax for those Compel-based workflows only. If you want general advice on writing better prompts, start with [Prompting Guide](../prompting-guide).
+
+:::note[Compatibility note]
+ If a weighted prompt seems to be ignored, check whether you are using an `SD 1.5` or `SDXL` workflow. Compel syntax on this page does not apply to newer model families such as `FLUX`, `Z-Image`, `CogView4`, and `Qwen Image`.
+:::
+
+## Quick reference
+
+
+ - Increase a single word: `trees+`
+ - Decrease a single word: `fog-`
+ - Weight a phrase: `(golden hour light)+`
+ - Use an exact numeric weight: `(cinematic lighting)1.25`
+ - Nest weights: `(portrait with (blue eyes)1.3)1.1`
+ - Blend prompts: `("portrait photo", "oil painting").blend(0.7, 0.3)`
+ - Conjoin clauses: `("red silk dress", "studio portrait", "soft rim light").and()`
+ - Escape literal parentheses: `colored pencil \(medium\)`
+
+
+## Attention weighting with `+` and `-`
+
+Append `+` to increase influence, or `-` to reduce it.
+
+```text
+freckles+
+background crowd-
+(soft rim light)++
+```
+
+Rules of thumb:
+
+- Single words can be weighted directly.
+- Multi-word phrases should be wrapped in parentheses.
+- Each additional `+` compounds upward.
+- Each additional `-` compounds downward in roughly 10% steps.
+
+:::tip[Start small]
+ One or two steps is usually enough. Extreme weighting can overpower the rest of the prompt.
+:::
+
+## Numeric weights
+
+Use numeric weights when you want precise control instead of repeated plus or minus markers.
+
+```text
+(cinematic lighting)1.25
+(background crowd)0.8
+(sharp focus)1.1
+```
+
+Guidelines:
+
+- `1` is neutral.
+- Values greater than `1` increase emphasis.
+- Values between `0` and `1` reduce emphasis.
+- Wrap the weighted phrase in parentheses.
+
+## Grouping and nesting
+
+You can group phrases and apply weight to the whole group, then nest another weighted phrase inside it.
+
+```text
+(portrait with (blue eyes)1.3)1.1
+```
+
+In this example, the outer group strengthens the whole phrase, and the inner group gives `blue eyes` even more emphasis.
+
+## Blend prompts with `.blend()`
+
+Use `.blend()` to mix the meaning of two or more prompts.
+
+```text
+("portrait photo, 85mm lens", "oil painting, visible brushstrokes").blend(0.7, 0.3)
+```
+
+This is most useful for combining concepts or styles that you want balanced deliberately.
+
+Tips:
+
+- Provide one weight for each prompt argument.
+- Keeping the weights near a total of `1` makes the result easier to reason about.
+- Quoted arguments are the safest choice, especially when the prompts contain commas.
+
+## Combine clauses with `.and()`
+
+Use `.and()` when you want separate prompt clauses encoded individually instead of as one long comma-separated sentence.
+
+```text
+("red silk dress", "studio portrait", "soft rim light").and()
+```
+
+This can behave differently from:
+
+```text
+red silk dress, studio portrait, soft rim light
+```
+
+If a normal prompt keeps collapsing ideas together, `.and()` is worth testing.
+
+## Escape literal parentheses
+
+Unescaped parentheses are treated as prompt syntax. If you want actual parentheses in the text, escape them with backslashes.
+
+```text
+colored pencil \(medium\)
+portrait \(realistic\) (high quality)1.2
+A bear \(with razor-sharp teeth\) in a forest
+```
+
+Use unescaped parentheses only when you mean grouping or weighting.
+
+## Related pages
+
+- For practical prompt-writing advice, read [Prompting Guide](../prompting-guide).
+- For prompt expansion and permutations, read [Dynamic Prompting](../dynamic-prompting).
diff --git a/docs/src/content/docs/concepts/prompting-guide.mdx b/docs/src/content/docs/concepts/prompting-guide.mdx
new file mode 100644
index 00000000000..3dbb27a9fbc
--- /dev/null
+++ b/docs/src/content/docs/concepts/prompting-guide.mdx
@@ -0,0 +1,180 @@
+---
+title: Prompting Guide
+lastUpdated: 2026-03-30
+sidebar:
+ order: 2
+---
+
+import { Card, CardGrid, Steps, LinkCard } from '@astrojs/starlight/components';
+
+
+
+
+
+
+
+Prompting in InvokeAI works best when you describe the image clearly, then refine only the parts that matter. This page focuses on practical prompt-writing habits.
+
+
+
+ Start with the main thing you want to see: a character, object, scene, or action.
+
+
+ Add the visual language: photograph, watercolor, oil painting, 3D render, anime illustration, and so on.
+
+
+ Describe the camera angle, framing, lighting, environment, color palette, or mood that will shape the image.
+
+
+ Add a few high-value quality cues such as fabric texture, shallow depth of field, natural skin texture, or painterly brushwork.
+
+
+
+A simple pattern that works well is:
+
+`subject, style or medium, lighting or composition, a few important details`
+
+Not every prompt needs every category. Start simple, then add detail only when the model needs more direction.
+
+## Positive and negative prompts
+
+
+
+ Use the positive prompt to describe what you want the model to create. Put the most important idea early and keep the wording concrete.
+
+
+ Use the negative prompt to remove recurring problems or unwanted traits. Keep it short and targeted instead of pasting a giant list into every generation.
+
+
+
+Good negative prompts usually name specific failure modes: `blurry`, `distorted hands`, `low detail`, `extra limbs`.
+
+:::tip[Negative prompts are strong]
+ A negative term can suppress nearby concepts too. If you negate something broad like `green` or `moss`, you may also weaken grass, foliage, or other related ideas.
+:::
+
+## A practical prompting workflow
+
+
+ 1. Start with the core image
+
+ Write the clearest version of the image you want before adding stylistic extras.
+
+ 2. Add style and composition
+
+ Once the subject is right, add medium, lens, lighting, mood, background, or framing details.
+
+ 3. Test with a fixed seed
+
+ When you are learning what a prompt change does, keep the seed stable so you can compare results directly.
+
+ 4. Change one thing at a time
+
+ If you add five new terms at once, you will not know which one helped.
+
+ 5. Escalate only when needed
+
+ If the result is close but one element is too weak or too strong, move to [Prompting Syntax](../prompt-syntax) for weighting. If you want lots of variations, use [Dynamic Prompting](../dynamic-prompting).
+
+
+Here is the same idea refined in stages:
+
+```text
+portrait of a woman
+
+portrait of a woman, studio photograph, soft key light
+
+portrait of a woman, studio photograph, soft key light, 85mm lens, shallow depth of field, natural skin texture
+```
+
+## Write for the model you are using
+
+The same prompt can behave very differently across models.
+
+- Photo-oriented models respond well to camera, lens, lighting, and texture language.
+- Illustration models often respond better to medium, art direction, and shape language.
+- Specialty models may expect specific trigger words, subjects, or styles from their own model card.
+- If a prompt works beautifully on one model and poorly on another, that does not always mean the prompt is bad. The model may just speak a different visual language.
+
+## When advanced syntax helps
+
+Reach for advanced syntax when a normal comma-separated prompt is almost right, but you need more control.
+
+- Use [Prompting Syntax](../prompt-syntax) when one term needs more or less influence.
+- Use `.blend()` when you want to mix concepts or styles deliberately.
+- Use `.and()` when you want separate prompt clauses encoded individually.
+- Use [Dynamic Prompting](../dynamic-prompting) when you want many prompt variations from one template.
+
+## Common mistakes
+
+- Packing too many unrelated ideas into one prompt.
+- Using long generic quality-word lists before you know the base prompt works.
+- Treating the negative prompt as a trash can for every bad outcome.
+- Expecting identical behavior across models, schedulers, and workflows.
+- Changing prompt, model, seed, and settings all at once while troubleshooting.
+
+## Example prompts
+
+### Photographic portrait
+
+**Positive prompt**
+
+```text
+editorial portrait of a woman in a charcoal coat, studio photograph, soft key light, subtle rim light, 85mm lens, shallow depth of field, natural skin texture
+```
+
+**Negative prompt**
+
+```text
+blurry, low detail, waxy skin, extra fingers
+```
+
+### Environment concept art
+
+**Positive prompt**
+
+```text
+ancient stone temple built into a cliffside, fantasy concept art, misty sunrise, towering scale, moss-covered stairs, cinematic atmosphere
+```
+
+**Negative prompt**
+
+```text
+flat lighting, low contrast, muddy details
+```
+
+### Product-style render
+
+**Positive prompt**
+
+```text
+sleek ceramic teapot on a matte stone surface, product photography, clean studio lighting, soft shadow, high detail, minimal background
+```
+
+**Negative prompt**
+
+```text
+cluttered background, distortion, duplicate objects
+```
+
+### Stylized illustration
+
+**Positive prompt**
+
+```text
+fox courier crossing a rainy city street, storybook illustration, bold shapes, glowing shop signs, reflective pavement, warm and cool color contrast
+```
+
+**Negative prompt**
+
+```text
+photorealistic, dull colors, low detail
+```
diff --git a/docs/src/content/docs/configuration/assets/cuda-sysmem-fallback.png b/docs/src/content/docs/configuration/assets/cuda-sysmem-fallback.png
new file mode 100755
index 00000000000..f79e007f871
Binary files /dev/null and b/docs/src/content/docs/configuration/assets/cuda-sysmem-fallback.png differ
diff --git a/docs/src/content/docs/configuration/docker.mdx b/docs/src/content/docs/configuration/docker.mdx
new file mode 100644
index 00000000000..591ed38d3ae
--- /dev/null
+++ b/docs/src/content/docs/configuration/docker.mdx
@@ -0,0 +1,95 @@
+---
+title: Docker
+---
+
+import { Aside, Tabs, TabItem } from '@astrojs/starlight/components'
+
+import SystemRequirementsLink from '@components/SystemRequirmentsLink.astro'
+
+
+
+:::note[Operating Systems and GPU Support]
+
+
+ Docker Desktop on Windows [includes GPU support](https://www.docker.com/blog/wsl-2-gpu-support-for-docker-desktop-on-nvidia-gpus/).
+
+
+ Docker can not access the GPU on macOS, so your generation speeds will be slow. Use the [launcher](../../start-here/installation) instead.
+
+
+ Configure Docker to access your machine's GPU.
+ Follow the [NVIDIA](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) or [AMD](https://rocm.docs.amd.com/projects/install-on-linux/en/latest/how-to/docker.html) documentation.
+
+
+:::
+
+## TL;DR
+
+Ensure your Docker setup is able to use your GPU. Then:
+
+```bash
+docker run --runtime=nvidia --gpus=all --publish 9090:9090 ghcr.io/invoke-ai/invokeai
+```
+
+Once the container starts up, open [http://localhost:9090](http://localhost:9090) in your browser, install some models, and start generating.
+
+## Build-It-Yourself
+
+All the docker materials are located inside the [docker](https://github.com/invoke-ai/InvokeAI/tree/main/docker) directory in the Git repo.
+
+```bash
+cd docker
+cp .env.sample .env
+docker compose up
+```
+
+We also ship the `run.sh` convenience script. See the `docker/README.md` file for detailed instructions on how to customize the docker setup to your needs.
+
+### Prerequisites
+
+#### Install [Docker](https://github.com/santisbon/guides#docker)
+
+On the [Docker Desktop app](https://docs.docker.com/get-docker/), go to `Preferences` -> `Resources` -> `Advanced`. Increase the CPUs and Memory to avoid this [Issue](https://github.com/invoke-ai/InvokeAI/issues/342). You may need to increase Swap and Disk image size too.
+
+### Setup
+
+Set up your environment variables. In the `docker` directory, make a copy of `.env.sample` and name it `.env`. Make changes as necessary.
+
+Any environment variables supported by InvokeAI can be set here - please see the [configuration docs](/configuration/invokeai-yaml/) for further detail.
+
+At the very least, you might want to set the `INVOKEAI_ROOT` environment variable
+to point to the location where you wish to store your InvokeAI models, configuration, and outputs.
+
+| Environment Variable | Default value | Description |
+| --- | --- | --- |
+| `INVOKEAI_ROOT` | `~/invokeai` | **Required** - the location of your InvokeAI root directory. It will be created if it does not exist. |
+| `HUGGING_FACE_HUB_TOKEN` | | InvokeAI will work without it, but some of the integrations with HuggingFace (like downloading from models from private repositories) may not work |
+| `GPU_DRIVER` | `cuda` | Optionally change this to `rocm` to build the image for AMD GPUs. NOTE: Use the `build.sh` script to build the image for this to take effect. |
+
+#### Build the Image
+
+Use the standard `docker compose build` command from within the `docker` directory.
+
+If using an AMD GPU:
+a: set the `GPU_DRIVER=rocm` environment variable in `docker-compose.yml` and continue using `docker compose build` as usual, or
+b: set `GPU_DRIVER=rocm` in the `.env` file and use the `build.sh` script, provided for convenience
+
+#### Run the Container
+
+Use the standard `docker compose up` command, and generally the `docker compose` [CLI](https://docs.docker.com/compose/reference/) as usual.
+
+Once the container starts up (and configures the InvokeAI root directory if this is a new installation), you can access InvokeAI at [http://localhost:9090](http://localhost:9090)
+
+## Troubleshooting / FAQ
+
+
+ "I am running Windows under WSL2, and am seeing a 'no such file or directory' error."
+
+ Your `docker-entrypoint.sh` might have has Windows (CRLF) line endings, depending how you cloned the repository.
+ To solve this, change the line endings in the `docker-entrypoint.sh` file to `LF`. You can do this in VSCode
+ (`Ctrl+P` and search for "line endings"), or by using the `dos2unix` utility in WSL.
+ Finally, you may delete `docker-entrypoint.sh` followed by `git pull; git checkout docker/docker-entrypoint.sh`
+ to reset the file to its most recent version.
+ For more information on this issue, see [Docker Desktop documentation](https://docs.docker.com/desktop/troubleshoot/topics/#avoid-unexpected-syntax-errors-use-unix-style-line-endings-for-files-in-containers)
+
+
diff --git a/docs/src/content/docs/configuration/fp8-storage.mdx b/docs/src/content/docs/configuration/fp8-storage.mdx
new file mode 100644
index 00000000000..799821b079e
--- /dev/null
+++ b/docs/src/content/docs/configuration/fp8-storage.mdx
@@ -0,0 +1,128 @@
+---
+title: FP8 Storage
+sidebar:
+ order: 3
+---
+
+import { Steps } from '@astrojs/starlight/components';
+
+FP8 Storage cuts a model's VRAM footprint roughly in half by keeping weights on the GPU in 8-bit floating-point format (`float8_e4m3fn`). During inference, each layer's weights are cast on-the-fly back up to the compute precision (FP16/BF16), then cast back to FP8 after the forward pass — so quality is largely preserved.
+
+It pairs well with [Low-VRAM mode](/configuration/low-vram-mode/): low-VRAM mode streams layers between RAM and VRAM, while FP8 Storage shrinks the layers themselves.
+
+:::caution[For full precision models only]
+FP8 Storage only applies to **full precision** checkpoints (FP16 / BF16 / FP32). It is **silently a no-op** for already-quantized formats — **GGUF**, **NF4**, and **int8** checkpoints carry their own storage precision and the loader returns a different module type that the FP8 layer cast does not touch. If your model is already quantized, the toggle has no effect; use the full-precision variant of the model if you want to enable FP8 Storage.
+:::
+
+## Requirements
+
+- **Nvidia GPU on Windows or Linux.** FP8 Storage uses CUDA tensor types and is silently disabled on CPU and MPS.
+- **CUDA 12.x and recent PyTorch.** The `float8_e4m3fn` dtype was added in PyTorch 2.1 — InvokeAI's bundled versions satisfy this.
+
+There is no hardware requirement for FP8 *compute* — InvokeAI casts back to FP16/BF16 for math. This means FP8 Storage works on GPUs that do not natively support FP8 matmul (e.g. RTX 30-series), at a small per-step throughput cost.
+
+## Hardware support tiers
+
+InvokeAI's FP8 path stores weights in FP8 and casts them back to BF16/FP16 on each forward pass via its own `register_forward_pre_hook` / `register_forward_hook` wrappers (the same skip list as diffusers' `apply_layerwise_casting`, but applied to every `nn.Module` — including diffusers `ModelMixin` subclasses — so it composes correctly with InvokeAI's `CustomLinear` and partial loading). The practical benefit of toggling FP8 Storage depends on what your GPU can do natively. There are three tiers:
+
+### RTX 30-series and older Ampere workstation cards — VRAM win only
+
+The toggle works as advertised: the UNet / transformer drops by roughly 50% on the GPU. Per-step latency is the same or marginally slower because every forward pass adds an FP8 → BF16 cast on entry and a BF16 → FP8 cast on exit. This is the **largest target group**: 3090 owners squeezing FLUX into 24 GB benefit the most.
+
+### RTX 40-series, RTX 50-series, and Hopper — VRAM win today, compute win possible later
+
+These GPUs have native FP8 tensor cores. The toggle still buys you the same ~50% VRAM reduction today, because the forward pass still runs in BF16 — the hook casts weights back up to compute precision before each layer. If InvokeAI later wires up a true FP8 matmul path (e.g. via `torchao`), the same toggle will *also* unlock compute speedups on this hardware. Until then, treat the benefit as "VRAM only, same as Ampere".
+
+### Older CUDA cards — still a VRAM win
+
+`float8_e4m3fn` is a pure storage dtype in PyTorch and works on any CUDA device, so pre-Ampere cards (GTX 16-series, RTX 20-series, etc.) get the same ~50% VRAM reduction as Ampere. There are no native FP8 tensor cores on these GPUs, so the throughput trade-off is the same as on the 30-series: cast in, compute in BF16/FP16, cast back out.
+
+### MPS and CPU — no-op
+
+FP8 Storage is silently disabled on anything that is not CUDA. On CPU PyTorch *technically* supports FP8 dtypes, but the cast operations are software-emulated and end up costing more than the memory savings buy back, so InvokeAI gates the entire path on `device.type == "cuda"`. If you toggle it on CPU or MPS, the loader skips the cast and returns the model unchanged with no log line.
+
+## Enabling FP8 Storage
+
+FP8 Storage is a **per-model setting**, configured from the Model Manager:
+
+
+1. Open the **Model Manager**.
+2. Select a model (Main, ControlNet, or T2I-Adapter).
+3. Under **Default Settings**, toggle **FP8 Storage (Save VRAM)**.
+4. Click **Save**.
+
+
+The setting takes effect on the next load. If the model is already in the cache, InvokeAI evicts the cached copy automatically so the new setting applies — even if a generation is currently using the model (the eviction is deferred until the generation finishes).
+
+:::tip[When to enable]
+ Enable FP8 Storage on large models that don't fit comfortably in VRAM — FLUX dev/Klein, large SDXL checkpoints, ControlNet-XL adapters. For smaller SD1 / SD2 models, the savings are negligible and not worth the small precision trade-off.
+:::
+
+## What FP8 Storage applies to
+
+FP8 Storage is **only** applied to layers where the precision trade-off is acceptable:
+
+| Model type | FP8 applied? |
+| ----------------------------- | -------------------------------------- |
+| Main models (SD1, SD2, SDXL) | Yes |
+| FLUX.1 / FLUX.2 Klein | Yes |
+| ControlNet, T2I-Adapter | Yes |
+| VAE | No — visible decode-quality regression |
+| Text encoders, tokenizers | No — small models, no benefit |
+| Z-Image (any variant) | No — dtype mismatch with skipped layers|
+| LoRA, ControlLoRA | No — patched into base, not run alone |
+
+Within a supported model, **norm layers, position/patch embeddings, and `proj_in`/`proj_out` are skipped** so precision-sensitive tiny learned scalars (e.g. FLUX `RMSNorm.scale`) aren't crushed to FP8. This mirrors the diffusers default skip list.
+
+## Quality trade-offs
+
+FP8 Storage is **near-lossless** for most workloads because:
+
+- Norms and embeddings (the precision-sensitive layers) are skipped.
+- The actual matmul still happens in FP16/BF16 — FP8 is only the on-GPU storage format.
+
+That said, some artifacts have been reported on:
+
+- **VAEs** — never cast (the toggle has no effect on VAE submodels).
+- **Heavy LoRA stacks** — patching is unaffected, but very precision-sensitive LoRAs may show slight drift. Compare a side-by-side if your workflow depends on subtle LoRA behavior.
+
+If you see unexpected quality regressions, disable FP8 Storage on the affected model and re-run.
+
+## Combining with Low-VRAM mode
+
+**FP8 + partial loading**: fully supported. FP8 Storage shrinks the layers; partial loading streams them between RAM and VRAM as needed. Use both on tight VRAM budgets.
+
+(For why FP8 Storage doesn't stack on top of GGUF / NF4 / int8 checkpoints, see the callout at the top of this page.)
+
+## Troubleshooting
+
+### "I toggled FP8 Storage but VRAM usage didn't change"
+
+The cache eviction is immediate for idle models, but **deferred until the next unlock** if the model is mid-generation. Wait for the current generation to finish, then start a new one — the next load will use the new setting.
+
+If VRAM still hasn't dropped:
+
+- Check the InvokeAI log for `FP8 layerwise casting enabled for `. If the line isn't there, the model is on the exclusion list (VAE, text encoder, Z-Image, LoRA — see table above).
+- Confirm you are on CUDA. FP8 Storage is silently disabled on CPU and MPS.
+
+### Quality regression on a specific model
+
+Disable FP8 Storage for that model in Model Manager and reload. If quality is restored, the model has FP8-sensitive layers that fall outside the default skip list. Please open an issue with the model name and a side-by-side comparison.
+
+### "RuntimeError: ... float8_e4m3fn ..."
+
+You're on a PyTorch version that predates FP8 support. Reinstall InvokeAI using the official launcher — the bundled torch version supports FP8.
+
+### Reporting an FP8 issue
+
+If FP8 Storage misbehaves — crash, quality regression, OOM that shouldn't happen — please [open a GitHub issue](https://github.com/invoke-ai/InvokeAI/issues/new/choose) and include:
+
+- **What you did**: the workflow / generation step that triggered the problem, and whether it reproduces every time.
+- **Model**: exact name and variant (e.g. "FLUX.2 Klein 9B Diffusers", "SDXL Base 1.0 single-file"), and whether the file is a full-precision checkpoint or already quantized (GGUF / NF4 / int8).
+- **LoRAs**: whether any LoRAs (or ControlLoRAs) are stacked on the model, and how many.
+- **Other toggles**: Low-VRAM mode on/off, any `cpu_only` text encoder setting, configured VRAM limit.
+- **GPU**: model and VRAM size (e.g. "RTX 3090 24 GB", "RTX 4070 Ti 12 GB").
+- **OS**: Windows or Linux, plus driver / CUDA version if you have it.
+- **Logs**: the InvokeAI log around the failure — in particular the `FP8 layerwise casting enabled for ` line (or its absence) and any traceback.
+
+A side-by-side image comparison (FP8 on vs. FP8 off, same seed) is extremely useful for quality regressions.
diff --git a/docs/src/content/docs/configuration/invokeai-yaml.mdx b/docs/src/content/docs/configuration/invokeai-yaml.mdx
new file mode 100644
index 00000000000..1c79fbf82aa
--- /dev/null
+++ b/docs/src/content/docs/configuration/invokeai-yaml.mdx
@@ -0,0 +1,266 @@
+---
+title: YAML Config
+sidebar:
+ order: 1
+---
+
+import { FileTree } from '@astrojs/starlight/components'
+import SettingsDocs from '@lib/components/SettingsDocs.astro'
+
+Runtime settings, including the location of files and directories, memory usage, and performance, are managed via the `invokeai.yaml` config file or environment variables. A subset of settings may be set via commandline arguments.
+
+Settings sources are used in this order:
+
+- CLI args
+- Environment variables
+- `invokeai.yaml` settings
+- Fallback: defaults
+
+### InvokeAI Root Directory
+
+On startup, InvokeAI searches for its "root" directory. This is the directory that contains models, images, the database, and so on. It also contains a configuration file called `invokeai.yaml`.
+
+
+ - models/
+ - outputs/
+ - databases/
+ - workflow_thumbnails/
+ - style_presets/
+ - nodes/
+ - configs/
+ - invokeai.example.yaml
+ - **invokeai.yaml**
+
+
+InvokeAI searches for the root directory in this order:
+
+1. The `--root ` CLI arg.
+2. The environment variable INVOKEAI_ROOT.
+3. The directory containing the currently active virtual environment.
+4. Fallback: a directory in the current user's home directory named `invokeai`.
+
+### InvokeAI Configuration File
+
+Inside the root directory, we read settings from the `invokeai.yaml` file.
+
+It has two sections - one for internal use and one for user settings:
+
+```yaml
+# Internal metadata - do not edit:
+schema_version: 4.0.2
+
+# Put user settings here - see https://invoke.ai/configuration/invokeai-yaml/:
+host: 0.0.0.0 # serve the app on your local network
+models_dir: D:\invokeai\models # store models on an external drive
+precision: float16 # always use fp16 precision
+```
+
+The settings in this file will override the defaults. You only need
+to change this file if the default for a particular setting doesn't
+work for you.
+
+You'll find an example file next to `invokeai.yaml` that shows the default values.
+
+Some settings, like [Model Marketplace API Keys], require the YAML
+to be formatted correctly. Here is a [basic guide to YAML files].
+
+#### Custom Config File Location
+
+You can use any config file with the `--config` CLI arg. Pass in the path to the `invokeai.yaml` file you want to use.
+
+Note that environment variables will trump any settings in the config file.
+
+#### Model Marketplace API Keys
+
+Some model marketplaces require an API key to download models. You can provide a URL pattern and appropriate token in your `invokeai.yaml` file to provide that API key.
+
+The pattern can be any valid regex (you may need to surround the pattern with quotes):
+
+```yaml
+remote_api_tokens:
+ # Any URL containing `models.com` will automatically use `your_models_com_token`
+ - url_regex: models.com
+ token: your_models_com_token
+ # Any URL matching this contrived regex will use `some_other_token`
+ - url_regex: '^[a-z]{3}whatever.*\.com$'
+ token: some_other_token
+```
+
+The provided token will be added as a `Bearer` token to the network requests to download the model files. As far as we know, this works for all model marketplaces that require authorization.
+
+:::tip[Hugging face Models]
+If you get an error when installing a HF model using a URL instead of repo id, you may need to [set up a HF API token](https://huggingface.co/settings/tokens) and add an entry for it under `remote_api_tokens`. Use `huggingface.co` for `url_regex`.
+:::
+
+#### Model Hashing
+
+Models are hashed during installation, providing a stable identifier for models across all platforms. Hashing is a one-time operation.
+
+```yaml
+hashing_algorithm: blake3_single # default value
+```
+
+You might want to change this setting, depending on your system:
+
+- `blake3_single` (default): Single-threaded - best for spinning HDDs, still OK for SSDs
+- `blake3_multi`: Parallelized, memory-mapped implementation - best for SSDs, terrible for spinning disks
+- `random`: Skip hashing entirely - fastest but of course no hash
+
+During the first startup after upgrading to v4, all of your models will be hashed. This can take a few minutes.
+
+Most common algorithms are supported, like `md5`, `sha256`, and `sha512`. These are typically much, much slower than either of the BLAKE3 variants.
+
+#### Path Settings
+
+These options set the paths of various directories and files used by InvokeAI. Any user-defined paths should be absolute paths.
+
+#### Multi-GPU Generation
+
+On a machine with more than one GPU, InvokeAI can run several generation sessions at the same time — one per GPU — instead of processing the queue one job at a time. Jobs are distributed fairly across users, so a single user's large batch cannot monopolize every GPU while others wait.
+
+This is controlled by the `generation_devices` setting:
+
+```yaml
+generation_devices: auto # default value
+```
+
+| Value | Behavior |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `auto` | Use every available CUDA GPU, running one generation session per GPU concurrently. This is the default. |
+| `[cuda:0,cuda:1]` | Use the specific devices listed, one session per device. Useful for reserving a GPU for other work. |
+| `[cuda:0]` | Use a single specific device. Generation runs serially, as it did before multi-GPU support. |
+| `[]` | Use the first detected device. Generation runs serially, as it did before multi-GPU support. |
+
+Each entry in the list must be one of `cpu`, `cuda`, `mps`, or `cuda:N`, where `N` is a zero-based device number (`cuda:0` is the first GPU, `cuda:1` the second, and so on).
+
+```yaml
+# Use the first and third GPUs, leaving the second free for other tasks
+generation_devices: [cuda:0, cuda:2]
+```
+
+Notes:
+
+- On a system without a CUDA GPU, `auto` resolves to the single best available device (`mps` on Apple Silicon, otherwise `cpu`), so generation runs serially.
+- Each active GPU gets its own model cache, and model weights are duplicated in system RAM for every device. Running many GPUs in parallel therefore increases RAM usage — ensure you have ample system memory before enabling a large device list.
+- Duplicate entries are ignored; `[cuda:0, cuda:0]` is treated as `[cuda:0]`.
+- You can restrict which physical GPUs InvokeAI sees with the `CUDA_VISIBLE_DEVICES` environment variable. When set, `auto` only enumerates the visible subset, and `cuda:N` indices refer to positions within that subset.
+
+During parallel generation, the progress display shows one progress bar per active session, stacked vertically, each disappearing as its session completes.
+
+#### Text Encoder Offload to Idle GPUs
+
+When more than one GPU is configured for generation but not all of them are busy, InvokeAI can run a session's text/prompt encoder on a currently-idle GPU instead of the GPU running its denoise pipeline. This avoids evicting the denoise model from VRAM just to make room for the encoder, and lets the cached encoder be reused across generations — making repeated generations noticeably smoother.
+
+This is controlled by the `offload_text_encoders_to_idle_gpus` setting:
+
+```yaml
+offload_text_encoders_to_idle_gpus: true # default value
+```
+
+| Value | Behavior |
+| ------- | ---------------------------------------------------------------------------------------------------------------- |
+| `true` | Run text encoders on an idle GPU when one is available. This is the default. |
+| `false` | Always run text encoders on the same GPU as the rest of the pipeline (the behavior before this feature existed). |
+
+Notes:
+
+- This has no effect unless at least two `generation_devices` are configured. On a single device — or when every GPU is already busy with its own session — encoders run on the session's own GPU, exactly as if the setting were `false`.
+- It is purely a placement optimization and does not change generated images.
+- A borrowed GPU is used exclusively for the encoder while it runs, so it never interferes with a generation session running on that same GPU.
+
+#### Image Subfolder Strategy
+
+By default, generated images are stored in a single flat directory under `outputs/images/`. The `image_subfolder_strategy` setting lets you organize newly-created images into subfolders automatically. You can edit this setting in `invokeai.yaml` or, as an admin user, in the Settings panel.
+
+```yaml
+image_subfolder_strategy: flat # default value
+```
+
+Available strategies:
+
+| Strategy | Example Path | Description |
+| -------- | -------------------------------------- | ------------------------------------------------------------------------------------------------- |
+| `flat` | `outputs/images/abc123.png` | Store images directly in the images directory. |
+| `date` | `outputs/images/2026/03/17/abc123.png` | Organize images by creation date. |
+| `type` | `outputs/images/general/abc123.png` | Organize images by image category. |
+| `hash` | `outputs/images/ab/abc123.png` | Use the first two characters of the image UUID for filesystem performance with large collections. |
+
+Changing this setting only affects newly-created images. Existing images remain in their current locations.
+
+#### Logging
+
+Several different log handler destinations are available, and multiple destinations are supported by providing a list:
+
+```yaml
+log_handlers:
+ - console
+ - syslog=localhost
+ - file=/var/log/invokeai.log
+```
+
+- `console` is the default. It prints log messages to the command-line window from which InvokeAI was launched.
+
+- `syslog` is only available on Linux and Macintosh systems. It uses
+ the operating system's "syslog" facility to write log file entries
+ locally or to a remote logging machine. `syslog` offers a variety
+ of configuration options:
+
+```yaml
+syslog=/dev/log` - log to the /dev/log device
+syslog=localhost` - log to the network logger running on the local machine
+syslog=localhost:512` - same as above, but using a non-standard port
+syslog=fredserver,facility=LOG_USER,socktype=SOCK_DRAM`
+- Log to LAN-connected server "fredserver" using the facility LOG_USER and datagram packets.
+```
+
+- `http` can be used to log to a remote web server. The server must be
+ properly configured to receive and act on log messages. The option
+ accepts the URL to the web server, and a `method` argument
+ indicating whether the message should be submitted using the GET or
+ POST method.
+
+```yaml
+http=http://my.server/path/to/logger,method=POST
+```
+
+The `log_format` option provides several alternative formats:
+
+- `color` - default format providing time, date and a message, using text colors to distinguish different log severities
+- `plain` - same as above, but monochrome text only
+- `syslog` - the log level and error message only, allowing the syslog system to attach the time and date
+- `legacy` - a format similar to the one used by the legacy 2.3 InvokeAI releases.
+
+### Environment Variables
+
+All settings may be set via environment variables by prefixing `INVOKEAI_`
+to the variable name. For example, `INVOKEAI_HOST` would set the `host`
+setting.
+
+For non-primitive values, pass a JSON-encoded string:
+
+```sh
+export INVOKEAI_REMOTE_API_TOKENS='[{"url_regex":"modelmarketplace", "token": "12345"}]'
+```
+
+We suggest using `invokeai.yaml`, as it is more user-friendly.
+
+### CLI Args
+
+A subset of settings may be specified using CLI args:
+
+- `--root`: specify the root directory
+- `--config`: override the default `invokeai.yaml` file location
+
+### Low-VRAM Mode
+
+See the [Low-VRAM mode docs][low-vram] for details on enabling this feature.
+
+### All Settings
+
+The full settings reference is below. Additional explanations for selected settings appear earlier on this page.
+
+
+
+[basic guide to yaml files]: https://circleci.com/blog/what-is-yaml-a-beginner-s-guide/
+[Model Marketplace API Keys]: #model-marketplace-api-keys
+[low-vram]: /configuration/low-vram-mode
diff --git a/docs/src/content/docs/configuration/low-vram-mode.mdx b/docs/src/content/docs/configuration/low-vram-mode.mdx
new file mode 100644
index 00000000000..fa15cef8735
--- /dev/null
+++ b/docs/src/content/docs/configuration/low-vram-mode.mdx
@@ -0,0 +1,182 @@
+---
+title: Low-VRAM mode
+sidebar:
+ order: 2
+---
+
+As of v5.6.0, Invoke has a low-VRAM mode. It works on systems with dedicated GPUs (Nvidia GPUs on Windows/Linux and AMD GPUs on Linux).
+
+This allows you to generate even if your GPU doesn't have enough VRAM to hold full models. Most users should be able to run even the beefiest models - like the ~24GB unquantised FLUX dev model.
+
+## Enabling Low-VRAM mode
+
+Low-VRAM mode is **enabled by default** via the `enable_partial_loading: true` setting in `invokeai.yaml`. No action is required to turn it on.
+
+**Windows users should also [disable the Nvidia sysmem fallback](#disabling-nvidia-sysmem-fallback-windows-only)**.
+
+It is possible to fine-tune the settings for best performance or if you still get out-of-memory errors (OOMs).
+
+If you want to disable partial loading (e.g. on systems with plenty of VRAM where full loading is faster), add this line to your `invokeai.yaml` and restart Invoke:
+
+```yaml
+enable_partial_loading: false
+```
+
+:::tip[How to find `invokeai.yaml`]
+ The `invokeai.yaml` configuration file lives in your install directory. To access it, run the **Invoke Community Edition** launcher and click the install location. This will open your install directory in a file explorer window.
+
+ You'll see `invokeai.yaml` there and can edit it with any text editor. After making changes, restart Invoke.
+
+ If you don't see `invokeai.yaml`, launch Invoke once. It will create the file on its first startup.
+:::
+
+## Details and fine-tuning
+
+Low-VRAM mode involves 4 features, each of which can be configured or fine-tuned:
+
+- Partial model loading (`enable_partial_loading`)
+- PyTorch CUDA allocator config (`pytorch_cuda_alloc_conf`)
+- Dynamic RAM and VRAM cache sizes (`max_cache_ram_gb`, `max_cache_vram_gb`)
+- Working memory (`device_working_mem_gb`)
+- Keeping a RAM weight copy (`keep_ram_copy_of_weights`)
+
+Read on to learn about these features and understand how to fine-tune them for your system and use-cases.
+
+### Partial model loading
+
+Invoke's partial model loading works by streaming model "layers" between RAM and VRAM as they are needed.
+
+When an operation needs layers that are not in VRAM, but there isn't enough room to load them, inactive layers are offloaded to RAM to make room.
+
+#### Enabling partial model loading
+
+Partial model loading is enabled by default. The corresponding setting in `invokeai.yaml` is:
+
+```yaml
+enable_partial_loading: true
+```
+
+Set it to `false` to disable partial loading.
+
+### PyTorch CUDA allocator config
+
+The PyTorch CUDA allocator's behavior can be configured using the `pytorch_cuda_alloc_conf` config. Tuning the allocator configuration can help to reduce the peak reserved VRAM. The optimal configuration is dependent on many factors (e.g. device type, VRAM, CUDA driver version, etc.), but switching from PyTorch's native allocator to using CUDA's built-in allocator works well on many systems. To try this, add the following line to your `invokeai.yaml` file:
+
+```yaml
+pytorch_cuda_alloc_conf: "backend:cudaMallocAsync"
+```
+
+A more complete explanation of the available configuration options is [here](https://pytorch.org/docs/stable/notes/cuda.html#optimizing-memory-usage-with-pytorch-cuda-alloc-conf).
+
+### Dynamic RAM and VRAM cache sizes
+
+Loading models from disk is slow and can be a major bottleneck for performance. Invoke uses two model caches - RAM and VRAM - to reduce loading from disk to a minimum.
+
+By default, Invoke manages these caches' sizes dynamically for best performance.
+
+#### Fine-tuning cache sizes
+
+Prior to v5.6.0, the cache sizes were static, and for best performance, many users needed to manually fine-tune the `ram` and `vram` settings in `invokeai.yaml`.
+
+As of v5.6.0, the caches are dynamically sized. The `ram` and `vram` settings are no longer used, and new settings are added to configure the cache.
+
+**Most users will not need to fine-tune the cache sizes.**
+
+But, if your GPU has enough VRAM to hold models fully, you might get a perf boost by manually setting the cache sizes in `invokeai.yaml`:
+
+```yaml
+# The default max cache RAM size is logged on InvokeAI startup. It is determined based on your system RAM / VRAM.
+# You can override the default value by setting `max_cache_ram_gb`.
+# Increasing `max_cache_ram_gb` will increase the amount of RAM used to cache inactive models, resulting in faster model
+# reloads for the cached models.
+# As an example, if your system has 32GB of RAM and no other heavy processes, setting the `max_cache_ram_gb` to 28GB
+# might be a good value to achieve aggressive model caching.
+max_cache_ram_gb: 28
+
+# The default max cache VRAM size is adjusted dynamically based on the amount of available VRAM (taking into
+# consideration the VRAM used by other processes).
+# You can override the default value by setting `max_cache_vram_gb`.
+# CAUTION: Most users should not manually set this value. See warning below.
+max_cache_vram_gb: 16
+```
+
+:::caution[Max safe value for `max_cache_vram_gb`]
+ Most users should not manually configure the `max_cache_vram_gb`. This configuration value takes precedence over the `device_working_mem_gb` and any operations that explicitly reserve additional working memory (e.g. VAE decode). As such, manually configuring it increases the likelihood of encountering out-of-memory errors.
+
+ For users who wish to configure `max_cache_vram_gb`, the max safe value can be determined by subtracting `device_working_mem_gb` from your GPU's VRAM. As described below, the default for `device_working_mem_gb` is 3GB.
+
+ For example, if you have a 12GB GPU, the max safe value for `max_cache_vram_gb` is `12GB - 3GB = 9GB`.
+
+ If you had increased `device_working_mem_gb` to 4GB, then the max safe value for `max_cache_vram_gb` is `12GB - 4GB = 8GB`.
+
+ Most users who override `max_cache_vram_gb` are doing so because they wish to use significantly less VRAM, and should be setting `max_cache_vram_gb` to a value significantly less than the 'max safe value'.
+:::
+
+### Working memory
+
+Invoke cannot use _all_ of your VRAM for model caching and loading. It requires some VRAM to use as working memory for various operations.
+
+Invoke reserves 3GB VRAM as working memory by default, which is enough for most use-cases. However, it is possible to fine-tune this setting if you still get OOMs.
+
+#### Fine-tuning working memory
+
+You can increase the working memory size in `invokeai.yaml` to prevent OOMs:
+
+```yaml
+# The default is 3GB - bump it up to 4GB to prevent OOMs.
+device_working_mem_gb: 4
+```
+
+:::tip[Operations may request more working memory]
+ For some operations, we can determine VRAM requirements in advance and allocate additional working memory to prevent OOMs.
+
+ VAE decoding is one such operation. This operation converts the generation process's output into an image. For large image outputs, this might use more than the default working memory size of 3GB.
+
+ During this decoding step, Invoke calculates how much VRAM will be required to decode and requests that much VRAM from the model manager. If the amount exceeds the working memory size, the model manager will offload cached model layers from VRAM until there's enough VRAM to decode.
+
+ Once decoding completes, the model manager "reclaims" the extra VRAM allocated as working memory for future model loading operations.
+:::
+
+### Keeping a RAM weight copy
+
+Invoke has the option of keeping a RAM copy of all model weights, even when they are loaded onto the GPU. This optimization is _on_ by default, and enables faster model switching and LoRA patching. Disabling this feature will reduce the average RAM load while running Invoke (peak RAM likely won't change), at the cost of slower model switching and LoRA patching. If you have limited RAM, you can disable this optimization:
+
+```yaml
+# Set to false to reduce the average RAM usage at the cost of slower model switching and LoRA patching.
+keep_ram_copy_of_weights: false
+```
+
+### Disabling Nvidia sysmem fallback (Windows only)
+
+On Windows, Nvidia GPUs are able to use system RAM when their VRAM fills up via **sysmem fallback**. While it sounds like a good idea on the surface, in practice it causes massive slowdowns during generation.
+
+It is strongly suggested to disable this feature:
+
+- Open the **NVIDIA Control Panel** app.
+- Expand **3D Settings** on the left panel.
+- Click **Manage 3D Settings** in the left panel.
+- Find **CUDA - Sysmem Fallback Policy** in the right panel and set it to **Prefer No Sysmem Fallback**.
+
+
+
+:::tip[Invoke does the same thing, but better]
+ If the sysmem fallback feature sounds familiar, that's because Invoke's partial model loading strategy is conceptually very similar - use VRAM when there's room, else fall back to RAM.
+
+ Unfortunately, the Nvidia implementation is not optimized for applications like Invoke and does more harm than good.
+:::
+
+## Troubleshooting
+
+### Windows page file
+
+Invoke has high virtual memory (a.k.a. 'committed memory') requirements. This can cause issues on Windows if the page file size limits are hit. (See this issue for the technical details on why this happens: https://github.com/invoke-ai/InvokeAI/issues/7563).
+
+If you run out of page file space, InvokeAI may crash. Often, these crashes will happen with one of the following errors:
+
+- InvokeAI exits with Windows error code `3221225477`
+- InvokeAI crashes without an error, but `eventvwr.msc` reveals an error with code `0xc0000005` (the hex equivalent of `3221225477`)
+
+If you are running out of page file space, try the following solutions:
+
+- Make sure that you have sufficient disk space for the page file to grow. Watch your disk usage as Invoke runs. If it climbs near 100% leading up to the crash, then this is very likely the source of the issue. Clear out some disk space to resolve the issue.
+- Make sure that your page file is set to "System managed size" (this is the default) rather than a custom size. Under the "System managed size" policy, the page file will grow dynamically as needed.
diff --git a/docs/src/content/docs/configuration/patchmatch.mdx b/docs/src/content/docs/configuration/patchmatch.mdx
new file mode 100644
index 00000000000..a91e1a8f8b7
--- /dev/null
+++ b/docs/src/content/docs/configuration/patchmatch.mdx
@@ -0,0 +1,126 @@
+---
+title: Patchmatch
+---
+
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components'
+
+PatchMatch is an algorithm used to infill images. It can greatly improve outpainting results. PyPatchMatch is a python wrapper around a C++ implementation of the algorithm.
+
+It uses the image data around the target area as a reference to generate new image data of a similar character and quality.
+
+## Why Use PatchMatch
+
+In the context of image generation, "outpainting" refers to filling in a transparent area using AI-generated image data. But the AI can't generate without some initial data. We need to first fill in the transparent area with _something_.
+
+The first step in "outpainting" then, is to fill in the transparent area with something. Generally, you get better results when that initial infill resembles the rest of the image.
+
+Because PatchMatch generates image data so similar to the rest of the image, it works very well as the first step in outpainting, typically producing better results than other infill methods supported by Invoke (e.g. LaMA, cv2 infill, random tiles).
+
+### Performance Caveat
+
+PatchMatch is CPU-bound, and the amount of time it takes increases proportionally as the infill area increases. While the numbers certainly vary depending on system specs, you can expect a noticeable slowdown once you start infilling areas around 512x512 pixels. 1024x1024 pixels can take several seconds to infill.
+
+## Installation
+
+Unfortunately, installation can be somewhat challenging, as it requires some things that `pip` cannot install for you.
+
+
+ 1. Ensure you have the necessary dependencies installed for your system (see below).
+
+
+
+ You're in luck! On Windows platforms PyPatchMatch will install automatically on Windows systems with no extra intervention.
+
+
+ You need to have opencv installed so that pypatchmatch can be built:
+
+ ```bash
+ brew install opencv
+ ```
+
+ The next time you start `invoke`, after successfully installing opencv, pypatchmatch will be built.
+
+
+ Prior to installing PyPatchMatch, you need to take the following steps:
+
+
+
+
+ 1. Install the `build-essential` tools:
+
+ ```sh
+ sudo apt update # Update package lists
+ sudo apt install build-essential
+ ```
+
+ 2. Install `opencv`:
+
+ ```sh
+ sudo apt install python3-opencv libopencv-dev
+ ```
+
+ 3. Activate the environment you use for invokeai, either with `conda` or with a virtual environment.
+
+
+
+
+ 1. Install the `base-devel` package:
+
+ ```sh
+ sudo pacman -Syu
+ sudo pacman -S --needed base-devel
+ ```
+
+ 2. Install `opencv`, `blas`, and required dependencies:
+
+ ```sh
+ sudo pacman -S opencv blas fmt glew vtk hdf5
+ ```
+
+ or for CUDA support
+
+ ```sh
+ sudo pacman -S opencv-cuda blas fmt glew vtk hdf5
+ ```
+
+ 3. Fix the naming of the `opencv` package configuration file:
+
+ ```sh
+ cd /usr/lib/pkgconfig/
+ ln -sf opencv4.pc opencv.pc
+ ```
+
+
+
+
+
+
+ 2. Install pypatchmatch:
+
+ ```sh
+ pip install pypatchmatch
+ ```
+
+ 3. Confirm that pypatchmatch is installed. At the command-line prompt enter `python`, and then at the `>>>` line type `from patchmatch import patch_match`: It should look like the following:
+
+ ```py
+ Python 3.12.3 (main, Aug 14 2025, 17:47:21) [GCC 13.3.0] on linux
+ Type "help", "copyright", "credits" or "license" for more information.
+ >>> from patchmatch import patch_match
+ Compiling and loading c extensions from "/home/lstein/Projects/InvokeAI/.invokeai-env/src/pypatchmatch/patchmatch".
+ rm -rf build/obj libpatchmatch.so
+ mkdir: created directory 'build/obj'
+ mkdir: created directory 'build/obj/csrc/'
+ [dep] csrc/masked_image.cpp ...
+ [dep] csrc/nnf.cpp ...
+ [dep] csrc/inpaint.cpp ...
+ [dep] csrc/pyinterface.cpp ...
+ [CC] csrc/pyinterface.cpp ...
+ [CC] csrc/inpaint.cpp ...
+ [CC] csrc/nnf.cpp ...
+ [CC] csrc/masked_image.cpp ...
+ [link] libpatchmatch.so ...
+ ```
+
+ If you're not seeing any errors, you're ready to go!
+
diff --git a/docs/src/content/docs/contributing/code-of-conduct.md b/docs/src/content/docs/contributing/code-of-conduct.md
new file mode 100644
index 00000000000..8ada3a81b9b
--- /dev/null
+++ b/docs/src/content/docs/contributing/code-of-conduct.md
@@ -0,0 +1,130 @@
+---
+title: Code of Conduct
+---
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+ and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+ overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+ advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+ address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior
+may be reported to the community leaders responsible for enforcement
+at https://github.com/invoke-ai/InvokeAI/issues. All complaints will
+be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.
diff --git a/docs/src/content/docs/contributing/contributors.md b/docs/src/content/docs/contributing/contributors.md
new file mode 100644
index 00000000000..eb57feb295e
--- /dev/null
+++ b/docs/src/content/docs/contributing/contributors.md
@@ -0,0 +1,54 @@
+---
+title: Contributors
+---
+
+We thank [all contributors](https://github.com/invoke-ai/InvokeAI/graphs/contributors) for their time and hard work!
+
+## Original Author
+
+- [Lincoln D. Stein](mailto:lincoln.stein@gmail.com)
+
+## Current Core Team
+
+- [@lstein](https://github.com/lstein) (Lincoln Stein) - Co-maintainer
+- [@blessedcoolant](https://github.com/blessedcoolant) - Co-maintainer
+- [@hipsterusername](https://github.com/hipsterusername) (Kent Keirsey) - Co-maintainer, CEO, Positive Vibes
+- [@psychedelicious](https://github.com/psychedelicious) (Spencer Mabrito) - Web Team Leader
+- [@joshistoast](https://github.com/joshistoast) (Josh Corbett) - Web Development
+- [@cheerio](https://github.com/cheerio) (Mary Rogers) - Lead Engineer & Web App Development
+- [@ebr](https://github.com/ebr) (Eugene Brodsky) - Cloud/DevOps/Software engineer; your friendly neighbourhood cluster-autoscaler
+- [@sunija](https://github.com/sunija) - Standalone version
+- [@brandon](https://github.com/brandon) (Brandon Rising) - Platform, Infrastructure, Backend Systems
+- [@ryanjdick](https://github.com/ryanjdick) (Ryan Dick) - Machine Learning & Training
+- [@JPPhoto](https://github.com/JPPhoto) - Core image generation nodes
+- [@dunkeroni](https://github.com/dunkeroni) - Image generation backend
+- [@SkunkWorxDark](https://github.com/SkunkWorxDark) - Image generation backend
+- [@glimmerleaf](https://github.com/glimmerleaf) (Devon Hopkins) - Community Wizard
+- [@gogurt](https://github.com/gogurt) enjoyer - Discord moderator and end user support
+- [@whosawhatsis](https://github.com/whosawhatsis) - Discord moderator and end user support
+- [@dwringer](https://github.com/dwringer) - Discord moderator and end user support
+- [@526christian](https://github.com/526christian) - Discord moderator and end user support
+- [@harvester62](https://github.com/harvester62) - Discord moderator and end user support
+
+## Honored Team Alumni
+
+- [@StAlKeR7779](https://github.com/StAlKeR7779) (Sergey Borisov) - Torch stack, ONNX, model management, optimization
+- [@damian0815](https://github.com/damian0815) - Attention Systems and Compel Maintainer
+- [@netsvetaev](https://github.com/netsvetaev) (Artur) - Localization support
+- [@Kyle0654](https://github.com/Kyle0654) (Kyle Schouviller) - Node Architect and General Backend Wizard
+- [@tildebyte](https://github.com/tildebyte) - Installation and configuration
+- [@mauwii](https://github.com/mauwii) (Matthias Wilde) - Installation, release, continuous integration
+- [@chainchompa](https://github.com/chainchompa) (Jennifer Player) - Web Development & Chain-Chomping
+- [@millu](https://github.com/millu) (Millun Atluri) - Community Wizard, Documentation, Node-wrangler,
+- [@genomancer](https://github.com/genomancer) (Gregg Helt) - Controlnet support
+- [@keturn](https://github.com/keturn) (Kevin Turner) - Diffusers
+
+## Original CompVis (Stable Diffusion) Authors
+
+- [Robin Rombach](https://github.com/rromb)
+- [Patrick von Platen](https://github.com/patrickvonplaten)
+- [ablattmann](https://github.com/ablattmann)
+- [Patrick Esser](https://github.com/pesser)
+- [owenvincent](https://github.com/owenvincent)
+- [apolinario](https://github.com/apolinario)
+- [Charles Packer](https://github.com/cpacker)
diff --git a/docs/src/content/docs/contributing/external-providers.md b/docs/src/content/docs/contributing/external-providers.md
new file mode 100644
index 00000000000..13dfd2df5b3
--- /dev/null
+++ b/docs/src/content/docs/contributing/external-providers.md
@@ -0,0 +1,131 @@
+---
+title: External Provider Integration
+---
+
+This guide covers:
+
+1. Adding a new **external model** (most common; existing provider).
+2. Adding a brand-new **external provider** (adapter + config + UI wiring).
+
+## 1) Add a New External Model (Existing Provider)
+
+For provider-backed models (for example, OpenAI or Gemini), the source of truth is
+`invokeai/backend/model_manager/starter_models.py`.
+
+### Required model fields
+
+Define a `StarterModel` with:
+
+- `base=BaseModelType.External`
+- `type=ModelType.ExternalImageGenerator`
+- `format=ModelFormat.ExternalApi`
+- `source="external:///"`
+- `name`, `description`
+- `capabilities=ExternalModelCapabilities(...)`
+- optional `default_settings=ExternalApiModelDefaultSettings(...)`
+
+Example:
+
+```python
+new_external_model = StarterModel(
+ name="Provider Model Name",
+ base=BaseModelType.External,
+ source="external://openai/my-model-id",
+ description=(
+ "Provider model (external API). "
+ "Requires a configured OpenAI API key and may incur provider usage costs."
+ ),
+ type=ModelType.ExternalImageGenerator,
+ format=ModelFormat.ExternalApi,
+ capabilities=ExternalModelCapabilities(
+ modes=["txt2img", "img2img", "inpaint"],
+ supports_negative_prompt=False,
+ supports_seed=False,
+ supports_guidance=False,
+ supports_steps=False,
+ supports_reference_images=True,
+ max_images_per_request=4,
+ ),
+ default_settings=ExternalApiModelDefaultSettings(
+ width=1024,
+ height=1024,
+ num_images=1,
+ ),
+)
+```
+
+Then append it to `STARTER_MODELS`.
+
+### Required description text
+
+External starter model descriptions must clearly state:
+
+- an API key is required
+- usage may incur provider-side costs
+
+### Capabilities must be accurate
+
+These flags directly control UI visibility and request payload fields:
+
+- `supports_negative_prompt`
+- `supports_seed`
+- `supports_guidance`
+- `supports_steps`
+- `supports_reference_images`
+
+`supports_steps` is especially important: if `False`, steps are hidden for that model and `steps` is sent as `null`.
+
+### Source string stability
+
+Starter overrides are matched by `source` (`external://provider/model-id`). Keep this stable:
+
+- runtime capability/default overrides depend on it
+- installation detection in starter-model APIs depends on it
+
+`STARTER_MODELS` enforces unique `source` values with an assertion.
+
+### Install behavior notes
+
+- External starter models are managed in **External Providers** setup (not the regular Starter Models tab).
+- External starter models auto-install when a provider is configured.
+- Removing a provider API key removes installed external models for that provider.
+
+## 2) Credentials and Config
+
+External provider API keys are stored separately from `invokeai.yaml`:
+
+- default file: `~/invokeai/api_keys.yaml`
+- resolved path: `/api_keys.yaml`
+
+Non-secret provider settings (for example base URL overrides) stay in `invokeai.yaml`.
+
+Environment variables are still supported, e.g.:
+
+- `INVOKEAI_EXTERNAL_GEMINI_API_KEY`
+- `INVOKEAI_EXTERNAL_OPENAI_API_KEY`
+
+## 3) Add a New Provider (Only If Needed)
+
+If your model uses a provider that is not already integrated:
+
+1. Add config fields in `invokeai/app/services/config/config_default.py`
+ `external__api_key` and optional `external__base_url`.
+2. Add provider field mapping in `invokeai/app/api/routers/app_info.py`
+ (`EXTERNAL_PROVIDER_FIELDS`).
+3. Implement provider adapter in `invokeai/app/services/external_generation/providers/`
+ by subclassing `ExternalProvider`.
+4. Register the provider in `invokeai/app/api/dependencies.py` when building
+ `ExternalGenerationService`.
+5. Add starter model entries using `source="external:///"`.
+6. Optional UI ordering tweak:
+ `invokeai/frontend/web/src/features/modelManagerV2/subpanels/AddModelPanel/ExternalProviders/ExternalProvidersForm.tsx`
+ (`PROVIDER_SORT_ORDER`).
+
+## 4) Optional Manual Installation
+
+You can also install external models directly via:
+
+`POST /api/v2/models/install?source=external:///`
+
+If omitted, `path`, `source`, and `hash` are auto-populated for external model configs.
+Set capabilities conservatively; the external generation service enforces capability checks at runtime.
diff --git a/docs/src/content/docs/contributing/index.md b/docs/src/content/docs/contributing/index.md
new file mode 100644
index 00000000000..e4da6da1746
--- /dev/null
+++ b/docs/src/content/docs/contributing/index.md
@@ -0,0 +1,56 @@
+---
+title: Contributing to InvokeAI
+sidebar:
+ order: 1
+---
+
+Invoke originated as a project built by the community, and that vision carries forward today as we aim to build the best pro-grade tools available. We work together to incorporate the latest in AI/ML research, making these tools available in over 20 languages to artists and creatives around the world as part of our fully permissive OSS project designed for individual users to self-host and use.
+
+We welcome contributions, whether features, bug fixes, code cleanup, testing, code reviews, documentation or translation. Please check in with us before diving in to code to ensure your work aligns with our vision.
+
+## Development
+
+If you’d like to help with development, please see our [development guide](/development/).
+
+**New Contributors:** If you’re unfamiliar with contributing to open source projects, take a look at our [new contributor guide](/contributing/new-contributor-guide/).
+
+## Nodes
+
+If you’d like to add a Node, please see our [nodes contribution guide](/development/guides/creating-nodes/).
+
+## Support and Triaging
+
+Helping support other users in [Discord](https://discord.gg/ZmtBAhwWhy) and on Github are valuable forms of contribution that we greatly appreciate.
+
+We receive many issues and requests for help from users. We're limited in bandwidth relative to our the user base, so providing answers to questions or helping identify causes of issues is very helpful. By doing this, you enable us to spend time on the highest priority work.
+
+## Documentation
+
+If you’d like to help with documentation, please see our [contributing guide](/contributing/).
+
+## Translation
+
+If you'd like to help with translation, please see our [translation guide](/contributing/translations/).
+
+## Tutorials
+
+Please reach out to @hipsterusername on [Discord](https://discord.gg/ZmtBAhwWhy) to help create tutorials for InvokeAI.
+
+## Contributors
+
+This project is a combined effort of dedicated people from across the world. [Check out the list of all these amazing people](/contributing/contributors/). We thank them for their time, hard work and effort.
+
+## Code of Conduct
+
+The InvokeAI community is a welcoming place, and we want your help in maintaining that. Please review our [Code of Conduct](/contributing/code-of-conduct/) to learn more - it's essential to maintaining a respectful and inclusive environment.
+
+By making a contribution to this project, you certify that:
+
+1. The contribution was created in whole or in part by you and you have the right to submit it under the open-source license indicated in this project’s GitHub repository; or
+2. The contribution is based upon previous work that, to the best of your knowledge, is covered under an appropriate open-source license and you have the right under that license to submit that work with modifications, whether created in whole or in part by you, under the same open-source license (unless you are permitted to submit under a different license); or
+3. The contribution was provided directly to you by some other person who certified (1) or (2) and you have not modified it; or
+4. You understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information you submit with it, including your sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open-source license(s) involved.
+
+This disclaimer is not a license and does not grant any rights or permissions. You must obtain necessary permissions and licenses, including from third parties, before contributing to this project.
+
+This disclaimer is provided "as is" without warranty of any kind, whether expressed or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, or non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the contribution or the use or other dealings in the contribution.
diff --git a/docs/src/content/docs/contributing/new-contributor-guide.mdx b/docs/src/content/docs/contributing/new-contributor-guide.mdx
new file mode 100644
index 00000000000..d5d29a36d0a
--- /dev/null
+++ b/docs/src/content/docs/contributing/new-contributor-guide.mdx
@@ -0,0 +1,105 @@
+---
+title: New Contributor Guide
+lastUpdated: 2026-02-19
+---
+
+import { Steps, LinkCard } from '@astrojs/starlight/components';
+
+If you're a new contributor to InvokeAI or Open Source Projects, this is the guide for you.
+
+## New Contributor Checklist
+
+
+ 1. Set up your local development environment & fork of InvokAI by following [the steps outlined here](../../development/setup/dev-environment/#initial-setup)
+
+ 2. Set up your local tooling with [this guide](/development/). Feel free to skip this step if you already have tooling you're comfortable with.
+
+ 3. Familiarize yourself with [Git](https://www.atlassian.com/git) & our project structure by reading through the [development documentation](/development/)
+
+ 4. Join the [#dev-chat](https://discord.com/channels/1020123559063990373/1049495067846524939) channel of the Discord
+
+ 5. Choose an issue to work on! This can be achieved by asking in the #dev-chat channel, tackling a [good first issue](https://github.com/invoke-ai/InvokeAI/contribute) or finding an item on the [roadmap](https://github.com/orgs/invoke-ai/projects/7). If nothing in any of those places catches your eye, feel free to work on something of interest to you!
+
+ 6. Make your first Pull Request with the guide below
+
+ 7. Happy development! Don't be afraid to ask for help - we're happy to help you contribute!
+
+
+## How do I make a contribution?
+
+Never made an open source contribution before? Wondering how contributions work in our project? Here's a quick rundown!
+
+Before starting these steps, ensure you have your local environment [configured for development](/development/setup/dev-environment/).
+
+
+ 1. Find a [good first issue](https://github.com/invoke-ai/InvokeAI/contribute) that you are interested in addressing or a feature that you would like to add. Then, reach out to our team in the [#dev-chat](https://discord.com/channels/1020123559063990373/1049495067846524939) channel of the Discord to ensure you are setup for success.
+
+ 2. Fork the [InvokeAI](https://github.com/invoke-ai/InvokeAI) repository to your GitHub profile. This means that you will have a copy of the repository under **your-GitHub-username/InvokeAI**.
+
+ 3. Clone the repository to your local machine using:
+
+ ```bash
+ git clone https://github.com/your-GitHub-username/InvokeAI.git
+ ```
+
+ If you're unfamiliar with using Git through the commandline, [GitHub Desktop](https://desktop.github.com) is a easy-to-use alternative with a UI. You can do all the same steps listed here, but through the interface. 4. Create a new branch for your fix using:
+
+ ```bash
+ git checkout -b branch-name-here
+ ```
+
+ 5. Make the appropriate changes for the issue you are trying to address or the feature that you want to add.
+
+ 6. Add the file contents of the changed files to the "snapshot" git uses to manage the state of the project, also known as the index:
+
+ ```bash
+ git add -A
+ ```
+
+ 7. Store the contents of the index with a descriptive message.
+
+ ```bash
+ git commit -m "Insert a short message of the changes made here"
+ ```
+
+ 8. Push the changes to the remote repository using
+
+ ```bash
+ git push origin branch-name-here
+ ```
+
+ 9. Submit a pull request to the **main** branch of the InvokeAI repository. If you're not sure how to, [follow this guide](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
+
+ 10. Title the pull request with a short description of the changes made and the issue or bug number associated with your change. For example, you can title an issue like so "Added more log outputting to resolve #1234".
+
+ 11. In the description of the pull request, explain the changes that you made, any issues you think exist with the pull request you made, and any questions you have for the maintainer. It's OK if your pull request is not perfect (no pull request is), the reviewer will be able to help you fix any problems and improve it!
+
+ 12. Wait for the pull request to be reviewed by other collaborators.
+
+ 13. Make changes to the pull request if the reviewer(s) recommend them.
+
+ 14. Celebrate your success after your pull request is merged!
+
+
+
+
+:::tip[Best Practices]
+
+- Keep your pull requests small. Smaller pull requests are more likely to be accepted and merged.
+- Comments! Commenting your code helps reviewers easily understand your contribution.
+- Use Python and Typescript’s typing systems, and consider using an editor with [LSP](https://microsoft.github.io/language-server-protocol/) support to streamline development.
+- Make all communications public. This ensure knowledge is shared with the whole community.
+
+:::
+
+## **Where can I go for help?**
+
+If you need help, you can ask questions in the [#dev-chat](https://discord.com/channels/1020123559063990373/1049495067846524939) channel of the Discord.
+
+For frontend related work, **@pyschedelicious** is the best person to reach out to.
+
+For backend related work, please reach out to **@blessedcoolant**, **@lstein**, **@StAlKeR7779** or **@pyschedelicious**.
diff --git a/docs/src/content/docs/contributing/translations.md b/docs/src/content/docs/contributing/translations.md
new file mode 100644
index 00000000000..53532312cb7
--- /dev/null
+++ b/docs/src/content/docs/contributing/translations.md
@@ -0,0 +1,21 @@
+---
+title: Translations
+---
+
+InvokeAI uses [Weblate](https://weblate.org/) for translation. Weblate is a FOSS project providing a scalable translation service. Weblate automates the tedious parts of managing translation of a growing project, and the service is generously provided at no cost to FOSS projects like InvokeAI.
+
+## Contributing
+
+If you'd like to contribute by adding or updating a translation, please visit our [Weblate project](https://hosted.weblate.org/engage/invokeai/). You'll need to sign in with your GitHub account (a number of other accounts are supported, including Google).
+
+Once signed in, select a language and then the Web UI component. From here you can Browse and Translate strings from English to your chosen language. Zen mode offers a simpler translation experience.
+
+Your changes will be attributed to you in the automated PR process; you don't need to do anything else.
+
+## Help & Questions
+
+Please check Weblate's [documentation](https://docs.weblate.org/en/latest/index.html) or ping @Harvestor on [Discord](https://discord.com/channels/1020123559063990373/1049495067846524939) if you have any questions.
+
+## Thanks
+
+Thanks to the InvokeAI community for their efforts to translate the project!
diff --git a/docs/assets/contributing/resize_invocation.png b/docs/src/content/docs/development/Architecture/assets/resize_invocation.png
similarity index 100%
rename from docs/assets/contributing/resize_invocation.png
rename to docs/src/content/docs/development/Architecture/assets/resize_invocation.png
diff --git a/docs/assets/contributing/resize_node_editor.png b/docs/src/content/docs/development/Architecture/assets/resize_node_editor.png
similarity index 100%
rename from docs/assets/contributing/resize_node_editor.png
rename to docs/src/content/docs/development/Architecture/assets/resize_node_editor.png
diff --git a/docs/src/content/docs/development/Architecture/invocations.mdx b/docs/src/content/docs/development/Architecture/invocations.mdx
new file mode 100644
index 00000000000..08ebdda6a93
--- /dev/null
+++ b/docs/src/content/docs/development/Architecture/invocations.mdx
@@ -0,0 +1,425 @@
+---
+title: Invocations
+lastUpdated: 2026-02-18
+---
+
+import { FileTree, Code, Steps } from '@astrojs/starlight/components'
+
+# Nodes
+
+Features in InvokeAI are added in the form of modular nodes systems called
+**Invocations**.
+
+An Invocation is simply a single operation that takes in some inputs and gives
+out some outputs. We can then chain multiple Invocations together to create more
+complex functionality.
+
+## Invocations Directory
+
+InvokeAI Nodes can be found in the `invokeai/app/invocations` directory. These
+can be used as examples to create your own nodes.
+
+New nodes should be added to a subfolder in `nodes` direction found at the root
+level of the InvokeAI installation location. Nodes added to this folder will be
+able to be used upon application startup.
+
+Example `nodes` subfolder structure:
+
+
+ - nodes
+ - `__init__.py` Invoke-managed custom node loader
+ - cool_node
+ - `__init__.py` see example below
+ - cool_node.py
+ - my_node_pack
+ - `__init__.py` see example below
+ - tasty_node.py
+ - bodacious_node.py
+ - utils.py
+ - extra_nodes
+ - fancy_node.py
+
+
+Each node folder must have an `__init__.py` file that imports its nodes. Only
+nodes imported in the `__init__.py` file are loaded. See the README in the nodes
+folder for more examples:
+
+```py title="__init__.py"
+from .cool_node import ResizeInvocation
+````
+
+## Creating A New Invocation
+
+In order to understand the process of creating a new Invocation, let us actually
+create one.
+
+In our example, let us create an Invocation that will take in an image, resize
+it and output the resized image.
+
+The first set of things we need to do when creating a new Invocation are -
+
+
+ 1. Create a new class that derives from a predefined parent class called `BaseInvocation`.
+ 2. Every Invocation must have a `docstring` that describes what this Invocation does.
+ 3. While not strictly required, we suggest every invocation class name ends in "Invocation", eg "CropImageInvocation".
+ 4. Every Invocation must use the `@invocation` decorator to provide its unique invocation type. You may provide its title, tags and category using the decorator.
+ 5. Invocations are strictly typed. We make use of the native [typing](https://docs.python.org/3/library/typing.html) library and the installed [pydantic](https://pydantic-docs.helpmanual.io/) library for validation.
+
+
+So let us do that.
+
+```py title="resize.py"
+from invokeai.invocation_api import (
+ BaseInvocation,
+ invocation,
+)
+
+@invocation('resize')
+class ResizeInvocation(BaseInvocation):
+ '''Resizes an image'''
+```
+
+That's great.
+
+Now we have setup the base of our new Invocation. Let us think about what inputs
+our Invocation takes.
+
+- We need an `image` that we are going to resize.
+- We will need new `width` and `height` values to which we need to resize the
+ image to.
+
+### Inputs
+
+Every Invocation input must be defined using the `InputField` function. This is
+a wrapper around the pydantic `Field` function, which handles a few extra things
+and provides type hints. Like everything else, this should be strictly typed and
+defined.
+
+So let us create these inputs for our Invocation. First up, the `image` input we
+need. Generally, we can use standard variable types in Python but InvokeAI
+already has a custom `ImageField` type that handles all the stuff that is needed
+for image inputs.
+
+But what is this `ImageField` ..? It is a special class type specifically
+written to handle how images are dealt with in InvokeAI. We will cover how to
+create your own custom field types later in this guide. For now, let's go ahead
+and use it.
+
+```py title="resize.py"
+from invokeai.invocation_api import (
+ BaseInvocation,
+ ImageField,
+ InputField,
+ invocation,
+)
+
+@invocation('resize')
+class ResizeInvocation(BaseInvocation):
+
+ # Inputs
+ image: ImageField = InputField(description="The input image")
+```
+
+Let us break down our input code.
+
+```python
+image: ImageField = InputField(description="The input image")
+```
+
+| Part | Value | Description |
+| ---- | ----- | ----------- |
+| Name | `image` | The variable that will hold our image. |
+| Type Hint | `ImageField` | The type for our field. Indicates that `image` must be an `ImageField`. |
+| Field | `InputField(description="The input image")` | Declares `image` as an input field and provides its description. |
+
+Great. Now let us create our other inputs for `width` and `height`
+
+```py title="resize.py"
+from invokeai.invocation_api import (
+ BaseInvocation,
+ ImageField,
+ InputField,
+ invocation,
+)
+
+@invocation('resize')
+class ResizeInvocation(BaseInvocation):
+
+ # Inputs
+ image: ImageField = InputField(description="The input image")
+ width: int = InputField(default=512, ge=64, le=2048, description="Width of the new image")
+ height: int = InputField(default=512, ge=64, le=2048, description="Height of the new image")
+```
+
+As you might have noticed, we added two new arguments to the `InputField`
+definition for `width` and `height`, called `gt` and `le`. They stand for
+_greater than or equal to_ and _less than or equal to_.
+
+These impose constraints on those fields, and will raise an exception if the
+values do not meet the constraints. Field constraints are provided by
+**pydantic**, so anything you see in the **pydantic docs** will work.
+
+**Note:** _Any time it is possible to define constraints for our field, we
+should do it so the frontend has more information on how to parse this field._
+
+Perfect. We now have our inputs. Let us do something with these.
+
+### Invoke Function
+
+The `invoke` function is where all the magic happens. This function provides you
+the `context` parameter that is of the type `InvocationContext` which will give
+you access to the current context of the generation and all the other services
+that are provided by it by InvokeAI.
+
+Let us create this function first.
+
+```py title="resize.py"
+from invokeai.invocation_api import (
+ BaseInvocation,
+ ImageField,
+ InputField,
+ InvocationContext,
+ invocation,
+)
+
+@invocation('resize')
+class ResizeInvocation(BaseInvocation):
+ '''Resizes an image'''
+
+ image: ImageField = InputField(description="The input image")
+ width: int = InputField(default=512, ge=64, le=2048, description="Width of the new image")
+ height: int = InputField(default=512, ge=64, le=2048, description="Height of the new image")
+
+ def invoke(self, context: InvocationContext):
+ pass
+```
+
+### Outputs
+
+The output of our Invocation will be whatever is returned by this `invoke`
+function. Like with our inputs, we need to strongly type and define our outputs
+too.
+
+What is our output going to be? Another image. Normally you'd have to create a
+type for this but InvokeAI already offers you an `ImageOutput` type that handles
+all the necessary info related to image outputs. So let us use that.
+
+We will cover how to create your own output types later in this guide.
+
+```py title="resize.py"
+from invokeai.invocation_api import (
+ BaseInvocation,
+ ImageField,
+ InputField,
+ InvocationContext,
+ invocation,
+)
+
+from invokeai.app.invocations.image import ImageOutput
+
+@invocation('resize')
+class ResizeInvocation(BaseInvocation):
+ '''Resizes an image'''
+
+ image: ImageField = InputField(description="The input image")
+ width: int = InputField(default=512, ge=64, le=2048, description="Width of the new image")
+ height: int = InputField(default=512, ge=64, le=2048, description="Height of the new image")
+
+ def invoke(self, context: InvocationContext) -> ImageOutput:
+ pass
+```
+
+Perfect. Now that we have our Invocation setup, let us do what we want to do.
+
+- We will first load the image using one of the services provided by InvokeAI to
+ load the image.
+- We will resize the image using `PIL` to our input data.
+- We will output this image in the format we set above.
+
+So let's do that.
+
+```py title="resize.py"
+from invokeai.invocation_api import (
+ BaseInvocation,
+ ImageField,
+ InputField,
+ InvocationContext,
+ invocation,
+)
+
+from invokeai.app.invocations.image import ImageOutput
+
+@invocation("resize")
+class ResizeInvocation(BaseInvocation):
+ """Resizes an image"""
+
+ image: ImageField = InputField(description="The input image")
+ width: int = InputField(default=512, ge=64, le=2048, description="Width of the new image")
+ height: int = InputField(default=512, ge=64, le=2048, description="Height of the new image")
+
+ def invoke(self, context: InvocationContext) -> ImageOutput:
+ # Load the input image as a PIL image
+ image = context.images.get_pil(self.image.image_name)
+
+ # Resize the image
+ resized_image = image.resize((self.width, self.height))
+
+ # Save the image
+ image_dto = context.images.save(image=resized_image)
+
+ # Return an ImageOutput
+ return ImageOutput.build(image_dto)
+```
+
+**Note:** Do not be overwhelmed by the `ImageOutput` process. InvokeAI has a
+certain way that the images need to be dispatched in order to be stored and read
+correctly. In 99% of the cases when dealing with an image output, you can simply
+copy-paste the template above.
+
+### Customization
+
+We can use the `@invocation` decorator to provide some additional info to the
+UI, like a custom title, tags and category.
+
+We also encourage providing a version. This must be a
+[semver](https://semver.org/) version string ("`$MAJOR`.`$MINOR`.`$PATCH`"). The UI
+will let users know if their workflow is using a mismatched version of the node.
+
+```py title="resize.py"
+@invocation("resize", title="My Resizer", tags=["resize", "image"], category="My Invocations", version="1.0.0")
+class ResizeInvocation(BaseInvocation):
+ """Resizes an image"""
+
+ image: ImageField = InputField(description="The input image")
+
+ # Rest of the code
+```
+
+That's it. You made your own **Resize Invocation**.
+
+## Result
+
+Once you make your Invocation correctly, the rest of the process is fully
+automated for you.
+
+When you launch InvokeAI, you can go to `http://localhost:9090/docs` and see
+your new Invocation show up there with all the relevant info.
+
+
+
+When you launch the frontend UI, you can go to the Node Editor tab and find your
+new Invocation ready to be used.
+
+
+
+## Contributing Nodes
+
+Once you've created a Node, the next step is to share it with the community! The
+best way to do this is to submit a Pull Request to add the Node to the
+[Community Nodes](/features/workflows/community-nodes) list. If you're not sure how to do that,
+take a look a at our [contributing nodes overview](/development/guides/creating-nodes/).
+
+## Advanced
+
+### Custom Output Types
+
+Like with custom inputs, sometimes you might find yourself needing custom
+outputs that InvokeAI does not provide. We can easily set one up.
+
+Now that you are familiar with Invocations and Inputs, let us use that knowledge
+to create an output that has an `image` field, a `color` field and a `string`
+field.
+
+- An invocation output is a class that derives from the parent class of
+ `BaseInvocationOutput`.
+- All invocation outputs must use the `@invocation_output` decorator to provide
+ their unique output type.
+- Output fields must use the provided `OutputField` function. This is very
+ similar to the `InputField` function described earlier - it's a wrapper around
+ `pydantic`'s `Field()`.
+- It is not mandatory but we recommend using names ending with `Output` for
+ output types.
+- It is not mandatory but we highly recommend adding a `docstring` to describe
+ what your output type is for.
+
+Now that we know the basic rules for creating a new output type, let us go ahead
+and make it.
+
+```py title="custom_output.py"
+from .baseinvocation import BaseInvocationOutput, OutputField, invocation_output
+from .primitives import ImageField, ColorField
+
+@invocation_output('image_color_string_output')
+class ImageColorStringOutput(BaseInvocationOutput):
+ '''Base class for nodes that output a single image'''
+
+ image: ImageField = OutputField(description="The image")
+ color: ColorField = OutputField(description="The color")
+ text: str = OutputField(description="The string")
+```
+
+That's all there is to it.
+
+### Custom Input Fields
+
+Now that you know how to create your own Invocations, let us dive into slightly
+more advanced topics.
+
+While creating your own Invocations, you might run into a scenario where the
+existing fields in InvokeAI do not meet your requirements. In such cases, you
+can create your own fields.
+
+Let us create one as an example. Let us say we want to create a color input
+field that represents a color code. But before we start on that here are some
+general good practices to keep in mind.
+
+### Best Practices
+
+- There is no naming convention for input fields, but we highly recommend that
+ you name it something appropriate like `ColorField`.
+- It is not mandatory but it is heavily recommended to add a relevant
+ `docstring` to describe your field.
+- Keep your field in the same file as the Invocation that it is made for, or in
+ another file where it is relevant.
+
+All input types are a class that derive from the `BaseModel` type from `pydantic`.
+So let's create one.
+
+```py title="color_field.py"
+ from pydantic import BaseModel
+
+ class ColorField(BaseModel):
+ '''A field that holds the rgba values of a color'''
+ pass
+```
+
+Perfect. Now let us create the properties for our field. This is similar to how
+you created input fields for your Invocation. All the same rules apply. Let us
+create four fields representing the _red(r)_, _blue(b)_, _green(g)_ and
+_alpha(a)_ channel of the color.
+
+:::note
+ Technically, the properties are _also_ called fields - but in this case, it refers to a `pydantic` field.
+:::
+
+```py title="color_field.py"
+class ColorField(BaseModel):
+ '''A field that holds the rgba values of a color'''
+ r: int = Field(ge=0, le=255, description="The red channel")
+ g: int = Field(ge=0, le=255, description="The green channel")
+ b: int = Field(ge=0, le=255, description="The blue channel")
+ a: int = Field(ge=0, le=255, description="The alpha channel")
+```
+
+That's it. We now have a new input field type that we can use in our Invocations
+like this.
+
+```python
+color: ColorField = InputField(default=ColorField(r=0, g=0, b=0, a=0), description='Background color of an image')
+```
+
+### Using the custom field
+
+When you start the UI, your custom field will be automatically recognized.
+
+Custom fields only support connection inputs in the Workflow Editor.
diff --git a/docs/src/content/docs/development/Architecture/model-manager.mdx b/docs/src/content/docs/development/Architecture/model-manager.mdx
new file mode 100644
index 00000000000..ca7884482f6
--- /dev/null
+++ b/docs/src/content/docs/development/Architecture/model-manager.mdx
@@ -0,0 +1,1198 @@
+---
+title: Introduction to the Model Manager
+sidebar:
+ label: Model Manager
+lastUpdated: 2026-02-18
+---
+
+import { FileTree, Code, Steps } from '@astrojs/starlight/components';
+
+The Model Manager is responsible for organizing the various machine
+learning models used by InvokeAI. It consists of a series of
+interdependent services that together handle the full lifecycle of a
+model. These are the:
+
+- **ModelRecordServiceBase:** Responsible for managing model metadata and configuration information. Among other things, the record service tracks the type of the model, its provenance, and where it can be found on disk.
+- **ModelInstallServiceBase:** A service for installing models to disk. It uses `DownloadQueueServiceBase` to download models and their metadata, and `ModelRecordServiceBase` to store that information. It is also responsible for managing the InvokeAI `models` directory and its contents.
+- **DownloadQueueServiceBase:** A multithreaded downloader responsible for downloading models from a remote source to disk. The download queue has special methods for downloading repo_id folders from Hugging Face, as well as discriminating among model versions in Civitai, but can be used for arbitrary content.
+ - **ModelLoadServiceBase** Responsible for loading a model from disk into RAM and VRAM and getting it ready for inference.
+
+
+ ## Location of the Code
+
+ The four main services can be found in `invokeai/app/services` in the following directories:
+
+
+- invokeai
+ - app
+ - services Model manager services
+ - model_records/
+ - model_install/
+ - downloads/
+ - model_load/
+ - api
+ - routers
+ - model_manager_v2.py FastAPI web API for model management
+
+
+---
+
+## What's in a Model? The ModelRecordService
+
+The `ModelRecordService` manages the model's metadata. It supports a hierarchy of pydantic metadata "config" objects, which become increasingly specialized to support particular model types.
+
+### ModelConfigBase
+
+All model metadata classes inherit from this pydantic class. it provides the following fields:
+
+| **Field Name** | **Type** | **Description** |
+|----------------|-----------------|------------------|
+| `key` | str | Unique identifier for the model |
+| `name` | str | Name of the model (not unique) |
+| `model_type` | ModelType | The type of the model |
+| `model_format` | ModelFormat | The format of the model (e.g. "diffusers"); also used as a Union discriminator |
+| `base_model` | BaseModelType | The base model that the model is compatible with |
+| `path` | str | Location of model on disk |
+| `hash` | str | Hash of the model |
+| `description` | str | Human-readable description of the model (optional) |
+| `source` | str | Model's source URL or repo id (optional) |
+
+The `key` is a unique 32-character random ID which was generated at install time. The `hash` field stores a hash of the model's contents at install time obtained by sampling several parts of the model's files using the `imohash` library. Over the course of the model's lifetime it may be transformed in various ways, such as changing its precision or converting it from a .safetensors to a diffusers model.
+
+The `path` field can be absolute or relative. If relative, it is taken to be relative to the `models_dir` setting in the user's `invokeai.yaml` file.
+
+`ModelType`, `ModelFormat` and `BaseModelType` are string enums that are defined in `invokeai.backend.model_manager.config`. They are also imported by, and can be reexported from, `invokeai.app.services.model_manager.model_records`:
+
+```py title="invokeai.backend.model_manager.config"
+from invokeai.app.services.model_records import ModelType, ModelFormat, BaseModelType
+````
+
+### CheckpointConfig
+
+This adds support for checkpoint configurations, and adds the
+following field:
+
+| **Field Name** | **Type** | **Description** |
+|----------------|-----------------|------------------|
+| `config` | str | Path to the checkpoint's config file |
+
+`config` is the path to the checkpoint's config file. If relative, it is taken to be relative to the InvokeAI root directory (e.g. `configs/stable-diffusion/v1-inference.yaml`)
+
+### MainConfig
+
+This adds support for "main" Stable Diffusion models, and adds these fields:
+
+| **Field Name** | **Type** | **Description** |
+|----------------|-----------------|------------------|
+| `vae` | str | Path to a VAE to use instead of the burnt-in one |
+| `variant` | ModelVariantType| Model variant type, such as "inpainting" |
+
+`vae` can be an absolute or relative path. If relative, its base is taken to be the `models_dir` directory.
+
+`variant` is an enumerated string class with values `normal`, `inpaint` and `depth`. If needed, it can be imported if needed from either `invokeai.app.services.model_records` or `invokeai.backend.model_manager.config`.
+
+### ONNXSD2Config
+
+| **Field Name** | **Type** | **Description** |
+|----------------|-----------------|------------------|
+| `prediction_type` | SchedulerPredictionType | Scheduler prediction type to use, e.g. "epsilon" |
+| `upcast_attention` | bool | Model requires its attention module to be upcast |
+
+The `SchedulerPredictionType` enum can be imported from either `invokeai.app.services.model_records` or `invokeai.backend.model_manager.config`.
+
+### Other config classes
+
+There are a series of such classes each discriminated by their `ModelFormat`, including `LoRAConfig`, `IPAdapterConfig`, and so forth. These are rarely needed outside the model manager's internal code, but available in `invokeai.backend.model_manager.config` if needed. There is also a Union of all ModelConfig classes, called `AnyModelConfig` that can be imported from the same file.
+
+### Limitations of the Data Model
+
+The config hierarchy has a major limitation in its handling of the base model type. Each model can only be compatible with one base model, which breaks down in the event of models that are compatible with two or more base models. For example, SD-1 VAEs also work with SD-2 models. A partial workaround is to use `BaseModelType.Any`, which indicates that the model is compatible with any of the base models. This works OK for some models, such as the IP Adapter image encoders, but is an all-or-nothing proposition.
+
+## Reading and Writing Model Configuration Records
+
+The `ModelRecordService` provides the ability to retrieve model configuration records from SQL or YAML databases, update them, and write them back.
+
+A application-wide `ModelRecordService` is created during API initialization and can be retrieved within an invocation from the `InvocationContext` object:
+
+```py
+store = context.services.model_manager.store
+```
+
+or from elsewhere in the code by accessing `ApiDependencies.invoker.services.model_manager.store`.
+
+### Creating a `ModelRecordService`
+
+To create a new `ModelRecordService` database or open an existing one, you can directly create either a `ModelRecordServiceSQL` or a `ModelRecordServiceFile` object:
+
+```py
+from invokeai.app.services.model_records import ModelRecordServiceSQL, ModelRecordServiceFile
+
+store = ModelRecordServiceSQL.from_connection(connection, lock)
+store = ModelRecordServiceSQL.from_db_file('/path/to/sqlite_database.db')
+store = ModelRecordServiceFile.from_db_file('/path/to/database.yaml')
+```
+
+The `from_connection()` form is only available from the `ModelRecordServiceSQL` class, and is used to manage records in a previously-opened SQLITE3 database using a `sqlite3.connection` object and a `threading.lock` object. It is intended for the specific use case of storing the record information in the main InvokeAI database, usually `databases/invokeai.db`.
+
+The `from_db_file()` methods can be used to open new connections to the named database files. If the file doesn't exist, it will be created and initialized.
+
+As a convenience, `ModelRecordServiceBase` offers two methods, `from_db_file` and `open`, which will return either a SQL or File implementation depending on the context. The former looks at the file extension to determine whether to open the file as a SQL database (".db") or as a file database (".yaml"). If the file exists, but is either the wrong type or does not contain the expected schema metainformation, then an appropriate `AssertionError` will be raised:
+
+```py
+store = ModelRecordServiceBase.from_db_file('/path/to/a/file.{yaml,db}')
+```
+
+The `ModelRecordServiceBase.open()` method is specifically designed for use in the InvokeAI web server. Its signature is:
+
+```py
+def open(
+ cls,
+ config: InvokeAIAppConfig,
+ conn: Optional[sqlite3.Connection] = None,
+ lock: Optional[threading.Lock] = None
+ ) -> Union[ModelRecordServiceSQL, ModelRecordServiceFile]:
+```
+
+The way it works is as follows:
+
+1. Retrieve the value of the `model_config_db` option from the user's `invokeai.yaml` config file.
+2. If `model_config_db` is `auto` (the default), then:
+ - Use the values of `conn` and `lock` to return a `ModelRecordServiceSQL` object opened on the passed connection and lock.
+ - Open up a new connection to `databases/invokeai.db` if `conn` and/or `lock` are missing (see note below).
+3. If `model_config_db` is a Path, then use `from_db_file` to return the appropriate type of ModelRecordService.
+4. If `model_config_db` is None, then retrieve the legacy `conf_path` option from `invokeai.yaml` and use the Path indicated there. This will default to `configs/models.yaml`.
+
+So a typical startup pattern would be:
+
+```py
+import sqlite3
+from invokeai.app.services.thread import lock
+from invokeai.app.services.model_records import ModelRecordServiceBase
+from invokeai.app.services.config import InvokeAIAppConfig
+
+config = InvokeAIAppConfig.get_config()
+db_conn = sqlite3.connect(config.db_path.as_posix(), check_same_thread=False)
+store = ModelRecordServiceBase.open(config, db_conn, lock)
+```
+
+### Fetching a Model's Configuration from `ModelRecordServiceBase`
+
+Configurations can be retrieved in several ways.
+
+#### get_model(key) -> AnyModelConfig
+
+The basic functionality is to call the record store object's `get_model()` method with the desired model's unique key. It returns the appropriate subclass of ModelConfigBase:
+
+```py
+model_conf = store.get_model('f13dd932c0c35c22dcb8d6cda4203764')
+print(model_conf.path)
+
+>> '/tmp/models/ckpts/v1-5-pruned-emaonly.safetensors'
+
+```
+
+If the key is unrecognized, this call raises an `UnknownModelException`.
+
+#### exists(key) -> AnyModelConfig
+
+Returns True if a model with the given key exists in the database.
+
+#### search_by_path(path) -> AnyModelConfig
+
+Returns the configuration of the model whose path is `path`. The path is matched using a simple string comparison and won't correctly match models referred to by different paths (e.g. using symbolic links).
+
+#### search_by_name(name, base, type) -> List[AnyModelConfig]
+
+This method searches for models that match some combination of `name`, `BaseType` and `ModelType`. Calling without any arguments will return all the models in the database.
+
+#### all_models() -> List[AnyModelConfig]
+
+Return all the model configs in the database. Exactly equivalent to calling `search_by_name()` with no arguments.
+
+#### search_by_tag(tags) -> List[AnyModelConfig]
+
+`tags` is a list of strings. This method returns a list of model configs that contain all of the given tags. Examples:
+
+```py
+# find all models that are marked as both SFW and as generating
+# background scenery
+configs = store.search_by_tag(['sfw', 'scenery'])
+```
+
+Note that only tags are not searchable in this way. Other fields can be searched using a filter:
+
+```py
+commercializable_models = [x for x in store.all_models() \
+ if x.license.contains('allowCommercialUse=Sell')]
+```
+
+#### version() -> str
+
+Returns the version of the database, currently at `3.2`
+
+#### model_info_by_name(name, base_model, model_type) -> ModelConfigBase
+
+This method exists to ease the transition from the previous version of the model manager, in which `get_model()` took the three arguments shown above. This looks for a unique model identified by name, base model and model type and returns it.
+
+The method will generate a `DuplicateModelException` if there are more than one models that share the same type, base and name. While unlikely, it is certainly possible to have a situation in which the user had added two models with the same name, base and type, one located at path `/foo/my_model` and the other at `/bar/my_model`. It is strongly recommended to search for models using `search_by_name()`, which can return multiple results, and then to select the desired model and pass its key to `get_model()`.
+
+### Writing model configs to the database
+
+Several methods allow you to create and update stored model config records.
+
+#### add_model(key, config) -> AnyModelConfig
+
+Given a key and a configuration, this will add the model's configuration record to the database. `config` can either be a subclass of `ModelConfigBase` (i.e. any class listed in `AnyModelConfig`), or a `dict` of key/value pairs. In the latter case, the correct configuration class will be picked by Pydantic's discriminated union mechanism.
+
+If successful, the method will return the appropriate subclass of `ModelConfigBase`. It will raise a `DuplicateModelException` if a model with the same key is already in the database, or an `InvalidModelConfigException` if a dict was passed and Pydantic experienced a parse or validation error.
+
+### update_model(key, config) -> AnyModelConfig
+
+Given a key and a configuration, this will update the model configuration record in the database. `config` can be either a instance of `ModelConfigBase`, or a sparse `dict` containing the fields to be updated. This will return an `AnyModelConfig` on success, or raise `InvalidModelConfigException` or `UnknownModelException` exceptions on failure.
+
+---
+
+## Model installation
+
+The `ModelInstallService` class implements the
+`ModelInstallServiceBase` abstract base class, and provides a one-stop
+shop for all your model install needs. It provides the following
+functionality:
+
+- Registering a model config record for a model already located on the local filesystem, without moving it or changing its path.
+
+- Installing a model alreadiy located on the local filesystem, by moving it into the InvokeAI root directory under the `models` folder (or wherever config parameter `models_dir` specifies).
+
+- Probing of models to determine their type, base type and other key information.
+
+- Interface with the InvokeAI event bus to provide status updates on the download, installation and registration process.
+
+- Downloading a model from an arbitrary URL and installing it in `models_dir`.
+
+- Special handling for HuggingFace repo_ids to recursively download the contents of the repository, paying attention to alternative variants such as fp16.
+
+- Saving tags and other metadata about the model into the invokeai database when fetching from a repo that provides that type of information, (currently only HuggingFace).
+
+### Initializing the installer
+
+A default installer is created at InvokeAI api startup time and stored in `ApiDependencies.invoker.services.model_install` and can also be retrieved from an invocation's `context` argument with `context.services.model_install`.
+
+In the event you wish to create a new installer, you may use the following initialization pattern:
+
+```py
+from invokeai.app.services.config import get_config
+from invokeai.app.services.model_records import ModelRecordServiceSQL
+from invokeai.app.services.model_install import ModelInstallService
+from invokeai.app.services.download import DownloadQueueService
+from invokeai.app.services.shared.sqlite.sqlite_database import SqliteDatabase
+from invokeai.backend.util.logging import InvokeAILogger
+
+config = get_config()
+
+logger = InvokeAILogger.get_logger(config=config)
+db = SqliteDatabase(config.db_path, logger)
+record_store = ModelRecordServiceSQL(db, logger)
+queue = DownloadQueueService()
+queue.start()
+
+installer = ModelInstallService(app_config=config,
+ record_store=record_store,
+ download_queue=queue
+ )
+installer.start()
+```
+
+The full form of `ModelInstallService()` takes the following required parameters:
+
+| **Argument** | **Type** | **Description** |
+|------------------|------------------------------|------------------------------|
+| `app_config` | InvokeAIAppConfig | InvokeAI app configuration object |
+| `record_store` | ModelRecordServiceBase | Config record storage database |
+| `download_queue` | DownloadQueueServiceBase | Download queue object |
+|`session` | Optional[requests.Session] | Swap in a different Session object (usually for debugging) |
+
+Once initialized, the installer will provide the following methods:
+
+#### install_job = installer.heuristic_import(source, [config], [access_token])
+
+This is a simplified interface to the installer which takes a source string, an optional model configuration dictionary and an optional access token.
+
+The `source` is a string that can be any of these forms
+
+1. A path on the local filesystem (`C:\\users\\fred\\model.safetensors`)
+2. A Url pointing to a single downloadable model file (`https://civitai.com/models/58390/detail-tweaker-lora-lora`)
+3. A HuggingFace repo_id with any of the following formats:
+ * `model/name` -- entire model
+ * `model/name:fp32` -- entire model, using the fp32 variant
+ * `model/name:fp16:vae` -- vae submodel, using the fp16 variant
+ * `model/name::vae` -- vae submodel, using default precision
+ * `model/name:fp16:path/to/model.safetensors` -- an individual model file, fp16 variant
+ * `model/name::path/to/model.safetensors` -- an individual model file, default variant
+
+Note that by specifying a relative path to the top of the HuggingFace repo, you can download and install arbitrary models files.
+
+The variant, if not provided, will be automatically filled in with `fp32` if the user has requested full precision, and `fp16` otherwise. If a variant that does not exist is requested, then the method will install whatever HuggingFace returns as its default revision.
+
+`config` is an optional dict of values that will override the autoprobed values for model type, base, scheduler prediction type, and so forth. See [Model configuration and probing](#model-configuration-and-probing) for details.
+
+`access_token` is an optional access token for accessing resources that need authentication.
+
+The method will return a `ModelInstallJob`. This object is discussed at length in the following section.
+
+#### install_job = installer.import_model()
+
+The `import_model()` method is the core of the installer. The following illustrates basic usage:
+
+```py
+from invokeai.app.services.model_install import (
+ LocalModelSource,
+ HFModelSource,
+ URLModelSource,
+)
+
+source1 = LocalModelSource(path='/opt/models/sushi.safetensors') # a local safetensors file
+source2 = LocalModelSource(path='/opt/models/sushi_diffusers') # a local diffusers folder
+
+source3 = HFModelSource(repo_id='runwayml/stable-diffusion-v1-5') # a repo_id
+source4 = HFModelSource(repo_id='runwayml/stable-diffusion-v1-5', subfolder='vae') # a subfolder within a repo_id
+source5 = HFModelSource(repo_id='runwayml/stable-diffusion-v1-5', variant='fp16') # a named variant of a HF model
+source6 = HFModelSource(repo_id='runwayml/stable-diffusion-v1-5', subfolder='OrangeMix/OrangeMix1.ckpt') # path to an individual model file
+
+source7 = URLModelSource(url='https://civitai.com/api/download/models/63006') # model located at a URL
+source8 = URLModelSource(url='https://civitai.com/api/download/models/63006', access_token='letmein') # with an access token
+
+for source in [source1, source2, source3, source4, source5, source6, source7]:
+ install_job = installer.install_model(source)
+
+source2job = installer.wait_for_installs(timeout=120)
+for source in sources:
+ job = source2job[source]
+ if job.complete:
+ model_config = job.config_out
+ model_key = model_config.key
+ print(f"{source} installed as {model_key}")
+ elif job.errored:
+ print(f"{source}: {job.error_type}.\nStack trace:\n{job.error}")
+
+```
+
+As shown here, the `import_model()` method accepts a variety of sources, including local safetensors files, local diffusers folders, HuggingFace repo_ids with and without a subfolder designation, Civitai model URLs and arbitrary URLs that point to checkpoint files (but not to folders).
+
+Each call to `import_model()` return a `ModelInstallJob` job, an object which tracks the progress of the install.
+
+If a remote model is requested, the model's files are downloaded in parallel across a multiple set of threads using the download queue. During the download process, the `ModelInstallJob` is updated to provide status and progress information. After the files (if any) are downloaded, the remainder of the installation runs in a single serialized background thread. These are the model probing, file copying, and config record database update steps.
+
+Multiple install jobs can be queued up. You may block until all install jobs are completed (or errored) by calling the `wait_for_installs()` method as shown in the code example. `wait_for_installs()` will return a `dict` that maps the requested source to its job. This object can be interrogated to determine its status. If the job errored out, then the error type and details can be recovered from `job.error_type` and `job.error`.
+
+The full list of arguments to `import_model()` is as follows:
+
+| Argument | Type | Default | Description |
+|----------|-------|---------|-------------|
+| `source` | ModelSource | None | The source of the model, Path, URL or repo_id |
+| `config` | Dict[str, Any] | None | Override all or a portion of model's probed attributes |
+
+The next few sections describe the various types of ModelSource that can be passed to `import_model()`.
+
+`config` can be used to override all or a portion of the configuration attributes returned by the model prober. See the section below for details.
+
+#### LocalModelSource
+
+This is used for a model that is located on a locally-accessible Posix filesystem, such as a local disk or networked fileshare.
+
+| Argument | Type | Default | Description |
+|----------|------|---------|-------------|
+| `path` | str | Path | None | Path to the model file or directory |
+| `inplace` | bool | False | If set, the model file(s) will be left in their location; otherwise they will be copied into the InvokeAI root's `models` directory |
+
+#### URLModelSource
+
+This is used for a single-file model that is accessible via a URL. The
+fields are:
+
+| Argument | Type | Default | Description |
+|----------|------|---------|-------------|
+| `url` | AnyHttpUrl | None | The URL for the model file. |
+| `access_token` | str | None | An access token needed to gain access to this file. |
+
+The `AnyHttpUrl` class can be imported from `pydantic.networks`.
+
+Ordinarily, no metadata is retrieved from these sources. However, there is special-case code in the installer that looks for HuggingFace and fetches the corresponding model metadata from the corresponding repo.
+
+#### HFModelSource
+
+HuggingFace has the most complicated `ModelSource` structure:
+
+| Argument | Type | Default | Description |
+|----------|------|---------|-------------|
+| `repo_id` | str | None | The ID of the desired model. |
+| `variant` | ModelRepoVariant | ModelRepoVariant('fp16') | The desired variant. |
+| `subfolder` | Path | None | Look for the model in a subfolder of the repo. |
+| `access_token` | str | None | An access token needed to gain access to a subscriber's-only model. |
+
+The `repo_id` is the repository ID, such as `stabilityai/sdxl-turbo`.
+
+The `variant` is one of the various diffusers formats that HuggingFace supports and is used to pick out from the hodgepodge of files that in a typical HuggingFace repository the particular components needed for a complete diffusers model. `ModelRepoVariant` is an enum that can be imported from `invokeai.backend.model_manager` and has the following values:
+
+| Name | String Value |
+|------|--------------|
+| ModelRepoVariant.DEFAULT | "default" |
+| ModelRepoVariant.FP16 | "fp16" |
+| ModelRepoVariant.FP32 | "fp32" |
+| ModelRepoVariant.ONNX | "onnx" |
+| ModelRepoVariant.OPENVINO | "openvino" |
+| ModelRepoVariant.FLAX | "flax" |
+
+You can also pass the string forms to `variant` directly. Note that InvokeAI may not be able to load and run all variants. At the current time, specifying `ModelRepoVariant.DEFAULT` will retrieve model files that are unqualified, e.g. `pytorch_model.safetensors` rather than `pytorch_model.fp16.safetensors`. These are usually the 32-bit safetensors forms of the model.
+
+If `subfolder` is specified, then the requested model resides in a subfolder of the main model repository. This is typically used to fetch and install VAEs.
+
+Some models require you to be registered with HuggingFace and logged in. To download these files, you must provide an `access_token`. Internally, if no access token is provided, then `HfFolder.get_token()` will be called to fill it in with the cached one.
+
+#### Monitoring the install job process
+
+When you create an install job with `import_model()`, it launches the download and installation process in the background and returns a `ModelInstallJob` object for monitoring the process.
+
+The `ModelInstallJob` class has the following structure:
+
+| Attribute | Type | Description |
+|-----------|------|-------------|
+| `id` | `int` | Integer ID for this job |
+| `status` | `InstallStatus` | An enum of [`waiting`, `downloading`, `running`, `completed`, `error` and `cancelled`] |
+| `config_in` | `dict` | Overriding configuration values provided by the caller |
+| `config_out` | `AnyModelConfig` | After successful completion, contains the configuration record written to the database |
+| `inplace` | `boolean` | True if the caller asked to install the model in place using its local path |
+| `source` | `ModelSource` | The local path, remote URL or repo_id of the model to be installed |
+| `local_path` | `Path` | If a remote model, holds the path of the model after it is downloaded; if a local model, same as `source` |
+| `error_type` | `str` | Name of the exception that led to an error status |
+| `error` | `str` | Traceback of the error |
+
+If the `event_bus` argument was provided, events will also be broadcast to the InvokeAI event bus. The events will appear on the bus as an event of type `EventServiceBase.model_event`, a timestamp and the following event names:
+
+##### `model_install_downloading`
+
+For remote models only, `model_install_downloading` events will be issued at regular intervals as the download progresses. The event's payload contains the following keys:
+
+| Key | Type | Description |
+|-----|------|-------------|
+|`source`|str|String representation of the requested source|
+|`local_path`|str|String representation of the path to the downloading model (usually a temporary directory)|
+|`bytes`|int|How many bytes downloaded so far|
+|`total_bytes`|int|Total size of all the files that make up the model|
+|`parts`|List[Dict]|Information on the progress of the individual files that make up the model|
+
+The parts is a list of dictionaries that give information on each of the components pieces of the download. The dictionary's keys are `source`, `local_path`, `bytes` and `total_bytes`, and correspond to the like-named keys in the main event.
+
+Note that downloading events will not be issued for local models, and that downloading events occur _before_ the running event.
+
+##### `model_install_running`
+
+`model_install_running` is issued when all the required downloads have completed (if applicable) and the model probing, copying and registration process has now started.
+
+The payload will contain the key `source`.
+
+##### `model_install_completed`
+
+`model_install_completed` is issued once at the end of a successful installation. The payload will contain the keys `source`, `total_bytes` and `key`, where `key` is the ID under which the model has been registered.
+
+##### `model_install_error`
+
+`model_install_error` is emitted if the installation process fails for some reason. The payload will contain the keys `source`, `error_type` and `error`. `error_type` is a short message indicating the nature of the error, and `error` is the long traceback to help debug the problem.
+
+##### `model_install_cancelled`
+
+`model_install_cancelled` is issued if the model installation is cancelled, or if one or more of its files' downloads are cancelled. The payload will contain `source`.
+
+##### Following the model status
+
+You may poll the `ModelInstallJob` object returned by `import_model()` to ascertain the state of the install. The job status can be read from the job's `status` attribute, an `InstallStatus` enum which has the enumerated values `WAITING`, `DOWNLOADING`, `RUNNING`, `COMPLETED`, `ERROR` and `CANCELLED`.
+
+For convenience, install jobs also provided the following boolean properties: `waiting`, `downloading`, `running`, `complete`, `errored` and `cancelled`, as well as `in_terminal_state`. The last will return True if the job is in the complete, errored or cancelled states.
+
+#### Model configuration and probing
+
+The install service uses the `invokeai.backend.model_manager.probe` module during import to determine the model's type, base type, and other configuration parameters. Among other things, it assigns a default name and description for the model based on probed fields.
+
+When downloading remote models is implemented, additional configuration information, such as list of trigger terms, will be retrieved from the HuggingFace and Civitai model repositories.
+
+The probed values can be overridden by providing a dictionary in the optional `config` argument passed to `import_model()`. You may provide overriding values for any of the model's configuration attributes. Here is an example of setting the `SchedulerPredictionType` and `name` for an sd-2 model:
+
+```py
+install_job = installer.import_model(
+ source=HFModelSource(repo_id='stabilityai/stable-diffusion-2-1',variant='fp32'),
+ config=dict(
+ prediction_type=SchedulerPredictionType('v_prediction')
+ name='stable diffusion 2 base model',
+ )
+ )
+```
+
+### Other installer methods
+
+This section describes additional methods provided by the installer class.
+
+#### jobs = installer.wait_for_installs([timeout])
+
+Block until all pending installs are completed or errored and then returns a list of completed jobs. The optional `timeout` argument will return from the call if jobs aren't completed in the specified time. An argument of 0 (the default) will block indefinitely.
+
+#### jobs = installer.wait_for_job(job, [timeout])
+
+Like `wait_for_installs()`, but block until a specific job has completed or errored, and then return the job. The optional `timeout` argument will return from the call if the job doesn't complete in the specified time. An argument of 0 (the default) will block indefinitely.
+
+#### jobs = installer.list_jobs()
+
+Return a list of all active and complete `ModelInstallJobs`.
+
+#### jobs = installer.get_job_by_source(source)
+
+Return a list of `ModelInstallJob` corresponding to the indicated model source.
+
+#### jobs = installer.get_job_by_id(id)
+
+Return a list of `ModelInstallJob` corresponding to the indicated model id.
+
+#### jobs = installer.cancel_job(job)
+
+Cancel the indicated job.
+
+#### installer.prune_jobs
+
+Remove jobs that are in a terminal state (i.e. complete, errored or cancelled) from the job list returned by `list_jobs()` and `get_job()`.
+
+#### installer.app_config, installer.record_store, installer.event_bus
+
+Properties that provide access to the installer's `InvokeAIAppConfig`, `ModelRecordServiceBase` and `EventServiceBase` objects.
+
+#### key = installer.register_path(model_path, config), key = installer.install_path(model_path, config)
+
+These methods bypass the download queue and directly register or install the model at the indicated path, returning the unique ID for the installed model.
+
+Both methods accept a Path object corresponding to a checkpoint or diffusers folder, and an optional dict of config attributes to use to override the values derived from model probing.
+
+The difference between `register_path()` and `install_path()` is that the former creates a model configuration record without changing the location of the model in the filesystem. The latter makes a copy of the model inside the InvokeAI models directory before registering it.
+
+#### installer.unregister(key)
+
+This will remove the model config record for the model at key, and is equivalent to `installer.record_store.del_model(key)`
+
+#### installer.delete(key)
+
+This is similar to `unregister()` but has the additional effect of conditionally deleting the underlying model file(s) if they reside within the InvokeAI models directory
+
+#### installer.unconditionally_delete(key)
+
+This method is similar to `unregister()`, but also unconditionally deletes the corresponding model weights file(s), regardless of whether they are inside or outside the InvokeAI models hierarchy.
+
+#### path = installer.download_and_cache(remote_source, [access_token], [timeout])
+
+This utility routine will download the model file located at source, cache it, and return the path to the cached file. It does not attempt to determine the model type, probe its configuration values, or register it with the models database.
+
+You may provide an access token if the remote source requires authorization. The call will block indefinitely until the file is completely downloaded, cancelled or raises an error of some sort. If you provide a timeout (in seconds), the call will raise a `TimeoutError` exception if the download hasn't completed in the specified period.
+
+You may use this mechanism to request any type of file, not just a model. The file will be stored in a subdirectory of `INVOKEAI_ROOT/models/.cache`. If the requested file is found in the cache, its path will be returned without redownloading it.
+
+Be aware that the models cache is cleared of infrequently-used files and directories at regular intervals when the size of the cache exceeds the value specified in Invoke's `convert_cache` configuration variable.
+
+#### installer.start(invoker)
+
+The `start` method is called by the API initialization routines when the API starts up. Its effect is to call `sync_to_config()` to synchronize the model record store database with what's currently on disk.
+
+---
+
+## Get on line: The Download Queue
+
+InvokeAI can download arbitrary files using a multithreaded background download queue. Internally, the download queue is used for installing models located at remote locations. The queue is implemented by the `DownloadQueueService` defined in `invokeai.app.services.download_manager`. However, most of the implementation is spread out among several files in `invokeai/backend/model_manager/download/*`
+
+A default download queue is located in `ApiDependencies.invoker.services.download_queue`. However, you can create additional instances if you need to isolate your queue from the main one.
+
+### A job for every task
+
+The queue operates on a series of download job objects. These objects specify the source and destination of the download, and keep track of the progress of the download. Jobs come in a variety of shapes and colors as they are progressively specialized for particular download task.
+
+The basic job is the `DownloadJobBase`, a pydantic object with the following fields:
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `id` | int | | Job ID, an integer >= 0 |
+| `priority` | int | 10 | Job priority. Lower priorities run before higher priorities |
+| `source` | str | | Where to download from (specialized types used in subclasses) |
+| `destination` | Path | | Where to download to |
+| `status` | DownloadJobStatus | Idle | Job's status (see below) |
+| `event_handlers` | List[DownloadEventHandler] | | Event handlers (see below) |
+| `job_started` | float | | Timestamp for when the job started running |
+| `job_ended` | float | | Timestamp for when the job completed or errored out |
+| `job_sequence` | int | | A counter that is incremented each time a model is dequeued |
+| `error` | Exception | | A copy of the Exception that caused an error during download |
+
+When you create a job, you can assign it a `priority`. If multiple jobs are queued, the job with the lowest priority runs first. (Don't blame us! The Unix developers came up with this convention.)
+
+Every job has a `source` and a `destination`. `source` is a string in the base class, but subclassses redefine it more specifically.
+
+The `destination` must be the Path to a file or directory on the local filesystem. If the Path points to a new or existing file, then the source will be stored under that filename. If the Path ponts to an existing directory, then the downloaded file will be stored inside the directory, usually using the name assigned to it at the remote site in the `content-disposition` http field.
+
+When the job is submitted, it is assigned a numeric `id`. The id can then be used to control the job, such as starting, stopping and cancelling its download.
+
+The `status` field is updated by the queue to indicate where the job is in its lifecycle. Values are defined in the string enum `DownloadJobStatus`, a symbol available from `invokeai.app.services.download_manager`. Possible values are:
+
+| Value | String Value | Description |
+|-------|--------------|-------------|
+| `IDLE` | idle | Job created, but not submitted to the queue |
+| `ENQUEUED` | enqueued | Job is patiently waiting on the queue |
+| `RUNNING` | running | Job is running! |
+| `PAUSED` | paused | Job was paused and can be restarted |
+| `COMPLETED` | completed | Job has finished its work without an error |
+| `ERROR` | error | Job encountered an error and will not run again |
+| `CANCELLED` | cancelled | Job was cancelled and will not run (again) |
+
+`job_started`, `job_ended` and `job_sequence` indicate when the job was started (using a python timestamp), when it completed, and the order in which it was taken off the queue. These are mostly used for debugging and performance testing.
+
+In case of an error, the Exception that caused the error will be placed in the `error` field, and the job's status will be set to `DownloadJobStatus.ERROR`.
+
+After an error occurs, any partially downloaded files will be deleted from disk, unless `preserve_partial_downloads` was set to True at job creation time (or set to True any time before the error occurred). Note that since all InvokeAI model install operations involve downloading files to a temporary directory that has a limited lifetime, this flag is not used by the model installer.
+
+There are a series of subclasses of `DownloadJobBase` that provide support for specific types of downloads. These are:
+
+#### DownloadJobPath
+
+This subclass redefines `source` to be a filesystem Path. It is used to move a file or directory from the `source` to the `destination` paths in the background using a uniform event-based infrastructure.
+
+#### DownloadJobRemoteSource
+
+This subclass adds the following fields to the job:
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `bytes` | int | 0 | bytes downloaded so far |
+| `total_bytes` | int | 0 | total size to download |
+| `access_token` | Any | None | an authorization token to present to the remote source |
+
+The job will start out with 0/0 in its bytes/total_bytes fields. Once it starts running, `total_bytes` will be populated from information provided in the HTTP download header (if available), and the number of bytes downloaded so far will be progressively incremented.
+
+#### DownloadJobURL
+
+This is a subclass of `DownloadJobBase`. It redefines `source` to be a
+Pydantic `AnyHttpUrl` object, which enforces URL validation checking
+on the field.
+
+Note that the installer service defines an additional subclass of
+`DownloadJobRemoteSource` that accepts HuggingFace repo_ids in
+addition to URLs. This is discussed later in this document.
+
+### Event handlers
+
+While a job is being downloaded, the queue will emit events at
+periodic intervals. A typical series of events during a successful
+download session will look like this:
+
+
+ 1. `enqueued`
+ 2. `running`
+ 3. `running`
+ 4. `running`
+ 5. `completed`
+
+
+There will be a single enqueued event, followed by one or more running events, and finally one `completed`, `error` or `cancelled` events.
+
+It is possible for a caller to pause download temporarily, in which case the events may look something like this:
+
+
+ 1. `enqueued`
+ 2. `running`
+ 3. `running`
+ 4. `paused` user paused the download
+ 5. `running`
+ 6. `completed`
+
+
+The download queue logs when downloads start and end (unless `quiet` is set to True at initialization time) but doesn't log any progress events. You will probably want to be alerted to events during the download job and provide more user feedback. In order to intercept and respond to events you may install a series of one or more event handlers in the job. Whenever the job's status changes, the chain of event handlers is traversed and executed in the same thread that the download job is running in.
+
+Event handlers have the signature `Callable[["DownloadJobBase"], None]`, i.e.
+
+```py
+def handler(job: DownloadJobBase):
+ pass
+```
+
+A typical handler will examine `job.status` and decide if there's something to be done. This can include cancelling or erroring the job, but more typically is used to report on the job status to the user interface or to perform certain actions on successful completion of the job.
+
+Event handlers can be attached to a job at creation time. In addition, you can create a series of default handlers that are attached to the queue object itself. These handlers will be executed for each job after the job's own handlers (if any) have run.
+
+During a download, running events are issued every time roughly 1% of the file is transferred. This is to provide just enough granularity to update a tqdm progress bar smoothly.
+
+Handlers can be added to a job after the fact using the job's `add_event_handler` method:
+
+```py
+job.add_event_handler(my_handler)
+```
+
+All handlers can be cleared using the job's `clear_event_handlers()` method. Note that it might be a good idea to pause the job before altering its handlers.
+
+### Creating a download queue object
+
+The `DownloadQueueService` constructor takes the following arguments:
+
+| Argument | Type | Default | Description |
+|----------|------|---------|-------------|
+| `event_handlers` | List[DownloadEventHandler] | [] | Event handlers |
+| `max_parallel_dl` | int | 5 | Maximum number of simultaneous downloads allowed |
+| `requests_session` | requests.sessions.Session | None | An alternative requests Session object to use for the download |
+| `quiet` | bool | False | Do work quietly without issuing log messages |
+
+A typical initialization sequence will look like:
+
+```py
+from invokeai.app.services.download_manager import DownloadQueueService
+
+def log_download_event(job: DownloadJobBase):
+ logger.info(f'job={job.id}: status={job.status}')
+
+queue = DownloadQueueService(
+ event_handlers=[log_download_event]
+ )
+```
+
+Event handlers can be provided to the queue at initialization time as shown in the example. These will be automatically appended to the handler list for any job that is submitted to this queue.
+
+`max_parallel_dl` sets the number of simultaneous active downloads that are allowed. The default of five has not been benchmarked in any way, but seems to give acceptable performance.
+
+`requests_session` can be used to provide a `requests` module Session object that will be used to stream remote URLs to disk. This facility was added for use in the module's unit tests to simulate a remote web server, but may be useful in other contexts.
+
+`quiet` will prevent the queue from issuing any log messages at the INFO or higher levels.
+
+### Submitting a download job
+
+You can submit a download job to the queue either by creating the job manually and passing it to the queue's `submit_download_job()` method, or using the `create_download_job()` method, which will do the same thing on your behalf.
+
+To use the former method, follow this example:
+
+```py
+job = DownloadJobRemoteSource(
+ source='http://www.civitai.com/models/13456',
+ destination='/tmp/models/',
+ event_handlers=[my_handler1, my_handler2], # if desired
+)
+queue.submit_download_job(job, start=True)
+```
+
+`submit_download_job()` takes just two arguments: the job to submit, and a flag indicating whether to immediately start the job (defaulting to True). If you choose not to start the job immediately, you can start it later by calling the queue's `start_job()` or `start_all_jobs()` methods, which are described later.
+
+To have the queue create the job for you, follow this example instead:
+
+```py
+job = queue.create_download_job(
+ source='http://www.civitai.com/models/13456',
+ destdir='/tmp/models/',
+ filename='my_model.safetensors',
+ event_handlers=[my_handler1, my_handler2], # if desired
+ start=True,
+ )
+```
+
+The `filename` argument forces the downloader to use the specified name for the file rather than the name provided by the remote source, and is equivalent to manually specifying a destination of `/tmp/models/my_model.safetensors' in the submitted job.
+
+Here is the full list of arguments that can be provided to `create_download_job()`:
+
+| Argument | Type | Default | Description |
+|----------|------|---------|-------------|
+| `source` | Union[str, Path, AnyHttpUrl] | | Download remote or local source |
+| `destdir` | Path | | Destination directory for downloaded file |
+| `filename` | Path | None | Filename for downloaded file |
+| `start` | bool | True | Enqueue the job immediately |
+| `priority` | int | 10 | Starting priority for this job |
+| `access_token` | str | None | Authorization token for this resource |
+| `event_handlers` | List[DownloadEventHandler] | [] | Event handlers for this job |
+
+Internally, `create_download_job()` has a little bit of internal logic that looks at the type of the source and selects the right subclass of `DownloadJobBase` to create and enqueue.
+
+**TODO**: move this logic into its own method for overriding in subclasses.
+
+### Job control
+
+Prior to completion, jobs can be controlled with a series of queue method calls. Do not attempt to modify jobs by directly writing to their fields, as this is likely to lead to unexpected results.
+
+Any method that accepts a job argument may raise an `UnknownJobIDException` if the job has not yet been submitted to the queue or was not created by this queue.
+
+#### queue.join()
+
+This method will block until all the active jobs in the queue have reached a terminal state (completed, errored or cancelled).
+
+#### queue.wait_for_job(job, [timeout])
+
+This method will block until the indicated job has reached a terminal state (completed, errored or cancelled). If the optional timeout is provided, the call will block for at most timeout seconds, and raise a TimeoutError otherwise.
+
+#### jobs = queue.list_jobs()
+
+This will return a list of all jobs, including ones that have not yet been enqueued and those that have completed or errored out.
+
+#### job = queue.id_to_job(int)
+
+This method allows you to recover a submitted job using its ID.
+
+#### queue.prune_jobs()
+
+Remove completed and errored jobs from the job list.
+
+#### queue.start_job(job)
+
+If the job was submitted with `start=False`, then it can be started using this method.
+
+#### queue.pause_job(job)
+
+This will temporarily pause the job, if possible. It can later be restarted and pick up where it left off using `queue.start_job()`.
+
+#### queue.cancel_job(job)
+
+This will cancel the job if possible and clean up temporary files and other resources that it might have been using.
+
+#### queue.start_all_jobs(), queue.pause_all_jobs(), queue.cancel_all_jobs()
+
+This will start/pause/cancel all jobs that have been submitted to the queue and have not yet reached a terminal state.
+
+---
+
+## This Meta be Good: Model Metadata Storage
+
+The modules found under `invokeai.backend.model_manager.metadata` provide a straightforward API for fetching model metadatda from online repositories. Currently only HuggingFace is supported. However, the modules are easily extended for additional repos, provided that they have defined APIs for metadata access.
+
+Metadata comprises any descriptive information that is not essential for getting the model to run. For example "author" is metadata, while "type", "base" and "format" are not. The latter fields are part of the model's config, as defined in `invokeai.backend.model_manager.config`.
+
+### Example Usage
+
+```py
+from invokeai.backend.model_manager.metadata import (
+ AnyModelRepoMetadata,
+)
+# to access the initialized sql database
+from invokeai.app.api.dependencies import ApiDependencies
+
+hf = HuggingFaceMetadataFetch()
+
+# fetch the metadata
+model_metadata = hf.from_id("")
+
+assert isinstance(model_metadata, HuggingFaceMetadata)
+```
+
+### Structure of the Metadata objects
+
+There is a short class hierarchy of Metadata objects, all of which descend from the Pydantic `BaseModel`.
+
+#### `ModelMetadataBase`
+
+This is the common base class for metadata:
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `name` | str | Repository's name for the model |
+| `author` | str | Model's author |
+| `tags` | Set[str] | Model tags |
+
+Note that the model config record also has a `name` field. It is intended that the config record version be locally customizable, while the metadata version is read-only. However, enforcing this is expected to be part of the business logic.
+
+Descendents of the base add additional fields.
+
+#### `HuggingFaceMetadata`
+
+This descends from `ModelMetadataBase` and adds the following fields:
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `type` | Literal["huggingface"] | Used for the discriminated union of metadata classes |
+| `id` | str | HuggingFace repo_id |
+| `tag_dict` | Dict[str, Any] | A dictionary of tag/value pairs provided in addition to `tags` |
+| `last_modified` | datetime | Date of last commit of this model to the repo |
+| `files` | List[Path] | List of the files in the model repo |
+
+#### `AnyModelRepoMetadata`
+
+This is a discriminated Union of `HuggingFaceMetadata`.
+
+### Fetching Metadata from Online Repos
+
+The `HuggingFaceMetadataFetch` class will retrieve metadata from its corresponding repository and return `AnyModelRepoMetadata` objects. Their base class `ModelMetadataFetchBase` is an abstract class that defines two methods: `from_url()` and `from_id()`. The former accepts the type of model URLs that the user will try to cut and paste into the model import form. The latter accepts a string ID in the format recognized by the repository of choice. Both methods return an `AnyModelRepoMetadata`.
+
+The base class also has a class method `from_json()` which will take the JSON representation of a `ModelMetadata` object, validate it, and return the corresponding `AnyModelRepoMetadata` object.
+
+When initializing one of the metadata fetching classes, you may provide a `requests.Session` argument. This allows you to customize the low-level HTTP fetch requests and is used, for instance, in the testing suite to avoid hitting the internet.
+
+The HuggingFace fetcher subclass add additional repo-specific fetching methods:
+
+#### HuggingFaceMetadataFetch
+
+This overrides its base class `from_json()` method to return a `HuggingFaceMetadata` object directly.
+
+### Metadata Storage
+
+The `ModelConfigBase` stores this response in the `source_api_response` field as a JSON blob.
+
+---
+
+## The Lowdown on the ModelLoadService
+
+The `ModelLoadService` is responsible for loading a named model into memory so that it can be used for inference. Despite the fact that it does a lot under the covers, it is very straightforward to use.
+
+An application-wide model loader is created at API initialization time and stored in `ApiDependencies.invoker.services.model_loader`. However, you can create alternative instances if you wish.
+
+### Creating a ModelLoadService object
+
+The class is defined in `invokeai.app.services.model_load`. It is initialized with an InvokeAIAppConfig object, from which it gets configuration information such as the user's desired GPU and precision, and with a previously-created `ModelRecordServiceBase` object, from which it loads the requested model's configuration information.
+
+Here is a typical initialization pattern:
+
+```py
+from invokeai.app.services.config import InvokeAIAppConfig
+from invokeai.app.services.model_load import ModelLoadService, ModelLoaderRegistry
+
+config = InvokeAIAppConfig.get_config()
+
+ram_cache = ModelCache(
+ max_cache_size=config.ram_cache_size, max_vram_cache_size=config.vram_cache_size, logger=logger
+)
+
+convert_cache = ModelConvertCache(
+ cache_path=config.models_convert_cache_path, max_size=config.convert_cache_size
+)
+
+loader = ModelLoadService(
+ app_config=config,
+ ram_cache=ram_cache,
+ convert_cache=convert_cache,
+ registry=ModelLoaderRegistry
+)
+```
+
+### load_model(model_config, [submodel_type], [context]) -> LoadedModel
+
+The `load_model()` method takes an `AnyModelConfig` returned by `ModelRecordService.get_model()` and returns the corresponding loaded model. It loads the model into memory, gets the model ready for use, and returns a `LoadedModel` object.
+
+The optional second argument, `subtype` is a `SubModelType` string enum, such as "vae". It is mandatory when used with a main model, and is used to select which part of the main model to load.
+
+The optional third argument, `context` can be provided by an invocation to trigger model load event reporting. See below for details.
+
+The returned `LoadedModel` object contains a copy of the configuration record returned by the model record`get_model()` method, as well as the in-memory loaded model:
+
+| Attribute Name | Type | Description |
+|----------------|------|-------------|
+| `config` | AnyModelConfig | A copy of the model's configuration record for retrieving base type, etc. |
+| `model` | AnyModel | The instantiated model (details below) |
+
+### get_model_by_key(key, [submodel]) -> LoadedModel
+
+The `get_model_by_key()` method will retrieve the model using its unique database key. For example:
+
+```py
+loaded_model = loader.get_model_by_key('f13dd932c0c35c22dcb8d6cda4203764', SubModelType('vae'))
+```
+
+`get_model_by_key()` may raise any of the following exceptions:
+
+* `UnknownModelException` -- key not in database
+* `ModelNotFoundException` -- key in database but model not found at path
+* `NotImplementedException` -- the loader doesn't know how to load this type of model
+
+### Using the Loaded Model in Inference
+
+`LoadedModel` acts as a context manager. The context loads the model into the execution device (e.g. VRAM on CUDA systems), locks the model in the execution device for the duration of the context, and returns the model. Use it like this:
+
+```py
+loaded_model_= loader.get_model_by_key('f13dd932c0c35c22dcb8d6cda4203764', SubModelType('vae'))
+with loaded_model as vae:
+ image = vae.decode(latents)[0]
+```
+
+The object returned by the LoadedModel context manager is an `AnyModel`, which is a Union of `ModelMixin`, `torch.nn.Module`, `IAIOnnxRuntimeModel`, `IPAdapter`, `IPAdapterPlus`, and `EmbeddingModelRaw`. `ModelMixin` is the base class of all diffusers models, `EmbeddingModelRaw` is used for LoRA and TextualInversion models. The others are obvious.
+
+In addition, you may call `LoadedModel.model_on_device()`, a context manager that returns a tuple of the model's state dict in CPU and the model itself in VRAM. It is used to optimize the LoRA patching and unpatching process:
+
+```py
+loaded_model_= loader.get_model_by_key('f13dd932c0c35c22dcb8d6cda4203764', SubModelType('vae'))
+with loaded_model.model_on_device() as (state_dict, vae):
+ image = vae.decode(latents)[0]
+```
+
+Since not all models have state dicts, the `state_dict` return value can be None.
+
+### Emitting model loading events
+
+When the `context` argument is passed to `load_model_*()`, it will retrieve the invocation event bus from the passed `InvocationContext` object to emit events on the invocation bus. The two events are "model_load_started" and "model_load_completed". Both carry the following payload:
+
+```py
+payload=dict(
+ queue_id=queue_id,
+ queue_item_id=queue_item_id,
+ queue_batch_id=queue_batch_id,
+ graph_execution_state_id=graph_execution_state_id,
+ model_key=model_key,
+ submodel_type=submodel,
+ hash=model_info.hash,
+ location=str(model_info.location),
+ precision=str(model_info.precision),
+)
+```
+
+### Adding Model Loaders
+
+Model loaders are small classes that inherit from the `ModelLoader` base class. They typically implement one method `_load_model()` whose signature is:
+
+```py
+def _load_model(
+ self,
+ model_path: Path,
+ model_variant: Optional[ModelRepoVariant] = None,
+ submodel_type: Optional[SubModelType] = None,
+) -> AnyModel:
+```
+
+`_load_model()` will be passed the path to the model on disk, an optional repository variant (used by the diffusers loaders to select, e.g. the `fp16` variant, and an optional submodel_type for main and onnx models.
+
+To install a new loader, place it in `invokeai/backend/model_manager/load/model_loaders`. Inherit from `ModelLoader` and use the `@ModelLoaderRegistry.register()` decorator to indicate what type of models the loader can handle.
+
+Here is a complete example from `generic_diffusers.py`, which is able to load several different diffusers types:
+
+```py
+from pathlib import Path
+from typing import Optional
+
+from invokeai.backend.model_manager import (
+ AnyModel,
+ BaseModelType,
+ ModelFormat,
+ ModelRepoVariant,
+ ModelType,
+ SubModelType,
+)
+from .. import ModelLoader, ModelLoaderRegistry
+
+
+@ModelLoaderRegistry.register(base=BaseModelType.Any, type=ModelType.CLIPVision, format=ModelFormat.Diffusers)
+@ModelLoaderRegistry.register(base=BaseModelType.Any, type=ModelType.T2IAdapter, format=ModelFormat.Diffusers)
+class GenericDiffusersLoader(ModelLoader):
+ """Class to load simple diffusers models."""
+
+ def _load_model(
+ self,
+ model_path: Path,
+ model_variant: Optional[ModelRepoVariant] = None,
+ submodel_type: Optional[SubModelType] = None,
+ ) -> AnyModel:
+ model_class = self._get_hf_load_class(model_path)
+ if submodel_type is not None:
+ raise Exception(f"There are no submodels in models of type {model_class}")
+ variant = model_variant.value if model_variant else None
+ result: AnyModel = model_class.from_pretrained(model_path, torch_dtype=self._torch_dtype, variant=variant) # type: ignore
+ return result
+```
+
+:::note
+ A loader can register itself to handle several different
+ model types. An exception will be raised if more than one loader tries
+ to register the same model type.
+:::
+
+#### Conversion
+
+Some models require conversion to diffusers format before they can be loaded. These loaders should override two additional methods:
+
+```py
+_needs_conversion(self, config: AnyModelConfig, model_path: Path, dest_path: Path) -> bool
+_convert_model(self, config: AnyModelConfig, model_path: Path, output_path: Path) -> Path:
+```
+
+The first method accepts the model configuration, the path to where the unmodified model is currently installed, and a proposed destination for the converted model. This method returns True if the model needs to be converted. It typically does this by comparing the last modification time of the original model file to the modification time of the converted model. In some cases you will also want to check the modification date of the configuration record, in the event that the user has changed something like the scheduler prediction type that will require the model to be re-converted. See `controlnet.py` for an example of this logic.
+
+The second method accepts the model configuration, the path to the original model on disk, and the desired output path for the converted model. It does whatever it needs to do to get the model into diffusers format, and returns the Path of the resulting model. (The path should ordinarily be the same as `output_path`.)
+
+## The ModelManagerService object
+
+For convenience, the API provides a `ModelManagerService` object which gives a single point of access to the major model manager services. This object is created at initialization time and can be found in the global `ApiDependencies.invoker.services.model_manager` object, or in `context.services.model_manager` from within an invocation.
+
+In the examples below, we have retrieved the manager using:
+
+```py
+mm = ApiDependencies.invoker.services.model_manager
+```
+
+The following properties and methods will be available:
+
+### mm.store
+
+This retrieves the `ModelRecordService` associated with the manager. Example:
+
+```py
+configs = mm.store.get_model_by_attr(name='stable-diffusion-v1-5')
+```
+
+### mm.install
+
+This retrieves the `ModelInstallService` associated with the manager. Example:
+
+```py
+job = mm.install.heuristic_import(`https://civitai.com/models/58390/detail-tweaker-lora-lora`)
+```
+
+### mm.load
+
+This retrieves the `ModelLoaderService` associated with the manager. Example:
+
+```py
+configs = mm.store.get_model_by_attr(name='stable-diffusion-v1-5')
+assert len(configs) > 0
+
+loaded_model = mm.load.load_model(configs[0])
+```
+
+The model manager also offers a few convenience shortcuts for loading models:
+
+### mm.load_model_by_config(model_config, [submodel], [context]) -> LoadedModel
+
+Same as `mm.load.load_model()`.
+
+### mm.load_model_by_attr(model_name, base_model, model_type, [submodel], [context]) -> LoadedModel
+
+This accepts the combination of the model's name, type and base, which it passes to the model record config store for retrieval. If a unique model config is found, this method returns a `LoadedModel`. It can raise the following exceptions:
+
+- `UnknownModelException` -- model with these attributes not known
+- `NotImplementedException` -- the loader doesn't know how to load this type of model
+- `ValueError` -- more than one model matches this combination of base/type/name
+
+### mm.load_model_by_key(key, [submodel], [context]) -> LoadedModel
+
+This method takes a model key, looks it up using the `ModelRecordServiceBase` object in `mm.store`, and passes the returned model configuration to `load_model_by_config()`. It may raise a `NotImplementedException`.
+
+## Invocation Context Model Manager API
+
+Within invocations, the following methods are available from the `InvocationContext` object:
+
+### context.download_and_cache_model(source) -> Path
+
+This method accepts a `source` of a remote model, downloads and caches it locally, and then returns a Path to the local model. The source can be a direct download URL or a HuggingFace repo_id.
+
+In the case of HuggingFace repo_id, the following variants are recognized:
+
+* stabilityai/stable-diffusion-v4 -- default model
+* stabilityai/stable-diffusion-v4:fp16 -- fp16 variant
+* stabilityai/stable-diffusion-v4:fp16:vae -- the fp16 vae subfolder
+* stabilityai/stable-diffusion-v4:onnx:vae -- the onnx variant vae subfolder
+
+You can also point at an arbitrary individual file within a repo_id directory using this syntax:
+
+* stabilityai/stable-diffusion-v4::/checkpoints/sd4.safetensors
+
+### context.load_local_model(model_path, [loader]) -> LoadedModel
+
+This method loads a local model from the indicated path, returning a `LoadedModel`. The optional loader is a Callable that accepts a Path to the object, and returns a `AnyModel` object. If no loader is provided, then the method will use `torch.load()` for a .ckpt or .bin checkpoint file, `safetensors.torch.load_file()` for a safetensors checkpoint file, or `cls.from_pretrained()` for a directory that looks like a diffusers directory.
+
+### context.load_remote_model(source, [loader]) -> LoadedModel
+
+This method accepts a `source` of a remote model, downloads and caches it locally, loads it, and returns a `LoadedModel`. The source can be a direct download URL or a HuggingFace repo_id.
+
+In the case of HuggingFace repo_id, the following variants are recognized:
+
+* stabilityai/stable-diffusion-v4 -- default model
+* stabilityai/stable-diffusion-v4:fp16 -- fp16 variant
+* stabilityai/stable-diffusion-v4:fp16:vae -- the fp16 vae subfolder
+* stabilityai/stable-diffusion-v4:onnx:vae -- the onnx variant vae subfolder
+
+You can also point at an arbitrary individual file within a repo_id directory using this syntax:
+
+* stabilityai/stable-diffusion-v4::/checkpoints/sd4.safetensors
diff --git a/docs/src/content/docs/development/Architecture/overview.mdx b/docs/src/content/docs/development/Architecture/overview.mdx
new file mode 100644
index 00000000000..8cbe18efad5
--- /dev/null
+++ b/docs/src/content/docs/development/Architecture/overview.mdx
@@ -0,0 +1,104 @@
+---
+title: Architecture Overview
+sidebar:
+ order: 1
+ label: Overview
+
+lastUpdated: 2026-02-18
+---
+
+import Mermaid from '@components/Mermaid.astro'
+
+
+```mermaid
+flowchart TB
+
+ subgraph apps[Applications]
+ webui[WebUI]
+ cli[CLI]
+
+ subgraph webapi[Web API]
+ api[HTTP API]
+ sio[Socket.IO]
+ end
+
+ end
+
+ subgraph invoke[Invoke]
+ direction LR
+ invoker
+ services
+ sessions
+ invocations
+ end
+
+ subgraph core[AI Core]
+ Generate
+ end
+
+ webui --> webapi
+ webapi --> invoke
+ cli --> invoke
+
+ invoker --> services & sessions
+ invocations --> services
+ sessions --> invocations
+
+ services --> core
+
+ %% Styles
+ classDef sg fill:#5028C8,font-weight:bold,stroke-width:2,color:#fff,stroke:#14141A
+ classDef default stroke-width:2px,stroke:#F6B314,color:#fff,fill:#14141A
+
+ class apps,webapi,invoke,core sg
+
+```
+
+
+## Applications
+
+Applications are built on top of the invoke framework. They should construct `invoker` and then interact through it. They should avoid interacting directly with core code in order to support a variety of configurations.
+
+### Web UI
+
+The Web UI is built on top of an HTTP API built with [FastAPI](https://fastapi.tiangolo.com/) and [Socket.IO](https://socket.io/). The frontend code is found in `/invokeai/frontend` and the backend code is found in `/invokeai/app/api_app.py` and `/invokeai/app/api/`. The code is further organized as such:
+
+| Component | Description |
+| --- | --- |
+| api_app.py | Sets up the API app, annotates the OpenAPI spec with additional data, and runs the API |
+| dependencies | Creates all invoker services and the invoker, and provides them to the API |
+| events | An eventing system that could in the future be adapted to support horizontal scale-out |
+| sockets | The Socket.IO interface - handles listening to and emitting session events (events are defined in the events service module) |
+| routers | API definitions for different areas of API functionality |
+
+### CLI
+
+The CLI is built automatically from invocation metadata, and also supports invocation piping and auto-linking. Code is available in `/invokeai/frontend/cli`.
+
+## Invoke
+
+The Invoke framework provides the interface to the underlying AI systems and is built with flexibility and extensibility in mind. There are four major concepts: invoker, sessions, invocations, and services.
+
+### Invoker
+
+The invoker (`/invokeai/app/services/invoker.py`) is the primary interface through which applications interact with the framework. Its primary purpose is to create, manage, and invoke sessions. It also maintains two sets of services:
+- **invocation services**, which are used by invocations to interact with core functionality.
+- **invoker services**, which are used by the invoker to manage sessions and manage the invocation queue.
+
+### Sessions
+
+Invocations and links between them form a graph, which is maintained in a session. Sessions can be queued for invocation, which will execute their graph (either the next ready invocation, or all invocations). Sessions also maintain execution history for the graph (including storage of any outputs). An invocation may be added to a session at any time, and there is capability to add and entire graph at once, as well as to automatically link new invocations to previous invocations. Invocations can not be deleted or modified once added.
+
+The session graph does not support looping. This is left as an application problem to prevent additional complexity in the graph.
+
+### Invocations
+
+Invocations represent individual units of execution, with inputs and outputs. All invocations are located in `/invokeai/app/invocations`, and are all automatically discovered and made available in the applications. These are the primary way to expose new functionality in Invoke.AI, and the [implementation guide](/development/architecture/invocations/) explains how to add new invocations.
+
+### Services
+
+Services provide invocations access AI Core functionality and other necessary functionality (e.g. image storage). These are available in `/invokeai/app/services`. As a general rule, new services should provide an interface as an abstract base class, and may provide a lightweight local implementation by default in their module. The goal for all services should be to enable the usage of different implementations (e.g. using cloud storage for image storage), but should not load any module dependencies unless that implementation has been used (i.e. don't import anything that won't be used, especially if it's expensive to import).
+
+## AI Core
+
+The AI Core is represented by the rest of the code base (i.e. the code outside of `/invokeai/app/`).
diff --git a/docs/src/content/docs/development/Documentation/index.mdx b/docs/src/content/docs/development/Documentation/index.mdx
new file mode 100644
index 00000000000..ae8b5248c1d
--- /dev/null
+++ b/docs/src/content/docs/development/Documentation/index.mdx
@@ -0,0 +1,314 @@
+---
+title: Documentation
+lastUpdated: 2026-05-14
+---
+
+import { Steps, Tabs, TabItem, FileTree } from '@astrojs/starlight/components'
+
+The Invoke AI website, including its documentation are all contained within the `docs` directory.
+
+## Prerequisites
+
+The documentation is built using [Astro Starlight](https://starlight.astro.build/). It's suggested you familiarize yourself with the following technologies before getting started:
+
+
+ 1. [Markdown](https://www.markdownguide.org/) - a lightweight markup language for creating formatted text.
+ 2. [MDX](https://mdxjs.com/) - a superset of Markdown that allows you to use React components in your content.
+ 3. [Astro](https://astro.build/) - a modern static site builder that supports MDX and other front-end technologies.
+ 4. [Starlight](https://starlight.astro.build/) - a theme for Astro that provides a clean and modern documentation experience.
+ 5. [Vite](https://vitejs.dev/) - a fast development server and build tool for modern web projects.
+
+
+Markdown powers the content of every page on the website (including the homepage), with additional help from [MDX](https://mdxjs.com/) to make the pages more interactive with imported React components.
+
+## Navigating the Documentation
+
+The documentation is organized into a file tree structure. It should be very familiar to anyone who has built modern web applications.
+
+
+ - docs/
+ - dist/ production build output
+ - public/ non-optimized, public assets
+ - src/ main source code
+ - assets/ optimized assets
+ - config/ astro/starlight configs
+ - content/ markdown pages and content
+ - docs/ documentation content
+ - i18n/ internationalized content
+ - generated/ generated json files for dynamic content
+ - layouts/ components used to wrap pages
+ - lib/ utility functions and shared code
+ - components/ reusable, custom components
+ - pages/ non-documentation pages
+ - styles/ global styles and themes
+
+
+## Development
+
+If you've ever worked within a react, astro or similar node-based library or framework, you should feel familiar with most of the setup here.
+
+If you're adding a feature, new behavior or etc. that changes how users expect Invoke to work, we expect you to deliver your PR with associated docs to support it. To get started, follow the steps below.
+
+### Dev Environment
+
+There are 2 main ways to get your development environment set up for documentation:
+
+
+
+ Invoke's makefile makes it easy to set up your development environment for documentation in only a couple of commands. You can run these from the root of the repository.
+
+
+ 1. First, install the required dependencies.
+
+ ```sh
+ make docs-install
+ ```
+
+ 2. Next, run the development server.
+
+ ```sh
+ make docs-dev
+ ```
+
+ 3. Open your browser and navigate to `http://localhost:4321` to view the documentation.
+
+
+
+
+ If you prefer good ol' fashioned `cd` and `pnpm` commands, you can set up your development environment manually.
+
+
+ 1. First, cd into the docs directory.
+
+ ```sh
+ cd docs
+ ```
+
+ 2. Next, install the required dependencies.
+
+ ```sh
+ pnpm install
+ ```
+
+ 3. Run the development server.
+
+ ```sh
+ pnpm dev
+ ```
+
+ 4. Open your browser and navigate to `http://localhost:4321` to view the documentation.
+
+
+
+
+If there's another local server running on port `4321` prior to running this, then use the port specified in the output.
+
+### Adding Pages
+
+Located within the `src/content/docs/` directory, this is where the documentation pages are stored and organized by category. These categories are file-based and are mirrored to the sidebar navigation.
+
+:::caution
+Do not place your docs content contributions outside of the `content` directory, it will not be seen.
+:::
+
+If you wish to add a new sub category to document a feature or a behavior, simply create a new directory within the relevant top-level category directory.
+
+For example, if we wanted to document a new feature called "Instant Bananas", we would create a new directory within `src/content/docs/features/` like so:
+
+`src/content/docs/`
+
+ - concepts/
+ - configuration/
+ - contributing/
+ - development/
+ - features/
+ - **instant-bananas/**
+ - **index.md** Write your documentation here
+ - **requirements.mdx** You can add more pages in this directory
+ - start-here/
+ - troubleshooting/
+ - workflows/
+
+
+The way you organize your added pages dictates how the URL structure is generated for your documentation pages. In this example, the url for the `index.md` page would be `https://invoke.ai/features/instant-bananas/`, and the url for the `requirements.mdx` page would be `https://invoke.ai/features/instant-bananas/requirements/`.
+
+If you wish to add a top-level category, then one additional step is required for the category to appear in the sidebar.
+
+Within the `src/config/sidebar.ts` file, you'll need to add a new sidebar category object to the array, since the fine-grained control over top-level categories needs to be a bit more explicit.
+
+```diff lang="js"
+const sidebar = [
+ // ...
+ {
+ label: 'Concepts',
+ items: [
+ {
+ autogenerate: { directory: 'concepts' },
+ },
+ ],
+ },
++ {
++ label: 'A New Category',
++ items: [
++ {
++ autogenerate: { directory: 'new-category' },
++ },
++ ],
++ },
+ {
+ label: 'Features',
+ items: [
+ {
+ autogenerate: { directory: 'features' },
+ },
+ ],
+ },
+ // ...
+]
+```
+
+### Page Metadata
+
+Before your page becomes available, you will need to add frontmatter to define the page's metadata such as its title, description, last update date, sidebar position, and etc.
+
+Learn more about what frontmatter is and how to use it in your pages in the [Starlight Documentation](https://starlight.astro.build/reference/frontmatter/).
+
+Once you have some basic frontmatter defined, you should be able to see it reflected in the sidebar and the page title.
+
+### Adding Images
+
+We encourage adding imagery to your docs for creating a more engaging and visual experience for viewers. To add images, we prefer you to utilize an `assets` directory within the concerning category.
+
+
+ - features/
+ - instant-bananas/
+ - **assets/**
+ - **demonstration.webp**
+ - **foobar.avif**
+ - index.mdx
+
+
+The Astro image optimizer/renderer is quite flexible with image formats and sizes, but we'd prefer stored images to be at reasonable sizes (not 4k), and using optimized formats (webp, avif, jpeg).
+
+To render the image, you'd just use a relative path in your markdown.
+
+```md title="index.mdx"
+
+```
+
+### Adding Translations
+
+Currently, the documentation is only available in English. If you wish to add translations for other languages, we've already laid the ground work for you to do so.
+
+Firstly, add a new folder within the `src/content/i18n` directory, and create your translated version of the markdown file into the same path as the original.
+
+For example:
+
+
+ - src/
+ - content/
+ - docs/
+ - start-here/
+ - installation.mdx
+ - i18n/
+ - zh-CN Country code here
+ - start-here/
+ - installation.mdx
+
+
+We recommend simply copy/pasting the file and rewriting the text from there.
+
+Learn more about the intricacies of translating Astro Starlight docs [here](https://starlight.astro.build/guides/i18n).
+
+## Running a Build
+
+Modifications to the docs may run fine on your machine, but as we've learned the hard way, GitHub pages flips that expectation completely. So, we've added some ways to ensure things work as expected before deploying.
+
+Just like with the dev environment, you can build the docs one of two ways:
+
+
+
+ Invoke's makefile makes it easy to build the documentation in only a single command. You can run it from the root of the repository.
+
+
+ 1. First, run the build command.
+
+ ```sh
+ make docs-build
+ ```
+
+ 2. Finally, preview the output.
+
+ ```sh
+ make docs-preview
+ ```
+
+
+ And that's it.
+
+ :::tip[Deploy Target]
+ The make command here sets the `DEPLOY_TARGET` environment variable to `custom`, so that the final output matches what you'd expect from the final deployment to https://invoke.ai.
+
+ If you'd rather set a different deploy target, use the manual method.
+ :::
+
+
+
+ If you prefer good ol' fashioned `cd` and `pnpm` commands, or to have granular control over environment variables, you can run the following:
+
+
+ 1. First, cd into the `docs` directory.
+
+ ```sh
+ cd docs
+ ```
+
+ 2. Next run the build command.
+
+ ```sh
+ pnpm run build
+ ```
+
+ 3. Finally, preview the build.
+
+ ```sh
+ pnpm run preview
+ ```
+
+ The preview url will be available on the same port as the dev server.
+
+
+
+
+
+## Generated Files
+
+The Invoke API is always evolving, and quite large. Documenting all this by hand would be wildly impractical, so there's a script we've set up to pull all that data and generate relevant json files into `generated` directory.
+
+These files are used for the [YAML Config](/configuration/invokeai-yaml) and [API Development](/development/guides/api-development) pages. If you're adding a feature that changes the yaml config, or the api then make sure to run `pnpm run generate-docs-data` to ensure tests pass, and that the docs are accurate in accordance to your updates.
+
+## Testing
+
+The docs contain tests for the following:
+
+| Test | Description | Runs on... |
+| -- | -- | -- |
+| Link Checker | Checks for invalid, malformed or misdirected internal link URLs | Dev Server, Build, Deploy |
+| Verify Deployment Output | Check to ensure the asset and page paths have the expected base paths dependent on deploy targets | Build, Deploy |
+| Check Docs Data | Checks to ensure the generated files are accurate | Deploy |
+
+## GitHub Actions
+
+Once you've submitted your updated docs, either via pull request or a main push to your own fork, the `deploy-docs` action will run.
+
+The `deploy-docs` action will install the necessary dependencies, run a build, test and serve the docs on github pages. Any failing deployments will require fixing before deploying.
+
+## Troubleshooting
+
+#### All the styles are missing and the links are wrong, what happened?
+
+This commonly happens when the base path and the deploy target are mismatched, check those first and then run your build again.
+
+#### Redirects aren't working on the production deployment, but they work locally, why?
+
+Because GitHub Pages' SSR environment is lackluster, and thus doesn't handle backend redirects. We included a redirects configuration just in case GitHub ever grows a conscience, or if the docs ever get deployed someplace else.
diff --git a/docs/src/content/docs/development/Front End/canvas-projects.mdx b/docs/src/content/docs/development/Front End/canvas-projects.mdx
new file mode 100644
index 00000000000..b36c2ce9720
--- /dev/null
+++ b/docs/src/content/docs/development/Front End/canvas-projects.mdx
@@ -0,0 +1,54 @@
+---
+title: Canvas Projects
+---
+
+Canvas projects serialize the current canvas into a portable `.invk` archive. The feature lives in `invokeai/frontend/web/src/features/controlLayers/` and is exposed in the canvas toolbar archive menu and the canvas context menu under **Project**.
+
+## File format
+
+`.invk` files are ZIP archives. The current manifest version is `1`.
+
+Each archive contains:
+
+| Target | Description |
+| - | - |
+| `manifest.json` | project metadata, including the archive version, app version, creation timestamp, and project name. |
+| `canvas_state.json` | raster layers, control layers, inpaint masks, regional guidance, bounding box state, and selected/bookmarked entity identifiers. |
+| `params.json` | generation parameter state. |
+| `ref_images.json` | global reference image state. |
+| `loras.json` | active LoRA state. |
+| `images/` | image blobs referenced by the canvas or reference image state. |
+
+The save path builds this archive in `useCanvasProjectSave.ts`. It collects all referenced `image_name` values, fetches each image from the server, writes successfully fetched files under `images/`, and downloads the ZIP with the `.invk` extension. Failed image fetches are logged and skipped rather than aborting the save.
+
+## Image collection
+
+Image references are collected by `collectImageNames()` in `canvasProjectFile.ts`.
+
+The collector checks:
+
+- Image objects in raster layers.
+- Image objects in control layers.
+- Image objects in inpaint masks.
+- Image objects and IP Adapter / Flux Redux reference images in regional guidance.
+- Global reference images, including cropped source images.
+
+Image fetches are concurrency-limited with `processWithConcurrencyLimit()` so large projects do not flood the browser or backend with simultaneous requests.
+
+## Loading and remapping
+
+The load path is implemented in `useCanvasProjectLoad.ts`.
+
+Loading validates `manifest.json`, requires `canvas_state.json`, and reads optional `params.json`, `ref_images.json`, and `loras.json` files. Before restoring state, it checks whether each referenced image already exists on the server with `checkExistingImages()`.
+
+Only missing images are uploaded from the archive. If a referenced missing image is not present in `images/`, the loader logs a warning and leaves that reference unchanged. If an upload returns a different `image_name`, the loader records an old-to-new mapping and remaps image references before dispatching restored canvas and reference image state.
+
+LoRAs are cleared before project LoRAs are recalled. This prevents LoRAs from the previous canvas session from leaking into the loaded project.
+
+Image existence checks and uploads are also concurrency-limited.
+
+## Compatibility notes
+
+The archive stores references to models, LoRAs, and other generation resources, not the model files themselves. Loading a project on another install can restore the canvas images and state, but missing model resources still need to be installed or replaced by the user.
+
+Future format changes should increment `CANVAS_PROJECT_VERSION` and keep validation in `parseManifest()` explicit so unsupported project files fail early.
diff --git a/docs/src/content/docs/development/Front End/index.md b/docs/src/content/docs/development/Front End/index.md
new file mode 100644
index 00000000000..4e12e59efe2
--- /dev/null
+++ b/docs/src/content/docs/development/Front End/index.md
@@ -0,0 +1,131 @@
+---
+title: Frontend Development
+lastUpdated: 2026-02-18
+---
+
+Invoke's UI is made possible by many contributors and open-source libraries. Thank you!
+
+## Dev environment
+
+Follow the [dev environment](/development/setup/dev-environment/) guide to get set up. Run the UI using `pnpm dev`.
+
+## Package scripts
+
+- `dev`: run the frontend in dev mode, enabling hot reloading
+- `build`: run all checks (dpdm, eslint, prettier, tsc, knip) and then build the frontend
+- `lint:dpdm`: check circular dependencies
+- `lint:eslint`: check code quality
+- `lint:prettier`: check code formatting
+- `lint:tsc`: check type issues
+- `lint:knip`: check for unused exports or objects
+- `lint`: run all checks concurrently
+- `fix`: run `eslint` and `prettier`, fixing fixable issues
+- `test:ui`: run `vitest` with the fancy web UI
+
+## Type generation
+
+We use [openapi-typescript] to generate types from the app's OpenAPI schema. The generated types are committed to the repo in [schema.ts].
+
+If you make backend changes, it's important to regenerate the frontend types:
+
+```sh
+cd invokeai/frontend/web && python ../../../scripts/generate_openapi_schema.py | pnpm typegen
+```
+
+On macOS and Linux, you can run `make frontend-typegen` as a shortcut for the above snippet.
+
+## Localization
+
+We use [i18next] for localization, but translation to languages other than English happens on our [Weblate] project.
+
+Only the English source strings (i.e. `en.json`) should be changed on this repo.
+
+## VSCode
+
+### Example debugger config
+
+```jsonc
+{
+ "version": "0.2.0",
+ "configurations": [
+ {
+ "type": "chrome",
+ "request": "launch",
+ "name": "Invoke UI",
+ "url": "http://localhost:5173",
+ "webRoot": "${workspaceFolder}/invokeai/frontend/web"
+ }
+ ]
+}
+```
+
+### Remote dev
+
+We've noticed an intermittent timeout issue with the VSCode remote dev port forwarding.
+
+We suggest disabling the editor's port forwarding feature and doing it manually via SSH:
+
+```sh
+ssh -L 9090:localhost:9090 -L 5173:localhost:5173 user@host
+```
+
+## Contributing Guidelines
+
+Thanks for your interest in contributing to the Invoke Web UI!
+
+Please follow these guidelines when contributing.
+
+## Check in before investing your time
+
+Please check in before you invest your time on anything besides a trivial fix, in case it conflicts with ongoing work or isn't aligned with the vision for the app.
+
+If a feature request or issue doesn't already exist for the thing you want to work on, please create one.
+
+Ping `@psychedelicious` on [discord] in the `#frontend-dev` channel or in the feature request / issue you want to work on - we're happy to chat.
+
+## Code conventions
+
+- This is a fairly complex app with a deep component tree. Please use memoization (`useCallback`, `useMemo`, `memo`) with enthusiasm.
+- If you need to add some global, ephemeral state, please use [nanostores] if possible.
+- Be careful with your redux selectors. If they need to be parameterized, consider creating them inside a `useMemo`.
+- Feel free to use `lodash` (via `lodash-es`) to make the intent of your code clear.
+- Please add comments describing the "why", not the "how" (unless it is really arcane).
+
+## Commit format
+
+Please use the [conventional commits] spec for the web UI, with a scope of "ui":
+
+- `chore(ui): bump deps`
+- `chore(ui): lint`
+- `feat(ui): add some cool new feature`
+- `fix(ui): fix some bug`
+
+## Tests
+
+We don't do any UI testing at this time, but consider adding tests for sensitive logic.
+
+We use `vitest`, and tests should be next to the file they are testing. If the logic is in `something.ts`, the tests should be in `something.test.ts`.
+
+In some situations, we may want to test types. For example, if you use `zod` to create a schema that should match a generated type, it's best to add a test to confirm that the types match. Use `tsafe`'s assert for this.
+
+## Submitting a PR
+
+- Ensure your branch is tidy. Use an interactive rebase to clean up the commit history and reword the commit messages if they are not descriptive.
+- Run `pnpm lint`. Some issues are auto-fixable with `pnpm fix`.
+- Fill out the PR form when creating the PR.
+ - It doesn't need to be super detailed, but a screenshot or video is nice if you changed something visually.
+ - If a section isn't relevant, delete it.
+
+## Other docs
+
+- [Workflows - Design and Implementation]
+- [State Management]
+
+[discord]: https://discord.gg/ZmtBAhwWhy
+[i18next]: https://github.com/i18next/react-i18next
+[Weblate]: https://hosted.weblate.org/engage/invokeai/
+[openapi-typescript]: https://github.com/openapi-ts/openapi-typescript
+[schema.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/services/api/schema.ts
+[conventional commits]: https://www.conventionalcommits.org/en/v1.0.0/
+[Workflows - Design and Implementation]: ./workflows/
+[State Management]: ./state-management/
diff --git a/docs/src/content/docs/development/Front End/state-management.mdx b/docs/src/content/docs/development/Front End/state-management.mdx
new file mode 100644
index 00000000000..96fede7ba7f
--- /dev/null
+++ b/docs/src/content/docs/development/Front End/state-management.mdx
@@ -0,0 +1,41 @@
+---
+title: State Management
+lastUpdated: 2026-02-18
+---
+
+The app makes heavy use of Redux Toolkit, its Query library, and `nanostores`.
+
+## Redux
+
+We use RTK extensively - slices, entity adapters, queries, reselect, the whole 9 yards. Their [docs](https://redux-toolkit.js.org/) are excellent.
+
+## `nanostores`
+
+[nanostores] is a tiny state management library. It provides both imperative and declarative APIs.
+
+### Example
+
+```ts
+export const $myStringOption = atom(null);
+
+// Outside a component, or within a callback for performance-critical logic
+$myStringOption.get();
+$myStringOption.set('new value');
+
+// Inside a component
+const myStringOption = useStore($myStringOption);
+```
+
+### Where to put nanostores
+
+- For global application state, export your stores from `invokeai/frontend/web/src/app/store/nanostores/`.
+- For feature state, create a file for the stores next to the redux slice definition (e.g. `invokeai/frontend/web/src/features/myFeature/myFeatureNanostores.ts`).
+- For hooks with global state, export the store from the same file the hook is in, or put it next to the hook.
+
+### When to use nanostores
+
+- For non-serializable data that needs to be available throughout the app, use `nanostores` instead of a global.
+- For ephemeral global state (i.e. state that does not need to be persisted), use `nanostores` instead of redux.
+- For performance-critical code and in callbacks, redux selectors can be problematic due to the declarative reactivity system. Consider refactoring to use `nanostores` if there's a **measurable** performance issue.
+
+[nanostores]: https://github.com/nanostores/nanostores/
diff --git a/docs/src/content/docs/development/Front End/text-tool.mdx b/docs/src/content/docs/development/Front End/text-tool.mdx
new file mode 100644
index 00000000000..5b19bbeef9f
--- /dev/null
+++ b/docs/src/content/docs/development/Front End/text-tool.mdx
@@ -0,0 +1,37 @@
+---
+title: "Canvas Text Tool"
+---
+
+## Overview
+
+The canvas text workflow is split between a Konva module that owns tool state and a React overlay that handles text entry.
+
+- `invokeai/frontend/web/src/features/controlLayers/konva/CanvasTool/CanvasTextToolModule.ts`
+ - Owns the tool, cursor preview, and text session state (including the cursor "T" marker).
+ - Manages dynamic cursor contrast, starts sessions on pointer down, and commits sessions by rasterizing the active text block into a new raster layer.
+- `invokeai/frontend/web/src/features/controlLayers/components/Text/CanvasTextOverlay.tsx`
+ - Renders the on-canvas editor as a `contentEditable` overlay positioned in canvas space.
+ - Syncs keyboard input, suppresses app hotkeys, and forwards commits/cancels to the Konva module.
+- `invokeai/frontend/web/src/features/controlLayers/components/Text/TextToolOptions.tsx`
+ - Provides the font dropdown, size slider/input, formatting toggles, and alignment buttons that appear when the Text tool is active.
+
+## Rasterization pipeline
+
+`renderTextToCanvas()` (`invokeai/frontend/web/src/features/controlLayers/text/textRenderer.ts`) converts the editor contents into a transparent canvas. The Text tool module configures the renderer with the active font stack, weight, styling flags, alignment, and the active canvas color. The resulting canvas is encoded to a PNG data URL and stored in a new raster layer (`image` object) with a transparent background.
+
+Layer placement preserves the original click location:
+
+- The session stores the anchor coordinate (where the user clicked) and current alignment.
+- `calculateLayerPosition()` calculates the top-left position for the raster layer after applying the configured padding and alignment offsets.
+- New layers are inserted directly above the currently-selected raster layer (when present) and selected automatically.
+
+## Font stacks
+
+Font definitions live in `invokeai/frontend/web/src/features/controlLayers/text/textConstants.ts` as ten deterministic stacks (sans, serif, mono, rounded, script, humanist, slab serif, display, narrow, UI serif). Each stack lists system-safe fallbacks so the editor can choose the first available font per platform.
+
+To add or adjust fonts:
+
+1. Update `TEXT_FONT_STACKS` with the new `id`, `label`, and CSS `font-family` stack.
+2. If you add a new stack, extend the `TEXT_FONT_IDS` tuple and update the `canvasTextSlice` schema default (`TEXT_DEFAULT_FONT_ID`).
+3. Provide translation strings for any new labels in `public/locales/*`.
+4. The editor and renderer will automatically pick up the new stack via `getFontStackById()`.
diff --git a/docs/src/content/docs/development/Front End/workflows.mdx b/docs/src/content/docs/development/Front End/workflows.mdx
new file mode 100644
index 00000000000..d083bb8df1e
--- /dev/null
+++ b/docs/src/content/docs/development/Front End/workflows.mdx
@@ -0,0 +1,315 @@
+---
+title: Workflows
+lastUpdated: 2026-02-18
+---
+
+This document describes, at a high level, the design and implementation of workflows in the InvokeAI frontend. There are a substantial number of implementation details not included, but which are hopefully clear from the code.
+
+InvokeAI's backend uses graphs, composed of **nodes** and **edges**, to process data and generate images.
+
+Nodes have any number of **input fields** and **output fields**. Edges connect nodes together via their inputs and outputs. Fields have data types which dictate how they may be connected.
+
+During execution, a nodes' outputs may be passed along to any number of other nodes' inputs.
+
+Workflows are an enriched abstraction over a graph.
+
+## Design
+
+InvokeAI provide two ways to build graphs in the frontend: the [Linear UI](#linear-ui) and [Workflow Editor](#workflow-editor).
+
+To better understand the use case and challenges related to workflows, we will review both of these modes.
+
+### Linear UI
+
+This includes the **Text to Image**, **Image to Image** and **Unified Canvas** tabs.
+
+The user-managed parameters on these tabs are stored as simple objects in the application state. When the user invokes, adding a generation to the queue, we internally build a graph from these parameters.
+
+This logic can be fairly complex due to the range of features available and their interactions. Depending on the parameters selected, the graph may be very different. Building graphs in code can be challenging - you are trying to construct a non-linear structure in a linear context.
+
+The simplest graph building logic is for **Text to Image** with a SD1.5 model: [buildLinearTextToImageGraph.ts]
+
+There are many other graph builders in the same directory for different tabs or base models (e.g. SDXL). Some are pretty hairy.
+
+In the Linear UI, we go straight from **simple application state** to **graph** via these builders.
+
+### Workflow Editor
+
+The Workflow Editor is a visual graph editor, allowing users to draw edges from node to node to construct a graph. This _far_ more approachable way to create complex graphs.
+
+InvokeAI uses the [reactflow] library to power the Workflow Editor. It provides both a graph editor UI and manages its own internal graph state.
+
+#### Workflows
+
+A workflow is a representation of a graph plus additional metadata:
+
+- Name
+- Description
+- Version
+- Notes
+- [Exposed fields](#workflow-linear-view)
+- Author, tags, category, etc.
+
+Workflows should have other qualities:
+
+- Portable: you should be able to load a workflow created by another person.
+- Resilient: you should be able to "upgrade" a workflow as the application changes.
+- Abstract: as much as is possible, workflows should not be married to the specific implementation details of the application.
+
+To support these qualities, workflows are serializable, have a versioned schemas, and represent graphs as minimally as possible. Fortunately, the reactflow state for nodes and edges works perfectly for this.
+
+##### Workflow -> reactflow state -> InvokeAI graph
+
+Given a workflow, we need to be able to derive reactflow state and/or an InvokeAI graph from it.
+
+The first step - workflow to reactflow state - is very simple. The logic is in [nodesSlice.ts], in the `workflowLoaded` reducer.
+
+The reactflow state is, however, structurally incompatible with our backend's graph structure. When a user invokes on a Workflow, we need to convert the reactflow state into an InvokeAI graph. This is far simpler than the graph building logic from the Linear UI:
+[buildNodesGraph.ts]
+
+##### Nodes vs Invocations
+
+We often use the terms "node" and "invocation" interchangeably, but they may refer to different things in the frontend.
+
+reactflow [has its own definitions][reactflow-concepts] of "node", "edge" and "handle" which are closely related to InvokeAI graph concepts.
+
+- A reactflow node is related to an InvokeAI invocation. It has a "data" property, which holds the InvokeAI-specific invocation data.
+- A reactflow edge is roughly equivalent to an InvokeAI edge.
+- A reactflow handle is roughly equivalent to an InvokeAI input or output field.
+
+##### Workflow Linear View
+
+Graphs are very capable data structures, but not everyone wants to work with them all the time.
+
+To allow less technical users - or anyone who wants a less visually noisy workspace - to benefit from the power of nodes, InvokeAI has a workflow feature called the Linear View.
+
+A workflow input field can be added to this Linear View, and its input component can be presented similarly to the Linear UI tabs. Internally, we add the field to the workflow's list of exposed fields.
+
+#### OpenAPI Schema
+
+OpenAPI is a schema specification that can represent complex data structures and relationships. The backend is capable of generating an OpenAPI schema for all invocations.
+
+When the UI connects, it requests this schema and parses each invocation into an **invocation template**. Invocation templates have a number of properties, like title, description and type, but the most important ones are their input and output **field templates**.
+
+Invocation and field templates are the "source of truth" for graphs, because they indicate what the backend is able to process.
+
+When a user adds a new node to their workflow, these templates are used to instantiate a node with fields instantiated from the input and output field templates.
+
+##### Field Instances and Templates
+
+Field templates consist of:
+
+- Name: the identifier of the field, its variable name in python
+- Type: derived from the field's type annotation in python (e.g. IntegerField, ImageField, MainModelField)
+- Constraints: derived from the field's creation args in python (e.g. minimum value for an integer)
+- Default value: optionally provided in the field's creation args (e.g. 42 for an integer)
+
+Field instances are created from the templates and have name, type and optionally a value.
+
+The type of the field determines the UI components that are rendered for it.
+
+A field instance's name associates it with its template.
+
+##### Stateful vs Stateless Fields
+
+**Stateful** fields store their value in the frontend graph. Think primitives, model identifiers, images, etc. Fields are only stateful if the frontend allows the user to directly input a value for them.
+
+Many field types, however, are **stateless**. An example is a `UNetField`, which contains some data describing a UNet. Users cannot directly provide this data - it is created and consumed in the backend.
+
+Stateless fields do not store their value in the node, so their field instances do not have values.
+
+"Custom" fields will always be treated as stateless fields.
+
+##### Single and Collection Fields
+
+Field types have a name and cardinality property which may identify it as a **SINGLE**, **COLLECTION** or **SINGLE_OR_COLLECTION** field.
+
+- If a field is annotated in python as a singular value or class, its field type is parsed as a **SINGLE** type (e.g. `int`, `ImageField`, `str`).
+- If a field is annotated in python as a list, its field type is parsed as a **COLLECTION** type (e.g. `list[int]`).
+- If it is annotated as a union of a type and list, the type will be parsed as a **SINGLE_OR_COLLECTION** type (e.g. `Union[int, list[int]]`). Fields may not be unions of different types (e.g. `Union[int, list[str]]` and `Union[int, str]` are not allowed).
+
+## Implementation
+
+The majority of data structures in the backend are [pydantic] models. Pydantic provides OpenAPI schemas for all models and we then generate TypeScript types from those.
+
+The OpenAPI schema is parsed at runtime into our invocation templates.
+
+Workflows and all related data are modeled in the frontend using [zod]. Related types are inferred from the zod schemas.
+
+> In python, invocations are pydantic models with fields. These fields become node inputs. The invocation's `invoke()` function returns a pydantic model - its output. Like the invocation itself, the output model has any number of fields, which become node outputs.
+
+### zod Schemas and Types
+
+The zod schemas, inferred types, and type guards are in [types/].
+
+Roughly order from lowest-level to highest:
+
+- `common.ts`: stateful field data, and couple other misc types
+- `field.ts`: fields - types, values, instances, templates
+- `invocation.ts`: invocations and other node types
+- `workflow.ts`: workflows and constituents
+
+We customize the OpenAPI schema to include additional properties on invocation and field schemas. To facilitate parsing this schema into templates, we modify/wrap the types from [openapi-types] in `openapi.ts`.
+
+### OpenAPI Schema Parsing
+
+The entrypoint for OpenAPI schema parsing is [parseSchema.ts].
+
+General logic flow:
+
+- Iterate over all invocation schema objects
+ - Extract relevant invocation-level attributes (e.g. title, type, version, etc)
+ - Iterate over the invocation's input fields
+ - [Parse each field's type](#parsing-field-types)
+ - [Build a field input template](#building-field-input-templates) from the type - either a stateful template or "generic" stateless template
+ - Iterate over the invocation's output fields
+ - Parse the field's type (same as inputs)
+ - [Build a field output template](#building-field-output-templates)
+ - Assemble the attributes and fields into an invocation template
+
+Most of these involve very straightforward `reduce`s, but the less intuitive steps are detailed below.
+
+#### Parsing Field Types
+
+Field types are represented as structured objects:
+
+```ts
+type FieldType = {
+ name: string;
+ cardinality: 'SINGLE' | 'COLLECTION' | 'SINGLE_OR_COLLECTION';
+};
+```
+
+The parsing logic is in `parseFieldType.ts`.
+
+There are 4 general cases for field type parsing.
+
+##### Primitive Types
+
+When a field is annotated as a primitive values (e.g. `int`, `str`, `float`), the field type parsing is fairly straightforward. The field is represented by a simple OpenAPI **schema object**, which has a `type` property.
+
+We create a field type name from this `type` string (e.g. `string` -> `StringField`). The cardinality is `"SINGLE"`.
+
+##### Complex Types
+
+When a field is annotated as a pydantic model (e.g. `ImageField`, `MainModelField`, `ControlField`), it is represented as a **reference object**. Reference objects are pointers to another schema or reference object within the schema.
+
+We need to **dereference** the schema to pull these out. Dereferencing may require recursion. We use the reference object's name directly for the field type name.
+
+> Unfortunately, at this time, we've had limited success using external libraries to deference at runtime, so we do this ourselves.
+
+##### Collection Types
+
+When a field is annotated as a list of a single type, the schema object has an `items` property. They may be a schema object or reference object and must be parsed to determine the item type.
+
+We use the item type for field type name. The cardinality is `"COLLECTION"`.
+
+##### Single or Collection Types
+
+When a field is annotated as a union of a type and list of that type, the schema object has an `anyOf` property, which holds a list of valid types for the union.
+
+After verifying that the union has two members (a type and list of the same type), we use the type for field type name, with cardinality `"SINGLE_OR_COLLECTION"`.
+
+##### Optional Fields
+
+In OpenAPI v3.1, when an object is optional, it is put into an `anyOf` along with a primitive schema object with `type: 'null'`.
+
+Handling this adds a fair bit of complexity, as we now must filter out the `'null'` types and work with the remaining types as described above.
+
+If there is a single remaining schema object, we must recursively call to `parseFieldType()` to get parse it.
+
+#### Building Field Input Templates
+
+Now that we have a field type, we can build an input template for the field.
+
+Stateful fields all get a function to build their template, while stateless fields are constructed directly. This is possible because stateless fields have no default value or constraints.
+
+See [buildFieldInputTemplate.ts].
+
+#### Building Field Output Templates
+
+Field outputs are similar to stateless fields - they do not have any value in the frontend. When building their templates, we don't need a special function for each field type.
+
+See [buildFieldOutputTemplate.ts].
+
+### Managing reactflow State
+
+As described above, the workflow editor state is the essentially the reactflow state, plus some extra metadata.
+
+We provide reactflow with an array of nodes and edges via redux, and a number of [event handlers][reactflow-events]. These handlers dispatch redux actions, managing nodes and edges.
+
+The pieces of redux state relevant to workflows are:
+
+- `state.nodes.nodes`: the reactflow nodes state
+- `state.nodes.edges`: the reactflow edges state
+- `state.nodes.workflow`: the workflow metadata
+
+#### Building Nodes and Edges
+
+A reactflow node has a few important top-level properties:
+
+- `id`: unique identifier
+- `type`: a string that maps to a react component to render the node
+- `position`: XY coordinates
+- `data`: arbitrary data
+
+When the user adds a node, we build **invocation node data**, storing it in `data`. Invocation properties (e.g. type, version, label, etc.) are copied from the invocation template. Inputs and outputs are built from the invocation template's field templates.
+
+See [buildInvocationNode.ts].
+
+Edges are managed by reactflow, but briefly, they consist of:
+
+- `source`: id of the source node
+- `sourceHandle`: id of the source node handle (output field)
+- `target`: id of the target node
+- `targetHandle`: id of the target node handle (input field)
+
+> Edge creation is gated behind validation logic. This validation compares the input and output field types and overall graph state.
+
+#### Building a Workflow
+
+Building a workflow entity is as simple as dropping the nodes, edges and metadata into an object.
+
+Each node and edge is parsed with a zod schema, which serves to strip out any unneeded data.
+
+See [buildWorkflow.ts].
+
+#### Loading a Workflow
+
+Workflows may be loaded from external sources or the user's local instance. In all cases, the workflow needs to be handled with care, as an untrusted object.
+
+Loading has a few stages which may throw or warn if there are problems:
+
+- Parsing the workflow data structure itself, [migrating](#workflow-migrations) it if necessary (throws)
+- Check for a template for each node (warns)
+- Check each node's version against its template (warns)
+- Validate the source and target of each edge (warns)
+
+This validation occurs in [validateWorkflow.ts].
+
+If there are no fatal errors, the workflow is then stored in redux state.
+
+### Workflow Migrations
+
+When the workflow schema changes, we may need to perform some data migrations. This occurs as workflows are loaded. zod schemas for each workflow schema version is retained to facilitate migrations.
+
+Previous schemas are in folders in `invokeai/frontend/web/src/features/nodes/types/`, eg `v1/`.
+
+Migration logic is in [migrations.ts].
+
+[pydantic]: https://github.com/pydantic/pydantic 'pydantic'
+[zod]: https://github.com/colinhacks/zod 'zod'
+[openapi-types]: https://github.com/kogosoftwarellc/open-api/tree/main/packages/openapi-types 'openapi-types'
+[reactflow]: https://github.com/xyflow/xyflow 'reactflow'
+[reactflow-concepts]: https://reactflow.dev/learn/concepts/terms-and-definitions
+[reactflow-events]: https://reactflow.dev/api-reference/react-flow#event-handlers
+[buildWorkflow.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/util/workflow/buildWorkflow.ts
+[nodesSlice.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/store/nodesSlice.ts
+[buildLinearTextToImageGraph.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/util/graph/buildLinearTextToImageGraph.ts
+[buildNodesGraph.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/util/graph/buildNodesGraph.ts
+[buildInvocationNode.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/util/node/buildInvocationNode.ts
+[validateWorkflow.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/util/workflow/validateWorkflow.ts
+[migrations.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/util/workflow/migrations.ts
+[parseSchema.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/util/schema/parseSchema.ts
+[buildFieldInputTemplate.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/util/schema/buildFieldInputTemplate.ts
+[buildFieldOutputTemplate.ts]: https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/src/features/nodes/util/schema/buildFieldOutputTemplate.ts
diff --git a/docs/src/content/docs/development/Guides/api-development.mdx b/docs/src/content/docs/development/Guides/api-development.mdx
new file mode 100644
index 00000000000..3911dad0081
--- /dev/null
+++ b/docs/src/content/docs/development/Guides/api-development.mdx
@@ -0,0 +1,50 @@
+---
+title: API Development
+---
+
+import InvocationContextDocs from '@lib/components/InvocationContextDocs.astro'
+
+Each invocation's `invoke` method is provided a single arg - the Invocation Context.
+
+This object provides an API the invocation can use to interact with application services, for example:
+
+- Saving images
+- Logging messages
+- Loading models
+
+```py
+class MyInvocation(BaseInvocation):
+ ...
+ def invoke(self, context: InvocationContext) -> ImageOutput:
+ # Load an image
+ image_pil = context.images.get_pil(self.image.image_name)
+ # Do something to the image
+ output_image = do_something_cool(image_pil)
+ # Save the image
+ image_dto = context.images.save(output_image)
+ # Log a message
+ context.logger.info(f"Did something cool, image saved!")
+ # Return the output
+ return ImageOutput.build(image_dto)
+ ...
+```
+
+The full generated API reference is documented below.
+
+## Mixins
+
+Two important mixins are provided to facilitate working with metadata and gallery boards.
+
+### `WithMetadata`
+
+Inherit from this class (in addition to `BaseInvocation`) to add a `metadata` input to your node. When you do this, you can access the metadata dict from `self.metadata` in the `invoke()` function.
+
+The dict will be populated via the node's input, and you can add any metadata you'd like to it. When you call `context.images.save()`, if the metadata dict has any data, it be automatically embedded in the image.
+
+### `WithBoard`
+
+Inherit from this class (in addition to `BaseInvocation`) to add a `board` input to your node. This renders as a drop-down to select a board. The user's selection will be accessible from `self.board` in the `invoke()` function.
+
+When you call `context.images.save()`, if a board was selected, the image will added to that board as it is saved.
+
+
diff --git a/docs/assets/contributing/html-detail.png b/docs/src/content/docs/development/Guides/assets/html-detail.png
similarity index 100%
rename from docs/assets/contributing/html-detail.png
rename to docs/src/content/docs/development/Guides/assets/html-detail.png
diff --git a/docs/assets/contributing/html-overview.png b/docs/src/content/docs/development/Guides/assets/html-overview.png
similarity index 100%
rename from docs/assets/contributing/html-overview.png
rename to docs/src/content/docs/development/Guides/assets/html-overview.png
diff --git a/docs/src/content/docs/development/Guides/creating-node-pack.mdx b/docs/src/content/docs/development/Guides/creating-node-pack.mdx
new file mode 100644
index 00000000000..01a51afbcb5
--- /dev/null
+++ b/docs/src/content/docs/development/Guides/creating-node-pack.mdx
@@ -0,0 +1,157 @@
+---
+title: Creating Node Packs
+lastUpdated: 2026-05-23
+---
+
+import { FileTree } from '@astrojs/starlight/components'
+
+This guide explains how to structure your Git repository so it can be installed via InvokeAI's Custom Node Manager.
+
+## Repository Structure
+
+Your repository **is** the node pack. When a user installs it, the entire repo is cloned into the `nodes` directory.
+
+### Minimum Required Structure
+
+
+ - my-node-pack/
+ - `__init__.py` Required: Imports all node classes
+ - my_node.py Your node implementation(s)
+ - README.md Recommended: Describe how your nodes work
+
+
+The `__init__.py` at the root is **mandatory**. Without it, the pack will not be loaded.
+
+### Recommended Structure
+
+
+ - my-node-pack/
+ - `__init__.py` Required: Imports all node classes
+ - requirements.txt Python dependencies (user-installed)
+ - README.md Description, usage & examples
+ - node_one.py Node implementation
+ - node_two.py Node implementation
+ - utils.py Shared utilities
+ - workflows/ Optional: Included workflow files
+ - example_workflow.json
+ - advanced_workflow.json
+
+
+## The `__init__.py` File
+
+This file must import all invocation classes you want to register. Only classes imported here will be available in InvokeAI.
+
+```python title="__init__.py"
+from .node_one import MyFirstInvocation
+from .node_two import MySecondInvocation
+```
+
+If you have nodes in subdirectories:
+
+```python
+from .nodes.image_tools import CropInvocation, ResizeInvocation
+from .nodes.text_tools import ConcatInvocation
+```
+
+## Dependencies (`requirements.txt` or `pyproject.toml`)
+
+If your nodes require additional Python packages, list them in a `requirements.txt` (or `pyproject.toml`) at the repository root:
+
+```txt title="requirements.txt"
+numpy>=1.24
+opencv-python>=4.8
+```
+
+The Custom Node Manager **does not** install these dependencies automatically — auto-installing into the running InvokeAI environment risks pulling in incompatible versions and breaking the application. After install, the UI shows the user a toast telling them that manual installation is required, and your README should document the exact install command (e.g. `pip install -r requirements.txt` from inside an activated InvokeAI environment).
+
+**Important:** Avoid pinning versions too tightly. InvokeAI has its own dependencies, and version conflicts can cause issues. Use minimum version constraints (`>=`) where possible.
+
+## Including Workflows
+
+If your repository contains workflow `.json` files, they will be **automatically imported** into the user's workflow library during installation.
+
+### Workflow Detection
+
+The installer recursively scans your repository for `.json` files. A file is recognized as a workflow if it contains both `nodes` and `edges` keys at the top level.
+
+### Tagging
+
+Imported workflows are automatically tagged with `node-pack:` so users can filter for them in the workflow library. When the node pack is uninstalled, these workflows are also removed.
+
+### Workflow Format
+
+Workflows should follow the standard InvokeAI workflow format:
+
+```json title="example_workflow.json"
+{
+ "name": "My Example Workflow",
+ "author": "Your Name",
+ "description": "Demonstrates how to use MyFirstInvocation",
+ "version": "1.0.0",
+ "contact": "",
+ "tags": "example, my-node-pack",
+ "notes": "",
+ "meta": {
+ "version": "3.0.0",
+ "category": "user"
+ },
+ "exposedFields": [],
+ "nodes": [...],
+ "edges": [...]
+}
+```
+
+**Tip:** The easiest way to create a workflow file is to build the workflow in InvokeAI's workflow editor, then export it via **Save As** and copy the `.json` file into your repository.
+
+## Node Implementation
+
+Each node is a Python class decorated with `@invocation()`. Here's a minimal example:
+
+```python title="example_node.py"
+from invokeai.app.invocations.baseinvocation import BaseInvocation, invocation
+from invokeai.app.invocations.fields import InputField, OutputField
+from invokeai.invocation_api import BaseInvocationOutput, invocation_output
+
+@invocation_output("my_output")
+class MyOutput(BaseInvocationOutput):
+ result: str = OutputField(description="The result")
+
+@invocation(
+ "my_node",
+ title="My Node",
+ tags=["example", "custom"],
+ category="custom",
+ version="1.0.0",
+)
+class MyInvocation(BaseInvocation):
+ """Does something useful."""
+
+ input_text: str = InputField(default="", description="Input text")
+
+ def invoke(self, context) -> MyOutput:
+ return MyOutput(result=f"Processed: {self.input_text}")
+```
+
+For full details on the invocation API, see the [Invocation API documentation](invocation-api.md).
+
+## Best Practices
+
+- **Use a descriptive repository name** — it becomes the pack name shown in the UI
+- **Include a README.md** with description, screenshots, and usage instructions
+- **Version your nodes** using semver in the `@invocation()` decorator
+- **Don't include large binary files** in your repository (models, weights, etc.)
+- **Test your nodes** by placing the repo in the `nodes` directory before publishing
+- **Include example workflows** so users can get started quickly
+- **Tag your GitHub repository** with `invokeai-node` for discoverability
+- **Avoid name collisions** — choose unique invocation type strings (e.g. `my_pack_resize` instead of just `resize`)
+
+## Testing Your Pack
+
+Before publishing, verify your pack works with the Custom Node Manager:
+
+1. Create a Git repository with your node pack
+2. Push it to GitHub (or any Git host)
+3. In InvokeAI, go to the Nodes tab and install it via the Git URL
+4. Verify your nodes appear in the workflow editor
+5. Verify any included workflows are imported
+6. Test uninstalling — nodes and workflows should be removed
diff --git a/docs/src/content/docs/development/Guides/creating-nodes.mdx b/docs/src/content/docs/development/Guides/creating-nodes.mdx
new file mode 100644
index 00000000000..abc905f6e6a
--- /dev/null
+++ b/docs/src/content/docs/development/Guides/creating-nodes.mdx
@@ -0,0 +1,75 @@
+---
+title: Creating Nodes
+---
+
+import { Steps, LinkCard } from '@astrojs/starlight/components';
+
+
+ 1. Learn about the specifics of creating a new node in our Node Creation Documentation.
+
+
+
+ 2. Make sure the node is contained in a new Python (.py) file. Preferably, the node is in a repo with a README detailing the nodes usage & examples to help others more easily use your node. Including the tag "invokeai-node" in your repository's README can also help other users find it more easily.
+
+ 3. Submit a pull request with a link to your node(s) repo in GitHub against the `main` branch to add the node to the [Community Nodes](../../../workflows/community-nodes) list
+
+ Make sure you are following the template below and have provided all relevant details about the node and what it does. Example output images and workflows are very helpful for other users looking to use your node.
+
+ 4. A maintainer will review the pull request and node. If the node is aligned with the direction of the project, you may be asked for permission to include it in the core project.
+
+
+### Supporting multi-GPU text-encoder offload
+
+On a machine with more than one GPU, InvokeAI can run several generation sessions at once — one per GPU. When fewer sessions are running than there are GPUs, the spare GPUs sit idle. To put that capacity to use, InvokeAI can run a session's **prompt/text encoder** on a currently-idle GPU instead of on the GPU running the denoise pipeline. This avoids evicting the denoise model from VRAM just to make room for the encoder, and lets the cached encoder be reused across generations.
+
+This is controlled globally by the `offload_text_encoders_to_idle_gpus` config setting (enabled by default) and opted into **per node** via the `@invocation` decorator:
+
+```python
+from invokeai.app.invocations.baseinvocation import BaseInvocation, invocation
+
+
+@invocation(
+ "my_text_encoder",
+ title="Prompt - My Model",
+ category="conditioning",
+ version="1.0.0",
+ idle_gpu_offloadable=True, # opt in to idle-GPU offload
+)
+class MyTextEncoderInvocation(BaseInvocation):
+ ...
+```
+
+When the feature is enabled and an idle GPU is available, the **entire node** is temporarily re-pinned to a borrowed idle GPU: any model it loads goes onto that GPU and runs there. If no idle GPU is free (e.g. every GPU is busy with its own session), the node simply runs on its own GPU, unchanged. The borrow holds the idle GPU exclusively for the duration of the node, so it can never run concurrently against a native session on that same GPU.
+
+Because the whole node is moved to another device, only mark a node `idle_gpu_offloadable=True` if **all** of the following hold:
+
+- **It is encoder-only.** Its sole GPU work is loading one or more encoder models and running their forward pass. It must not load or run the denoise/transformer or VAE, or do any other work tied to the session's own GPU.
+- **It stores its result on the CPU before returning.** Move output tensors to the CPU (`tensor.detach().to("cpu")`) and save them as conditioning/tensors. The denoiser picks them up and moves them onto its own GPU later — this is what makes the cross-GPU handoff safe and device-agnostic.
+- **It places inputs on the loaded model's device, not a fixed device.** Resolve the device from the model you just loaded (e.g. `get_effective_device(model)` from `invokeai.backend.model_manager.load.model_cache.utils`, or `TorchDevice.choose_torch_device()`), rather than hard-coding `cuda:0`. The built-in `flux_text_encoder` and `compel` nodes are good references.
+
+:::caution[Only mark encoder-only nodes]
+If a node that also runs the denoiser, VAE, or other session-GPU work is marked `idle_gpu_offloadable=True`, that work will be re-pinned to the wrong GPU and can misplace tensors or raise device-mismatch errors. When in doubt, leave it unset (the default is `False`) — the node will still work correctly, just without the offload optimization.
+:::
+
+### Community Node Template
+
+Append the following template to your pull request and the [Community Nodes](../../../workflows/community-nodes) page when submitting a node to be added to the community nodes list:
+
+```md
+---
+
+### Super Cool Node Template
+
+**Description:** This node allows you to do super cool things with InvokeAI.
+
+**Node Link:** https://github.com/invoke-ai/InvokeAI/fake_node.py
+
+**Example Node Graph:** https://github.com/invoke-ai/InvokeAI/fake_node_graph.json
+
+**Output Examples**
+
+
+```
diff --git a/docs/src/content/docs/development/Guides/models.mdx b/docs/src/content/docs/development/Guides/models.mdx
new file mode 100644
index 00000000000..8657cc97818
--- /dev/null
+++ b/docs/src/content/docs/development/Guides/models.mdx
@@ -0,0 +1,556 @@
+---
+title: Integrating a New Model Architecture
+description: A comprehensive guide to integrating new foundational model architectures into InvokeAI.
+lastUpdated: 2026-02-19
+---
+
+import { Steps, FileTree } from '@astrojs/starlight/components';
+
+This guide walks you through the end-to-end process of integrating a **new foundational model architecture** into InvokeAI. This is required when adding a completely new family of models (e.g., Stable Diffusion 3, FLUX, Hunyuan, etc.), rather than just adding a new checkpoint for an existing architecture.
+
+:::note
+The code examples in this guide use a hypothetical `NewModel` architecture. The implementations of `FLUX`, `SD3`, and `SDXL` in the InvokeAI codebase serve as excellent real-world references.
+:::
+
+## Architectural Overview
+
+Integrating a new model touches several parts of the InvokeAI stack, from the lowest-level PyTorch inference code up to the React frontend:
+
+1. **Taxonomy & Configuration (Backend)**: Declaring the model's existence and defining how to detect it from its weights on disk.
+2. **Model Loading (Backend)**: Defining how to load the detected files into PyTorch models in memory.
+3. **Sampling & Denoising (Backend)**: Implementing the core math for noise generation, scheduling, and the denoising loop.
+4. **Invocations (Backend)**: Wrapping the PyTorch logic into isolated "nodes" that can be executed by InvokeAI's graph engine.
+5. **Graph Building (Frontend)**: Instructing the UI on how to wire these nodes together based on user settings.
+6. **State & UI (Frontend)**: Adding the necessary UI controls and state management for the new model's unique parameters.
+
+---
+
+## 1. Taxonomy & Defaults
+
+The first step is to declare your model in the system's taxonomy and provide reasonable default settings.
+
+
+1. **Add `BaseModelType`**
+
+ Update the base model taxonomy to include your new model.
+
+ ```python title="invokeai/backend/model_manager/taxonomy.py" ins={7}
+ class BaseModelType(str, Enum):
+ # Existing types
+ StableDiffusion1 = "sd-1"
+ StableDiffusion2 = "sd-2"
+ StableDiffusionXL = "sdxl"
+ Flux = "flux"
+ NewModel = "newmodel"
+ ```
+
+2. **Add Variant Type (if needed)**
+
+ If your model comes in different structural variants (e.g., different parameter counts or distilled versions like `schnell` vs `dev`), define a variant enum.
+
+ ```python title="invokeai/backend/model_manager/taxonomy.py"
+ class NewModelVariantType(str, Enum):
+ VariantA = "variant_a"
+ VariantB = "variant_b"
+ ```
+
+3. **Define Default Settings**
+
+ Provide default generation parameters (steps, CFG scale, etc.) for the UI to use when this model is selected.
+
+ ```python title="invokeai/backend/model_manager/configs/main.py" ins={5-6}
+ class MainModelDefaultSettings:
+ @staticmethod
+ def from_base(base: BaseModelType, variant: AnyVariant | None = None):
+ match base:
+ case BaseModelType.NewModel:
+ return MainModelDefaultSettings(steps=20, cfg_scale=7.0)
+ ```
+
+
+:::tip[Checklist: Taxonomy]{icon="approve-check"}
+ - [ ] Extend `BaseModelType` enum in `taxonomy.py`
+ - [ ] Create variant enum if needed in `taxonomy.py`
+ - [ ] Update `AnyVariant` union in `taxonomy.py`
+ - [ ] Add default settings in `from_base()` in `configs/main.py`
+:::
+
+---
+
+## 2. Model Configs & Detection
+
+InvokeAI needs to know how to identify your model from a `.safetensors` file or a diffusers folder.
+
+
+1. **Create Main Model Config**
+
+ Define the configuration schemas for your model format(s).
+
+ ```python title="invokeai/backend/model_manager/configs/main.py"
+ # Checkpoint Format (Single File)
+ @ModelConfigFactory.register
+ class Main_Checkpoint_NewModel_Config(Checkpoint_Config_Base):
+ type: Literal[ModelType.Main] = ModelType.Main
+ base: Literal[BaseModelType.NewModel] = BaseModelType.NewModel
+ format: Literal[ModelFormat.Checkpoint] = ModelFormat.Checkpoint
+ variant: NewModelVariantType = NewModelVariantType.VariantA
+
+ @classmethod
+ def from_model_on_disk(cls, mod: ModelOnDisk, override_fields: dict) -> Self:
+ if not cls._validate_is_newmodel(mod):
+ raise NotAMatchError("Not a NewModel")
+ variant = cls._get_variant_or_raise(mod)
+ return cls(..., variant=variant)
+
+ # Diffusers Format (Folder)
+ @ModelConfigFactory.register
+ class Main_Diffusers_NewModel_Config(Diffusers_Config_Base):
+ type: Literal[ModelType.Main] = ModelType.Main
+ base: Literal[BaseModelType.NewModel] = BaseModelType.NewModel
+ format: Literal[ModelFormat.Diffusers] = ModelFormat.Diffusers
+ ```
+
+2. **Implement Detection Logic**
+
+ Write helper functions to inspect the state dictionary keys and shape to uniquely identify your architecture.
+
+ ```python title="invokeai/backend/model_manager/configs/main.py"
+ def _is_newmodel(state_dict: dict) -> bool:
+ """Detect if state dict belongs to NewModel architecture."""
+ # Example: check for a highly specific layer name or shape
+ required_keys = ["transformer_blocks.0.attn.to_q.weight"]
+ return all(key in state_dict for key in required_keys)
+
+ def _get_newmodel_variant(state_dict: dict) -> NewModelVariantType:
+ """Determine variant from state dict."""
+ # Example: distinguish variants based on hidden dimension size
+ context_dim = state_dict["context_embedder.weight"].shape[1]
+ if context_dim == 7680:
+ return NewModelVariantType.VariantA
+ return NewModelVariantType.VariantB
+ ```
+
+3. **Submodels (VAE & Text Encoder)**
+
+ If your model uses a novel VAE or Text Encoder not already in InvokeAI, you must repeat this process to create configs for them (e.g., in `configs/vae.py` and `configs/[encoder_type].py`).
+
+4. **Update the Configuration Union**
+
+ Register your new configs so the application knows to check them when scanning directories.
+
+ ```python title="invokeai/backend/model_manager/configs/factory.py" ins={4-5}
+ AnyModelConfig = Annotated[
+ # ... existing configs
+ Main_Checkpoint_NewModel_Config |
+ Main_Diffusers_NewModel_Config,
+ Discriminator(...)
+ ]
+ ```
+
+
+:::tip[Checklist: Configs]{icon="approve-check"}
+ - [ ] Create main checkpoint config (`configs/main.py`)
+ - [ ] Create main diffusers config (`configs/main.py`)
+ - [ ] Create detection helper functions (`_is_newmodel()`, `_get_variant()`)
+ - [ ] Create VAE and Text Encoder configs if they use novel architectures
+ - [ ] Update `AnyModelConfig` union (`configs/factory.py`)
+:::
+
+---
+
+## 3. Model Loaders
+
+Loaders are responsible for converting the files on disk (described by the config) into PyTorch models in memory.
+
+
+1. **Create the Model Loader**
+
+ ```python title="invokeai/backend/model_manager/load/model_loaders/[newmodel].py"
+ @ModelLoaderRegistry.register(
+ base=BaseModelType.NewModel,
+ type=ModelType.Main,
+ format=ModelFormat.Checkpoint
+ )
+ class NewModelLoader(ModelLoader):
+ def _load_model(self, config: AnyModelConfig, submodel_type: SubModelType | None) -> AnyModel:
+ # 1. Load the raw weights from disk
+ state_dict = self._load_state_dict(config.path)
+
+ # 2. Convert state dict keys if necessary (e.g. from original repo format to Diffusers)
+ if self._is_original_format(state_dict):
+ state_dict = self._convert_to_diffusers_format(state_dict)
+
+ # 3. Instantiate the empty PyTorch model
+ model = NewModelTransformer(config=model_config)
+
+ # 4. Load weights into the model
+ model.load_state_dict(state_dict)
+ return model
+ ```
+
+2. **Custom VAE/Encoder Loaders (If Applicable)**
+
+ If you created custom configs for the VAE or Text Encoder, you must also create loaders for them, registering them with the appropriate `ModelType`.
+
+
+:::tip[Checklist: Loaders]{icon="approve-check"}
+- [ ] Create and register the main model loader
+- [ ] Create VAE/Encoder loaders if necessary
+- [ ] Implement state dict conversion if supporting non-diffusers formats
+:::
+
+---
+
+## 4. Sampling and Denoising Core
+
+This is where the actual mathematical implementation of the model lives.
+
+
+
+1. **Sampling Utilities**
+
+ Create utility functions specific to how your model handles noise, packing, and scheduling.
+
+ ```python title="invokeai/backend/[newmodel]/sampling_utils.py"
+ def get_noise_newmodel(num_samples: int, height: int, width: int, seed: int, device: torch.device, dtype: torch.dtype) -> torch.Tensor:
+ # Models often have different latent channel counts (e.g., SD1.5 has 4, FLUX has 16)
+ latent_channels = 32
+ latent_h, latent_w = height // 8, width // 8
+ generator = torch.Generator(device=device).manual_seed(seed)
+ return torch.randn((num_samples, latent_channels, latent_h, latent_w), generator=generator, device=device, dtype=dtype)
+
+ def pack_newmodel(x: torch.Tensor) -> torch.Tensor:
+ # Some transformer-based models require packing latents into a sequence
+ return rearrange(x, "b c (h ph) (w pw) -> b (h w) (c ph pw)", ph=2, pw=2)
+ ```
+
+ If the architecture supports external noise, prefer extending the standard
+ `invokeai/app/invocations/noise.py` node's `noise_type` selector instead of
+ adding a brand new noise node. Only add a dedicated noise invocation when the
+ architecture's noise tensor rank or layout cannot be expressed by the
+ standard node.
+
+2. **The Denoising Loop**
+
+ Implement the core sampling loop. This interacts with schedulers and handles classifier-free guidance (CFG).
+
+ ```python title="invokeai/backend/[newmodel]/denoise.py"
+ def denoise(model: nn.Module, img: torch.Tensor, txt: torch.Tensor, timesteps: list[float], cfg_scale: list[float], scheduler: Any = None) -> torch.Tensor:
+ """Main denoising loop."""
+ total_steps = len(timesteps) - 1
+
+ for step_index in range(total_steps):
+ t_curr = timesteps[step_index]
+
+ # Handle CFG (Classifier-Free Guidance)
+ if cfg_scale[step_index] > 1.0:
+ # Batch positive and negative prompts if applicable
+ pred_pos = model(img, t_curr, txt)
+ # ...
+ else:
+ pred = model(img, t_curr, txt)
+
+ # Step the scheduler
+ img = scheduler.step(pred, t_curr, img).prev_sample
+
+ return img
+ ```
+
+3. **Schedulers**
+
+ If your model requires a novel scheduler, add it to the scheduler mapping (e.g., `invokeai/backend/[newmodel]/schedulers.py`).
+
+
+:::tip[Checklist: Core Inference]{icon="approve-check"}
+ - [ ] Noise generation (`get_noise_newmodel()`)
+ - [ ] Pack/unpack functions (if transformer-based)
+ - [ ] Timestep schedule generation
+ - [ ] Denoise loop implementation
+ - [ ] Map supported schedulers
+:::
+
+---
+
+## 5. Invocations
+
+Invocations expose your PyTorch functions as isolated execution nodes in InvokeAI's graph.
+
+
+1. **Model Loader Invocation**
+
+ Loads the components (Transformer, VAE, etc.) and provides them to downstream nodes.
+
+ ```python title="invokeai/app/invocations/[newmodel]_model_loader.py"
+ @invocation("newmodel_model_loader", title="NewModel Loader", category="model_loader")
+ class NewModelModelLoaderInvocation(BaseInvocation):
+ model: ModelIdentifierField = InputField(description="Main model")
+
+ def invoke(self, context: InvocationContext) -> NewModelLoaderOutput:
+ transformer = self.model.model_copy(update={"submodel_type": SubModelType.Transformer})
+ vae = self.model.model_copy(update={"submodel_type": SubModelType.VAE})
+ return NewModelLoaderOutput(transformer=transformer, vae=vae)
+ ```
+
+2. **Text Encoder Invocation**
+
+ Tokenizes the prompt and runs the text encoder(s).
+
+ ```python title="invokeai/app/invocations/[newmodel]_text_encoder.py"
+ @invocation("newmodel_text_encode", title="NewModel Text Encoder", category="conditioning")
+ class NewModelTextEncoderInvocation(BaseInvocation):
+ prompt: str = InputField()
+ encoder: EncoderField = InputField()
+
+ def invoke(self, context: InvocationContext) -> ConditioningOutput:
+ # 1. Tokenize prompt
+ # 2. Run encoder to get embeddings
+ # 3. Save to context and return
+ conditioning_name = context.conditioning.save(ConditioningFieldData(...))
+ return ConditioningOutput(conditioning=ConditioningField(conditioning_name=conditioning_name))
+ ```
+
+3. **Denoise Invocation**
+
+ Wraps the `denoise` loop you wrote in the previous section.
+
+ ```python title="invokeai/app/invocations/[newmodel]_denoise.py"
+ @invocation("newmodel_denoise", title="NewModel Denoise", category="latents")
+ class NewModelDenoiseInvocation(BaseInvocation):
+ latents: LatentsField | None = InputField(default=None)
+ noise: LatentsField | None = InputField(default=None)
+ positive_conditioning: ConditioningField = InputField()
+ transformer: TransformerField = InputField()
+ steps: int = InputField(default=20)
+ cfg_scale: float = InputField(default=7.0)
+
+ def invoke(self, context: InvocationContext) -> LatentsOutput:
+ # Generate noise, get schedule, and call your denoise() function
+ pass
+ ```
+
+ If you add external noise support, keep it optional so seed-driven workflows
+ continue to work. Validate connected noise against the architecture's
+ expected shape before using it.
+
+4. **VAE Encode / Decode Invocations**
+
+ Create nodes to transition between pixel space (images) and latent space.
+
+
+:::tip[Checklist: Invocations]{icon="approve-check"}
+ - [ ] Define output classes (e.g., `NewModelLoaderOutput`)
+ - [ ] Model loader invocation (`[newmodel]_model_loader.py`)
+ - [ ] Text encoder invocation (`[newmodel]_text_encoder.py`)
+ - [ ] Denoise invocation (`[newmodel]_denoise.py`)
+ - [ ] Extend the standard `noise` invocation if the architecture supports external noise
+ - [ ] VAE encode/decode invocations (`[newmodel]_vae_encode.py`, `[newmodel]_vae_decode.py`)
+:::
+
+---
+
+## 6. Frontend: Graph Building
+
+The UI doesn't know about Python functions; it only knows how to build graphs of Invocations.
+
+
+1. **Create the Graph Builder**
+
+ Write a TypeScript function that constructs the node graph for your model.
+
+ ```typescript title="invokeai/frontend/web/src/features/nodes/util/graph/generation/buildNewModelGraph.ts"
+ export const buildNewModelGraph = async (arg: GraphBuilderArg): Promise => {
+ const { state, manager } = arg;
+ const { model } = state.params;
+ const g = new Graph();
+
+ // 1. Add Loader
+ const modelLoader = g.addNode({
+ id: NEWMODEL_MODEL_LOADER,
+ type: 'newmodel_model_loader',
+ model: Graph.getModelMetadataField(model),
+ });
+
+ // 2. Add Text Encoders
+ const positivePrompt = g.addNode({
+ id: POSITIVE_CONDITIONING,
+ type: 'newmodel_text_encode',
+ prompt: state.params.positivePrompt,
+ });
+ g.addEdge(modelLoader, 'encoder', positivePrompt, 'encoder');
+
+ // 3. Add Denoise
+ const denoise = g.addNode({
+ id: NEWMODEL_DENOISE,
+ type: 'newmodel_denoise',
+ steps: state.params.steps,
+ cfg_scale: state.params.cfg,
+ });
+ g.addEdge(modelLoader, 'transformer', denoise, 'transformer');
+ g.addEdge(positivePrompt, 'conditioning', denoise, 'positive_conditioning');
+
+ // 4. Add VAE Decode
+ const l2i = g.addNode({
+ id: NEWMODEL_VAE_DECODE,
+ type: 'newmodel_vae_decode',
+ });
+ g.addEdge(modelLoader, 'vae', l2i, 'vae');
+ g.addEdge(denoise, 'latents', l2i, 'latents');
+
+ return { g, denoise, posCond: positivePrompt };
+ };
+ ```
+
+2. **Register the Graph Builder**
+
+ Hook your graph builder into the main routing logic.
+
+ ```typescript title="invokeai/frontend/web/src/features/queue/hooks/useEnqueueCanvas.ts" ins={5-6}
+ switch (base) {
+ case 'sdxl':
+ return buildSDXLGraph(arg);
+ case 'flux':
+ return buildFLUXGraph(arg);
+ case 'newmodel':
+ return buildNewModelGraph(arg);
+ }
+ ```
+
+3. **Update Type Definitions**
+
+ Add your new nodes to the strict frontend type unions.
+
+ ```typescript title="invokeai/frontend/web/src/features/nodes/util/graph/types.ts" ins="| 'newmodel_vae_decode'"
+ export type ImageOutputNodes =
+ | 'l2i' | 'flux_vae_decode' | 'sd3_l2i' | 'newmodel_vae_decode';
+ ```
+
+4. **Generation Modes**
+
+ Update `invokeai/app/invocations/metadata.py` to include your new modes in `GENERATION_MODES` (e.g., `"newmodel_txt2img"`, `"newmodel_img2img"`).
+
+
+:::tip[Checklist: Graph Building]{icon="approve-check"}
+ - [ ] Create graph builder (`buildNewModelGraph.ts`)
+ - [ ] Register graph builder in `useEnqueueCanvas.ts`
+ - [ ] Update node unions in `types.ts`
+ - [ ] Add generation modes to python `metadata.py`
+:::
+
+---
+
+## 7. Frontend: State & UI
+
+Finally, add any custom UI controls (like a specific scheduler dropdown) and manage their state.
+
+
+1. **Add to Redux State**
+
+ Update the parameters slice for your model-specific settings.
+
+ ```typescript title="invokeai/frontend/web/src/features/controlLayers/store/paramsSlice.ts"
+ interface ParamsState {
+ // ...
+ newmodelScheduler: 'euler' | 'heun';
+ }
+
+ const initialState: ParamsState = {
+ // ...
+ newmodelScheduler: 'euler',
+ };
+
+ // Add reducers and export selectors...
+ ```
+
+2. **Parameter Recall**
+
+ Ensure users can extract parameters from previously generated images by updating `invokeai/frontend/web/src/features/metadata/parsing.tsx`.
+
+ ```typescript title="invokeai/frontend/web/src/features/metadata/parsing.tsx"
+ const recallNewmodelScheduler = (metadata: CoreMetadata) => {
+ if (metadata.scheduler) {
+ dispatch(setNewmodelScheduler(metadata.scheduler));
+ }
+ };
+ ```
+
+
+:::tip[Checklist: State & UI]{icon="approve-check"}
+ - [ ] Extend state interface for model-specific parameters
+ - [ ] Create reducers and selectors
+ - [ ] Add parameter recall handlers in `parsing.tsx`
+:::
+
+---
+
+## 8. Optional Features
+
+Depending on the model, you may want to support additional features.
+
+### ControlNet Support
+Requires backend configuration (`configs/controlnet.py`), a custom invocation (`[newmodel]_controlnet.py`), and frontend graph integration (`addControlNets`).
+
+### LoRA Support
+Requires defining a LoRA config (`configs/lora.py`), updating the model loader to pass LoRA fields, and wiring `addLoRAs` in the frontend graph builder.
+
+### IP-Adapter
+Requires a custom invocation for image prompting (`[newmodel]_ip_adapter.py`) and frontend integration via `addIPAdapters`.
+
+---
+
+## 9. Starter Models
+
+To allow users to easily download your model from the Model Manager UI, add it to the starter models list.
+
+```python title="invokeai/backend/model_manager/starter_models.py"
+newmodel_main = StarterModel(
+ name="NewModel Main",
+ base=BaseModelType.NewModel,
+ source="organization/newmodel-main", # HuggingFace repo
+ description="NewModel main transformer.",
+ type=ModelType.Main,
+)
+
+STARTER_MODELS.append(newmodel_main)
+```
+
+:::tip[Checklist: Starter Models]{icon="approve-check"}
+- [ ] Define main model StarterModel
+- [ ] Define VAE/Encoder StarterModels if separate
+- [ ] Set dependencies correctly if required
+- [ ] Add to `STARTER_MODELS` list
+:::
+
+---
+
+## Summary of Integration Files
+
+A complete minimal `txt2img` integration touches the following areas:
+
+
+- invokeai
+ - app/invocations
+ - metadata.py
+ - `[newmodel]_model_loader.py`
+ - `[newmodel]_text_encoder.py`
+ - `[newmodel]_denoise.py`
+ - `[newmodel]_vae_decode.py`
+ - backend
+ - model_manager
+ - taxonomy.py
+ - configs
+ - main.py
+ - factory.py
+ - load/model_loaders
+ - `[newmodel].py`
+ - starter_models.py
+ - `[newmodel]`
+ - sampling_utils.py
+ - denoise.py
+ - frontend/web/src/features
+ - nodes/util/graph
+ - generation/buildNewModelGraph.ts
+ - types.ts
+ - queue/hooks/useEnqueueCanvas.ts
+ - controlLayers/store/paramsSlice.ts
+ - metadata/parsing.tsx
+
diff --git a/docs/src/content/docs/development/Guides/recall-api.mdx b/docs/src/content/docs/development/Guides/recall-api.mdx
new file mode 100644
index 00000000000..f376e2af4bd
--- /dev/null
+++ b/docs/src/content/docs/development/Guides/recall-api.mdx
@@ -0,0 +1,572 @@
+---
+title: Recall Parameters API
+---
+
+## Overview
+
+The Recall Parameters API is a REST endpoint on the InvokeAI backend that
+lets external processes set recallable generation parameters on the
+frontend. Supported parameters include:
+
+- Core text and numeric parameters (prompts, model, steps, CFG, dimensions, seed, ...)
+- LoRAs
+- Control Layers (ControlNet, T2I Adapter, Control LoRA) with optional control images
+- IP Adapters and FLUX Redux reference images with optional images
+- Model-free reference images (FLUX.2 Klein, FLUX Kontext, Qwen Image Edit)
+
+When parameters are updated via the API, the backend stores them in client
+state persistence for the target queue and broadcasts a `recall_parameters_updated`
+WebSocket event. Any frontend client subscribed to that queue applies the
+new values immediately — no manual reload required.
+
+Typical use cases:
+
+- An external image browser that wants to "recall" or "remix" the
+ generation parameters saved into a PNG's metadata.
+- A script that pre-populates parameters before the user runs generation.
+- Automated testing or batch workflows that want to reuse existing model
+ and adapter configurations.
+
+## How It Works
+
+1. **API request** — your client POSTs a JSON body of parameters to
+ `/api/v1/recall/{queue_id}`.
+2. **Storage** — non-null parameters are stored under
+ `recall_*` keys in the client state persistence service, scoped to the
+ given `queue_id`.
+3. **Resolution** — models are resolved from human-readable names to the
+ internal model keys used by the frontend, and image filenames are
+ validated against `{INVOKEAI_ROOT}/outputs/images`.
+4. **Broadcast** — a `recall_parameters_updated` event is emitted on the
+ websocket room for `queue_id`.
+5. **Frontend update** — any connected client subscribed to that queue
+ applies the update to its Redux store, so UI fields, LoRAs, control
+ layers, IP adapters, and reference images all populate immediately.
+
+## Endpoint
+
+**Base URL:** `http://localhost:9090/api/v1/recall/{queue_id}`
+
+The queue id is usually `default`.
+
+### POST — Update Recall Parameters
+
+Updates recallable parameters for the given `queue_id`.
+
+```http
+POST /api/v1/recall/{queue_id}
+Content-Type: application/json
+
+{
+ "positive_prompt": "a beautiful landscape",
+ "negative_prompt": "blurry, low quality",
+ "model": "sd-1.5",
+ "steps": 20,
+ "cfg_scale": 7.5,
+ "width": 512,
+ "height": 512,
+ "seed": 12345
+}
+```
+
+All parameters are optional — only send the fields you want to update.
+
+#### Query parameters
+
+The POST endpoint accepts two optional boolean query parameters that control
+how reference images are merged into the frontend state:
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `strict` | `false` | When `true`, parameters **not** included in the request body are reset to their defaults (cleared on the frontend). When `false`, only the parameters you send are updated and everything else is left as-is. |
+| `append` | `false` | When `true`, recalled reference images (`ip_adapters` and `reference_images`) are **appended** to the frontend's existing reference-image list instead of replacing it. When `false` (or omitted), the recalled reference images **replace** the existing list. |
+
+`strict` and `append` are mutually exclusive — `strict` clears omitted
+parameters while `append` preserves and extends the existing list, so the two
+cannot be combined. Sending `?strict=true&append=true` returns
+**400 Bad Request**:
+
+```json
+{
+ "detail": "The 'strict' and 'append' query parameters are mutually exclusive"
+}
+```
+
+`append` only affects the reference-image collections (`ip_adapters` and
+`reference_images`). All other parameters (prompts, model, LoRAs, control
+layers, etc.) are updated the same way regardless of the flag.
+
+### GET — Retrieve Recall Parameters
+
+```http
+GET /api/v1/recall/{queue_id}
+```
+
+```json
+{
+ "status": "success",
+ "queue_id": "queue_123",
+ "note": "Use the frontend to access stored recall parameters, or set specific parameters using POST"
+}
+```
+
+## Request Schema
+
+### Core parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `positive_prompt` | string | Positive prompt text |
+| `negative_prompt` | string | Negative prompt text |
+| `model` | string | Main model name/identifier |
+| `refiner_model` | string | Refiner model name/identifier |
+| `vae_model` | string | VAE model name/identifier |
+| `scheduler` | string | Scheduler name |
+| `steps` | integer | Number of generation steps (≥1) |
+| `refiner_steps` | integer | Number of refiner steps (≥0) |
+| `cfg_scale` | number | CFG scale for guidance |
+| `cfg_rescale_multiplier` | number | CFG rescale multiplier |
+| `refiner_cfg_scale` | number | Refiner CFG scale |
+| `guidance` | number | Guidance scale |
+| `width` | integer | Image width in pixels (≥64) |
+| `height` | integer | Image height in pixels (≥64) |
+| `seed` | integer | Random seed (≥0) |
+| `denoise_strength` | number | Denoising strength (0–1) |
+| `refiner_denoise_start` | number | Refiner denoising start (0–1) |
+| `clip_skip` | integer | CLIP skip layers (≥0) |
+| `seamless_x` | boolean | Enable seamless X tiling |
+| `seamless_y` | boolean | Enable seamless Y tiling |
+| `refiner_positive_aesthetic_score` | number | Refiner positive aesthetic score |
+| `refiner_negative_aesthetic_score` | number | Refiner negative aesthetic score |
+
+### Collection parameters
+
+```typescript
+{
+ // LoRAs
+ loras?: Array<{
+ model_name: string; // LoRA model name
+ weight?: number; // Default: 0.75, Range: -10 to 10
+ is_enabled?: boolean; // Default: true
+ }>;
+
+ // Control Layers (ControlNet, T2I Adapter, Control LoRA)
+ control_layers?: Array<{
+ model_name: string; // Control adapter model name
+ image_name?: string; // Optional image filename from outputs/images
+ weight?: number; // Default: 1.0, Range: -1 to 2
+ begin_step_percent?: number; // Default: 0.0, Range: 0 to 1
+ end_step_percent?: number; // Default: 1.0, Range: 0 to 1
+ control_mode?: "balanced" | "more_prompt" | "more_control"; // ControlNet only
+ }>;
+
+ // IP Adapters (includes FLUX Redux)
+ ip_adapters?: Array<{
+ model_name: string; // IP Adapter / FLUX Redux model name
+ image_name?: string; // Optional reference image filename from outputs/images
+ weight?: number; // Default: 1.0, Range: -1 to 2
+ begin_step_percent?: number; // Default: 0.0, Range: 0 to 1
+ end_step_percent?: number; // Default: 1.0, Range: 0 to 1
+ method?: "full" | "style" | "composition"; // Default: "full"
+ image_influence?: "lowest" | "low" | "medium" | "high" | "highest"; // FLUX Redux only
+ }>;
+
+ // Model-free reference images (FLUX.2 Klein, FLUX Kontext, Qwen Image Edit)
+ reference_images?: Array<{
+ image_name: string; // Reference image filename from outputs/images
+ }>;
+}
+```
+
+## Model Name Resolution
+
+The backend resolves model names to their internal keys:
+
+1. **Main models** — resolved from the name to the model key.
+2. **LoRAs** — searched in the LoRA model database.
+3. **Control adapters** — tried in order: ControlNet → T2I Adapter → Control LoRA.
+4. **IP Adapters** — searched in the IP Adapter database; falls back to FLUX Redux.
+
+Models that cannot be resolved are skipped with a warning in the logs —
+the rest of the parameters are still applied.
+
+## Image File Handling
+
+When an `image_name` is supplied, the backend:
+
+1. Resolves `{INVOKEAI_ROOT}/outputs/images/{image_name}` via the image
+ files service (which also validates the path).
+2. Opens the image to extract width/height.
+3. Includes the image metadata in the event sent to the frontend.
+4. Logs whether the image was found.
+
+Images must be referenced by their filename as it appears in the
+outputs/images directory:
+
+- ✅ `"image_name": "example.png"`
+- ✅ `"image_name": "my_control_image_20240110.jpg"`
+- ❌ `"image_name": "outputs/images/example.png"` (no prefix)
+- ❌ `"image_name": "/full/path/to/example.png"` (no absolute paths)
+
+Missing images are logged as warnings but **do not** fail the request —
+remaining parameters are still applied.
+
+## Feature Details
+
+### LoRAs
+
+- Existing LoRAs are cleared before new ones are added.
+- Each LoRA's model config is fetched and applied with the specified weight.
+- LoRAs appear in the LoRA selector panel.
+
+### Control Layers
+
+- Fully supported with optional images from `outputs/images`.
+- Configuration includes model, weights, step percentages, control mode,
+ and an image reference.
+- Image availability is logged in the frontend console.
+
+### IP Adapters / FLUX Redux
+
+- Reference images loaded from `outputs/images` are validated and passed
+ through.
+- Configuration includes model, weights, step percentages, method, and an
+ image reference.
+- FLUX Redux uses `image_influence` instead of a numeric weight.
+
+### Model-free reference images
+
+Used by architectures that consume a reference image directly, with no
+separate adapter model:
+
+- **FLUX.2 Klein** — built-in reference image support.
+- **FLUX Kontext** — reference image associated with the main model.
+- **Qwen Image Edit** — reference image associated with the main model.
+
+Because there is no adapter model to resolve, these entries carry only
+`image_name`. When the frontend receives them, it picks the appropriate
+config flavor (`flux2_reference_image`, `flux_kontext_reference_image`,
+or `qwen_image_reference_image`) based on the currently-selected main
+model, matching the behavior of a manual drag-and-drop.
+
+## Usage Examples
+
+### cURL
+
+```bash
+# Core parameters
+curl -X POST http://localhost:9090/api/v1/recall/default \
+ -H "Content-Type: application/json" \
+ -d '{
+ "positive_prompt": "a cyberpunk city at night",
+ "negative_prompt": "dark, unclear",
+ "model": "sd-1.5",
+ "steps": 30
+ }'
+
+# Just the seed
+curl -X POST http://localhost:9090/api/v1/recall/default \
+ -H "Content-Type: application/json" \
+ -d '{"seed": 99999}'
+```
+
+### LoRAs only
+
+```bash
+curl -X POST http://localhost:9090/api/v1/recall/default \
+ -H "Content-Type: application/json" \
+ -d '{
+ "loras": [
+ {"model_name": "add-detail-xl", "weight": 0.8, "is_enabled": true},
+ {"model_name": "sd_xl_offset_example-lora_1.0", "weight": 0.5}
+ ]
+ }'
+```
+
+### Control layers with an image
+
+```bash
+curl -X POST http://localhost:9090/api/v1/recall/default \
+ -H "Content-Type: application/json" \
+ -d '{
+ "control_layers": [
+ {
+ "model_name": "controlnet-canny-sdxl-1.0",
+ "image_name": "my_control_image.png",
+ "weight": 0.75,
+ "begin_step_percent": 0.0,
+ "end_step_percent": 0.8,
+ "control_mode": "balanced"
+ }
+ ]
+ }'
+```
+
+### IP adapters with a reference image
+
+```bash
+curl -X POST http://localhost:9090/api/v1/recall/default \
+ -H "Content-Type: application/json" \
+ -d '{
+ "ip_adapters": [
+ {
+ "model_name": "ip-adapter-plus-face_sd15",
+ "image_name": "reference_face.png",
+ "weight": 0.7,
+ "method": "composition"
+ }
+ ]
+ }'
+```
+
+### Appending reference images (append mode)
+
+By default, recalled reference images **replace** whatever the frontend
+already has. Pass `?append=true` to **add** the recalled `ip_adapters` and
+`reference_images` to the existing list instead:
+
+```bash
+# Add a reference image without clearing the ones already on the frontend
+curl -X POST 'http://localhost:9090/api/v1/recall/default?append=true' \
+ -H "Content-Type: application/json" \
+ -d '{
+ "reference_images": [
+ {"image_name": "extra_reference.png"}
+ ]
+ }'
+```
+
+Combining `append=true` with `strict=true` is invalid and returns
+**400 Bad Request** (see [Query parameters](#query-parameters)).
+
+### Model-free reference images (FLUX.2 Klein / FLUX Kontext / Qwen Image Edit)
+
+```bash
+curl -X POST http://localhost:9090/api/v1/recall/default \
+ -H "Content-Type: application/json" \
+ -d '{
+ "model": "FLUX.2 Klein",
+ "reference_images": [
+ {"image_name": "style_reference.png"}
+ ]
+ }'
+```
+
+### Complete configuration
+
+```bash
+curl -X POST http://localhost:9090/api/v1/recall/default \
+ -H "Content-Type: application/json" \
+ -d '{
+ "positive_prompt": "masterpiece, detailed photo with specific style",
+ "negative_prompt": "blurry, low quality",
+ "model": "FLUX Schnell",
+ "steps": 25,
+ "cfg_scale": 8.0,
+ "width": 1024,
+ "height": 768,
+ "seed": 42,
+ "loras": [
+ {"model_name": "add-detail-xl", "weight": 0.6}
+ ],
+ "control_layers": [
+ {
+ "model_name": "controlnet-depth-sdxl-1.0",
+ "image_name": "depth_map.png",
+ "weight": 1.0,
+ "end_step_percent": 0.7
+ }
+ ],
+ "ip_adapters": [
+ {
+ "model_name": "ip-adapter-plus-face_sd15",
+ "image_name": "style_reference.png",
+ "weight": 0.5,
+ "method": "style"
+ }
+ ]
+ }'
+```
+
+### Python
+
+```python
+import requests
+
+API_URL = "http://localhost:9090/api/v1/recall/default"
+
+params = {
+ "positive_prompt": "a serene forest",
+ "negative_prompt": "people, buildings",
+ "steps": 25,
+ "cfg_scale": 7.0,
+ "seed": 42,
+}
+
+response = requests.post(API_URL, json=params)
+result = response.json()
+print(f"Status: {result['status']}")
+print(f"Updated {result['updated_count']} parameters")
+```
+
+### JavaScript
+
+```javascript
+const API_URL = 'http://localhost:9090/api/v1/recall/default';
+
+fetch(API_URL, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ positive_prompt: 'a beautiful sunset',
+ steps: 20,
+ width: 768,
+ height: 768,
+ seed: 12345,
+ }),
+})
+ .then((res) => res.json())
+ .then((data) => console.log(data));
+```
+
+## Response Format
+
+```json
+{
+ "status": "success",
+ "queue_id": "default",
+ "updated_count": 15,
+ "parameters": {
+ "positive_prompt": "...",
+ "steps": 25,
+ "loras": [
+ {"model_key": "abc123...", "weight": 0.6, "is_enabled": true}
+ ],
+ "control_layers": [
+ {
+ "model_key": "controlnet-xyz...",
+ "weight": 1.0,
+ "image": {"image_name": "depth_map.png", "width": 1024, "height": 768}
+ }
+ ],
+ "ip_adapters": [
+ {
+ "model_key": "ip-adapter-xyz...",
+ "weight": 0.5,
+ "image": {"image_name": "style_reference.png", "width": 1024, "height": 1024}
+ }
+ ],
+ "reference_images": [
+ {"image": {"image_name": "style_reference.png", "width": 1024, "height": 1024}}
+ ]
+ }
+}
+```
+
+## WebSocket Events
+
+Parameter updates emit a `recall_parameters_updated` event to the queue
+room. Connected frontend clients automatically:
+
+1. Apply standard parameters (prompts, steps, dimensions, etc.).
+2. Load and add LoRAs to the LoRA list.
+3. Apply control-layer configurations.
+4. Merge the recalled reference images — IP Adapter / FLUX Redux entries and
+ model-free reference images both feed the same reference-image list, using
+ the config flavor that matches the currently-selected main model. By
+ default this **replaces** the existing list; with `append=true` it is
+ **added** to whatever is already there (see
+ [Query parameters](#query-parameters)).
+
+## Error Handling
+
+- **400 Bad Request** — invalid parameters or parameter values, or the
+ mutually exclusive `strict=true&append=true` combination (see
+ [Query parameters](#query-parameters)).
+- **500 Internal Server Error** — server-side storage or retrieval failure.
+
+Errors include detailed messages. Missing images and unresolved model
+names are **not** errors — they are logged and the remaining parameters
+are still applied.
+
+## Logging
+
+### Backend
+
+```
+INFO: Resolved ControlNet model name 'controlnet-canny-sdxl-1.0' to key 'controlnet-xyz...'
+INFO: Found image file: depth_map.png (1024x768)
+INFO: Updated 12 recall parameters for queue default
+INFO: Resolved 1 LoRA(s)
+INFO: Resolved 1 control layer(s)
+INFO: Resolved 1 IP adapter(s)
+INFO: Resolved 1 reference image(s)
+```
+
+### Frontend
+
+Set `localStorage.ROARR_FILTER = 'debug'` in the browser to see all debug
+messages under the `events` namespace.
+
+```
+INFO: Applied 5 recall parameters to store
+INFO: Applied 2 reference image(s) (IP adapters + model-free), replacing existing list
+DEBUG: Built IP adapter ref image state: ip-adapter-xyz... (weight: 0.7)
+DEBUG: IP adapter image: outputs/images/depth_map.png (1024x768)
+```
+
+## Implementation Details
+
+- Parameters are stored in the client state persistence service under
+ `recall_*` keys, scoped to the `queue_id`.
+- Numeric validation runs at the FastAPI layer (e.g. `steps ≥ 1`, `width ≥ 64`).
+- Only non-null parameters are processed, stored, and broadcast.
+- Model-key resolution runs **after** the raw parameters are stored, so
+ an unresolvable model name simply drops out of the broadcast but does
+ not corrupt the persisted state.
+- The broadcast payload contains resolved model keys and image metadata
+ (width/height) so the frontend can populate its store without extra
+ round-trips.
+
+## Troubleshooting
+
+### Image not found
+
+If you see "Image file not found" in the logs:
+
+1. Verify the filename matches exactly (case-sensitive).
+2. Ensure the image is in `{INVOKEAI_ROOT}/outputs/images/`.
+3. Check that the filename does not include the `outputs/images/` prefix.
+
+### Model not found
+
+If you see "Could not find model":
+
+1. Verify the model name matches exactly (case-sensitive).
+2. Ensure the model is installed.
+3. Check the name via the Models Manager panel.
+
+### Event not received
+
+1. Check the browser console for socket connection errors.
+2. Verify the `queue_id` matches the frontend's queue (usually `default`).
+3. Check backend logs for event emission errors.
+
+## Limitations
+
+- **Model availability** — models referenced in the payload must be installed.
+- **Image availability** — images must exist in `outputs/images`; remote
+ URLs are not supported.
+- **Canvas auto-layer creation** — control layers and IP adapters with
+ images populate the recall state, but creating a canvas layer from
+ them still happens through the UI.
+
+## Future enhancements
+
+Potential improvements not yet implemented:
+
+1. Auto-create canvas layers from control-layer images in the payload.
+2. Auto-create reference-image layers from IP Adapter images in the payload.
+3. Support remote image URLs in addition to local `outputs/images` filenames.
+4. Image upload capability (accept base64 or file upload directly via the API).
+5. Batch operations that target multiple `queue_id`s in a single request.
diff --git a/docs/src/content/docs/development/Guides/tests.mdx b/docs/src/content/docs/development/Guides/tests.mdx
new file mode 100644
index 00000000000..c2dfd52b98c
--- /dev/null
+++ b/docs/src/content/docs/development/Guides/tests.mdx
@@ -0,0 +1,102 @@
+---
+title: Writing Tests
+lastUpdated: 2026-02-20
+---
+
+## Frontend Tests
+
+We use `vitest` to run the frontend tests. (See [vite.config.ts](https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/frontend/web/vite.config.mts) for the default `vitest` options.)
+
+{/* TODO: Finish frontend tests docs */}
+
+## Backend Tests
+
+We use `pytest` to run the backend python tests. (See [pyproject.toml](https://github.com/invoke-ai/InvokeAI/blob/main/pyproject.toml) for the default `pytest` options.)
+
+### Fast vs. Slow
+All tests are categorized as either 'fast' (no test annotation) or 'slow' (annotated with the `@pytest.mark.slow` decorator).
+
+'Fast' tests are run to validate every PR, and are fast enough that they can be run routinely during development.
+
+'Slow' tests are currently only run manually on an ad-hoc basis. In the future, they may be automated to run nightly. Most developers are only expected to run the 'slow' tests that directly relate to the feature(s) that they are working on.
+
+As a rule of thumb, tests should be marked as 'slow' if there is a chance that they take >1s (e.g. on a CPU-only machine with slow internet connection). Common examples of slow tests are tests that depend on downloading a model, or running model inference.
+
+### Running Tests
+
+Below are some common test commands:
+
+```bash
+# Run the fast tests. (This implicitly uses the configured default option: `-m "not slow"`.)
+pytest tests/
+
+# Equivalent command to run the fast tests.
+pytest tests/ -m "not slow"
+
+# Run the slow tests.
+pytest tests/ -m "slow"
+
+# Run the slow tests from a specific file.
+pytest tests/path/to/slow_test.py -m "slow"
+
+# Run all tests (fast and slow).
+pytest tests -m ""
+```
+
+### Test Organization
+
+All backend tests are in the [`tests/`](https://github.com/invoke-ai/InvokeAI/tree/main/tests) directory. This directory mirrors the organization of the `invokeai/` directory. For example, tests for `invokeai/model_management/model_manager.py` would be found in `tests/model_management/test_model_manager.py`.
+
+TODO: The above statement is aspirational. A re-organization of legacy tests is required to make it true.
+
+### Tests that depend on models
+
+There are a few things to keep in mind when adding tests that depend on models.
+
+1. If a required model is not already present, it should automatically be downloaded as part of the test setup.
+2. If a model is already downloaded, it should not be re-downloaded unnecessarily.
+3. Take reasonable care to keep the total number of models required for the tests low. Whenever possible, re-use models that are already required for other tests. If you are adding a new model, consider including a comment to explain why it is required/unique.
+
+There are several utilities to help with model setup for tests. Here is a sample test that depends on a model:
+
+```python
+import pytest
+import torch
+
+from invokeai.backend.model_management.models.base import BaseModelType, ModelType
+from invokeai.backend.util.test_utils import install_and_load_model
+
+@pytest.mark.slow
+def test_model(model_installer, torch_device):
+ model_info = install_and_load_model(
+ model_installer=model_installer,
+ model_path_id_or_url="HF/dummy_model_id",
+ model_name="dummy_model",
+ base_model=BaseModelType.StableDiffusion1,
+ model_type=ModelType.Dummy,
+ )
+
+ dummy_input = build_dummy_input(torch_device)
+
+ with torch.no_grad(), model_info as model:
+ model.to(torch_device, dtype=torch.float32)
+ output = model(dummy_input)
+
+ # Validate output...
+```
+
+### Test Coverage
+
+To review test coverage, append `--cov` to your pytest command:
+
+```bash
+pytest tests/ --cov
+```
+
+Test outcomes and coverage will be reported in the terminal. In addition, a more detailed report is created in both XML and HTML format in the `./coverage` folder. The HTML output is particularly helpful in identifying untested statements where coverage should be improved. The HTML report can be viewed by opening `./coverage/html/index.html`.
+
+:::note HTML coverage report output example
+ 
+
+ 
+:::
diff --git a/docs/src/content/docs/development/Guides/workflow-api.mdx b/docs/src/content/docs/development/Guides/workflow-api.mdx
new file mode 100644
index 00000000000..effe66a352a
--- /dev/null
+++ b/docs/src/content/docs/development/Guides/workflow-api.mdx
@@ -0,0 +1,106 @@
+---
+title: Workflow Execution API
+---
+
+## Overview
+
+InvokeAI's HTTP API can be used programmatically from external clients, but one distinction is easy to miss:
+
+- A saved **workflow** is not executed directly.
+- The queue accepts an executable **graph**.
+- If you fetch a saved workflow from `/api/v1/workflows/`, you still need to enqueue a graph with `POST /api/v1/queue/default/enqueue_batch`.
+
+This is a common source of confusion when a client can successfully read workflow records but cannot execute them.
+
+If you are using multi-user mode, include your `Authorization: Bearer ` header on these requests.
+
+## Minimal `enqueue_batch` Example
+
+The smallest useful "hello world" is a simple graph with one math node. This avoids any image-model setup and lets you verify that your client can enqueue work and poll for completion.
+
+```python
+import requests
+import time
+
+BASE_URL = "http://localhost:9090"
+
+graph = {
+ "id": "hello-graph",
+ "nodes": {
+ "add-node": {
+ "id": "add-node",
+ "type": "add",
+ "a": 2,
+ "b": 3,
+ "is_intermediate": False,
+ "use_cache": True,
+ }
+ },
+ "edges": [],
+}
+
+payload = {
+ "batch": {
+ "graph": graph,
+ "runs": 1,
+ "origin": "external-client",
+ }
+}
+
+enqueue_response = requests.post(
+ f"{BASE_URL}/api/v1/queue/default/enqueue_batch",
+ json=payload,
+)
+enqueue_response.raise_for_status()
+
+item_id = enqueue_response.json()["item_ids"][0]
+
+while True:
+ item_response = requests.get(f"{BASE_URL}/api/v1/queue/default/i/{item_id}")
+ item_response.raise_for_status()
+ item = item_response.json()
+
+ status = item["status"]
+ if status == "completed":
+ print(item["session"]["results"])
+ break
+ if status == "failed":
+ raise RuntimeError(item["error_message"])
+ if status == "canceled":
+ raise RuntimeError("Queue item was canceled")
+
+ time.sleep(0.5)
+```
+
+For the graph above, the completed queue item will contain the output in `session.results`.
+
+## Getting an Image Output
+
+For image-generation graphs, the completed queue item also includes `session.results`, but the output object will typically contain an image reference instead of a plain integer value.
+
+For example, an image output may look like this:
+
+```json
+{
+ "type": "image_output",
+ "image": {
+ "image_name": "abc123.png"
+ }
+}
+```
+
+Once you have the `image_name`, you can download the generated file from:
+
+```text
+GET /api/v1/images/i/{image_name}/full
+```
+
+If you only need the file preview, you can also use:
+
+```text
+GET /api/v1/images/i/{image_name}/thumbnail
+```
+
+## Polling vs. WebSockets
+
+The example above uses polling because it is the easiest way to get started from an external client. If you need lower-latency updates, you can also use the socket events emitted during queue execution.
diff --git a/docs/src/content/docs/development/Process/pr-merge-policy.mdx b/docs/src/content/docs/development/Process/pr-merge-policy.mdx
new file mode 100644
index 00000000000..ebd08feaaf0
--- /dev/null
+++ b/docs/src/content/docs/development/Process/pr-merge-policy.mdx
@@ -0,0 +1,72 @@
+---
+title: PR Merge Policy
+lastUpdated: 2026-02-19
+---
+
+import { Steps } from '@astrojs/starlight/components';
+
+This document outlines the process for reviewing and merging pull requests (PRs) into the InvokeAI repository.
+
+## Review Process
+
+
+ 1. Assignment
+
+ One of the repository maintainers will assign collaborators to review a pull request. The assigned reviewer(s) will be responsible for conducting the code review.
+
+ 2. Review and Iteration
+
+ The assignee is responsible for:
+ - Reviewing the PR thoroughly
+ - Providing constructive feedback
+ - Iterating with the PR author until the assignee is satisfied that the PR is fit to merge
+ - Ensuring the PR meets code quality standards, follows project conventions, and doesn't introduce bugs or regressions
+
+ 3. Approval and Notification
+
+ Once the assignee is satisfied with the PR:
+ - The assignee approves the PR
+ - The assignee alerts one of the maintainers that the PR is ready for merge using the **#request-reviews Discord channel**
+
+ 4. Final Merge
+
+ One of the maintainers is responsible for:
+ - Performing a final check of the PR
+ - Merging the PR into the appropriate branch
+
+ :::caution[Important]
+ Collaborators are strongly discouraged from merging PRs on their own, except in case of emergency (e.g., critical bug fix and no maintainer is available).
+ :::
+
+ 5. Release Policy
+
+ Once a feature release candidate is published, no feature PRs are to
+ be merged into main. Only bugfixes are allowed until the final
+ release.
+
+
+## Best Practices
+
+### Clean Commit History
+
+To encourage a clean development log, PR authors are encouraged to use `git rebase -i` to suppress trivial commit messages (e.g., `ruff` and `prettier` formatting fixes) after the PR is accepted but before it is merged.
+
+### Merge Strategy
+
+The maintainer will perform either a **3-way merge** or **squash merge** when merging a PR into the `main` branch. This approach helps avoid rebase conflict hell and maintains a cleaner project history.
+
+### Attribution
+
+The PR author should reference any papers, source code or
+documentation that they used while creating the code both in the PR
+and as comments in the code itself. If there are any licensing
+restrictions, these should be linked to and/or reproduced in the repo
+root.
+
+## Summary
+
+This policy ensures that:
+- All PRs receive proper review from assigned collaborators
+- Maintainers have final oversight before code enters the main branch
+- The commit history remains clean and meaningful
+- Merge conflicts are minimized through appropriate merge strategies
diff --git a/docs/src/content/docs/development/Process/release-process.mdx b/docs/src/content/docs/development/Process/release-process.mdx
new file mode 100644
index 00000000000..9869e4940e2
--- /dev/null
+++ b/docs/src/content/docs/development/Process/release-process.mdx
@@ -0,0 +1,157 @@
+---
+title: Release Process
+lastUpdated: 2025-12-26
+---
+
+The Invoke application is published as a python package on [PyPI]. This includes both a source distribution and built distribution (a wheel).
+
+Most users install it with the [Launcher](https://github.com/invoke-ai/launcher/), others with `pip`.
+
+The launcher uses GitHub as the source of truth for available releases.
+
+## Broad Strokes
+
+- Merge all changes and bump the version in the codebase.
+- Tag the release commit.
+- Wait for the release workflow to complete.
+- Approve the PyPI publish jobs.
+- Write GH release notes.
+
+## General Prep
+
+Make a developer call-out for PRs to merge. Merge and test things
+out. Create a branch with a name like user/chore/vX.X.X-prep and bump the version by editing
+`invokeai/version/invokeai_version.py` and commit locally.
+
+## Release Workflow
+
+The `release.yml` workflow runs a number of jobs to handle code checks, tests, build and publish on PyPI.
+
+It is triggered on **tag push**, when the tag matches `v*`.
+
+### Triggering the Workflow
+
+Ensure all commits that should be in the release are merged into this branch, and that you have pulled them locally.
+
+Run `make tag-release` to tag the current commit and kick off the workflow. You will be prompted to provide a message - use the version specifier.
+
+If this version's tag already exists for some reason (maybe you had to make a last minute change), the script will overwrite it.
+
+Push the commit to trigger the workflow.
+
+> In case you cannot use the Make target, the release may also be dispatched [manually] via GH.
+
+### Workflow Jobs and Process
+
+The workflow consists of a number of concurrently-run checks and tests, then two final publish jobs.
+
+The publish jobs require manual approval and are only run if the other jobs succeed.
+
+#### `check-version` Job
+
+This job ensures that the `invokeai` python package version specifier matches the tag for the release. The version specifier is pulled from the `__version__` variable in `invokeai/version/invokeai_version.py`.
+
+This job uses [samuelcolvin/check-python-version].
+
+> Any valid [version specifier] works, so long as the tag matches the version. The release workflow works exactly the same for `RC`, `post`, `dev`, etc.
+
+#### Check and Test Jobs
+
+Next, these jobs run and must pass. They are the same jobs that are run for every PR.
+
+- **`python-tests`**: runs `pytest` on matrix of platforms
+- **`python-checks`**: runs `ruff` (format and lint)
+- **`frontend-tests`**: runs `vitest`
+- **`frontend-checks`**: runs `prettier` (format), `eslint` (lint), `dpdm` (circular refs), `tsc` (static type check) and `knip` (unused imports)
+- **`typegen-checks`**: ensures the frontend and backend types are synced
+
+#### `build-wheel` Job
+
+This sets up both python and frontend dependencies and builds the python package. Internally, this runs `./scripts/build_wheel.sh` and uploads `dist.zip`, which contains the wheel and unarchived build.
+
+You don't need to download or test these artifacts.
+
+#### Sanity Check & Smoke Test
+
+At this point, the release workflow pauses as the remaining publish jobs require approval.
+
+It's possible to test the python package before it gets published to PyPI. We've never had problems with it, so it's not necessary to do this.
+
+But, if you want to be extra-super careful, here's how to test it:
+
+- Download the `dist.zip` build artifact from the `build-wheel` job
+- Unzip it and find the wheel file
+- Create a fresh Invoke install by following the [manual install guide](/start-here/manual/) - but instead of installing from PyPI, install from the wheel
+- Test the app
+
+##### Something isn't right
+
+If testing reveals any issues, no worries. Cancel the workflow, which will cancel the pending publish jobs (you didn't approve them prematurely, right?) and start over.
+
+#### PyPI Publish Jobs
+
+The publish jobs will not run if any of the previous jobs fail.
+
+They use [GitHub environments], which are configured as [trusted publishers] on PyPI.
+
+Both jobs require a @lstein or @blessedcoolant to approve them from the workflow's **Summary** tab.
+
+- Click the **Review deployments** button
+- Select the environment (either `testpypi` or `pypi` - typically you select both)
+- Click **Approve and deploy**
+
+> **If the version already exists on PyPI, the publish jobs will fail.** PyPI only allows a given version to be published once - you cannot change it. If version published on PyPI has a problem, you'll need to "fail forward" by bumping the app version and publishing a followup release.
+
+##### Failing PyPI Publish
+
+Check the [python infrastructure status page] for incidents.
+
+If there are no incidents, contact @lstein or @blessedcoolant, who have owner access to GH and PyPI, to see if access has expired or something like that.
+
+#### `publish-testpypi` Job
+
+Publishes the distribution on the [Test PyPI] index, using the `testpypi` GitHub environment.
+
+This job is not required for the production PyPI publish, but included just in case you want to test the PyPI release for some reason:
+
+- Approve this publish job without approving the prod publish
+- Let it finish
+- Create a fresh Invoke install by following the [manual install guide](/start-here/manual/), making sure to use the Test PyPI index URL: `https://test.pypi.org/simple/`
+- Test the app
+
+#### `publish-pypi` Job
+
+Publishes the distribution on the production PyPI index, using the `pypi` GitHub environment.
+
+It's a good idea to wait to approve and run this job until you have the release notes ready!
+
+## Prep and publish the GitHub Release
+
+1. [Draft a new release] on GitHub, choosing the tag that triggered the release.
+2. The **Generate release notes** button automatically inserts the changelog and new contributors. Make sure to select the correct tags for this release and the last stable release. GH often selects the wrong tags - do this manually.
+3. Write the release notes, describing important changes. Contributions from community members should be shouted out. Use the GH-generated changelog to see all contributors. If there are Weblate translation updates, open that PR and shout out every person who contributed a translation.
+4. Check **Set as a pre-release** if it's a pre-release.
+5. Approve and wait for the `publish-pypi` job to finish if you haven't already.
+6. Publish the GH release.
+7. Post the release in Discord in the [releases](https://discord.com/channels/1020123559063990373/1149260708098359327) channel with abbreviated notes. For example:
+ > Invoke v5.7.0 (stable): [https://github.com/invoke-ai/InvokeAI/releases/tag/v5.7.0](https://github.com/invoke-ai/InvokeAI/releases/tag/v5.7.0)
+ >
+ > It's a pretty big one - Form Builder, Metadata Nodes (thanks @SkunkWorxDark!), and much more.
+8. Right click the message in releases and copy the link to it. Then, post that link in the [new-release-discussion](https://discord.com/channels/1020123559063990373/1149506274971631688) channel. For example:
+ > Invoke v5.7.0 (stable): [https://discord.com/channels/1020123559063990373/1149260708098359327/1344521744916021248](https://discord.com/channels/1020123559063990373/1149260708098359327/1344521744916021248)
+
+## Manual Release
+
+The `release` workflow can be dispatched manually. You must dispatch the workflow from the right tag, else it will fail the version check.
+
+This functionality is available as a fallback in case something goes wonky. Typically, releases should be triggered via tag push as described above.
+
+[PyPI]: https://pypi.org/
+[Draft a new release]: https://github.com/invoke-ai/InvokeAI/releases/new
+[Test PyPI]: https://test.pypi.org/
+[version specifier]: https://packaging.python.org/en/latest/specifications/version-specifiers/
+[GitHub environments]: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment
+[trusted publishers]: https://docs.pypi.org/trusted-publishers/
+[samuelcolvin/check-python-version]: https://github.com/samuelcolvin/check-python-version
+[manually]: #manual-release
+[python infrastructure status page]: https://status.python.org/
diff --git a/docs/src/content/docs/development/Setup/dev-environment.mdx b/docs/src/content/docs/development/Setup/dev-environment.mdx
new file mode 100644
index 00000000000..a92223e3ebb
--- /dev/null
+++ b/docs/src/content/docs/development/Setup/dev-environment.mdx
@@ -0,0 +1,275 @@
+---
+title: Development Environment
+lastUpdated: 2026-02-19
+---
+
+import { LinkCard, Steps, Tabs, TabItem, FileTree, LinkButton } from '@astrojs/starlight/components'
+import SystemRequirementsLink from '@components/SystemRequirmentsLink.astro'
+
+:::caution
+ Invoke uses a SQLite database. When you run the application as a dev install, you accept responsibility for your database. This means making regular backups (especially before pulling) and/or fixing it yourself in the event that a PR introduces a schema change.
+
+ If you don't need to persist your db, you can use an ephemeral in-memory database by setting `use_memory_db: true` in your `invokeai.yaml` file. You'll also want to set `scan_models_on_startup: true` so that your models are registered on startup.
+:::
+
+## Initial Setup
+
+
+ 1. Refer to the system requirements.
+
+
+
+ 2. Fork and clone the InvokeAI git repository.
+
+
+ Fork Repository
+
+
+ Next, clone your fork to your local machine. You can use either HTTPS or SSH, depending on your git configuration.
+
+ 3. This repository uses Git LFS to manage large files. To ensure all assets are downloaded:
+ - Install git-lfs → [Download here](https://git-lfs.com/)
+ - Enable automatic LFS fetching for this repository:
+ ```shell
+ git config lfs.fetchinclude "*"
+ ```
+ - Fetch files from LFS (only needs to be done once; subsequent `git pull` will fetch changes automatically):
+ ```shell
+ git lfs pull
+ ```
+ 4. Create a directory for user data (images, models, db, etc). This is typically at `~/invokeai`, but if you already have a non-dev install, you may want to create a separate directory for the dev install.
+ 5. Follow the [manual install](/start-here/manual/) guide, with some modifications to the install command:
+
+ - Use `.` instead of `invokeai` to install from the current directory. You don't need to specify the version.
+ - Use `uv sync` instead of `uv pip install` so the environment is synchronized from the repository lockfile.
+ - The current project is installed as an editable install by default. That means your changes to the python code will be reflected when you restart the Invoke server.
+ - Add the `dev`, `test`, `docs`, and appropriate GPU package options with `--extra`. You may or may not need the `xformers` option - follow the manual install guide to figure that out.
+
+ With the modifications made, the sync command should look something like this:
+
+ ```sh
+ uv sync --frozen \
+ --python 3.12 \
+ --managed-python \
+ --extra dev \
+ --extra test \
+ --extra docs \
+ --extra cuda \
+ --extra xformers
+ ```
+ 6. At this point, you should have Invoke installed, a venv set up and activated, and the server running. But you will see a warning in the terminal that no UI was found. If you go to the URL for the server, you won't get a UI.
+
+ This is because the UI build is not distributed with the source code. You need to build it manually. End the running server instance.
+
+ *(If you only want to edit the docs, you can stop here and skip to the **Documentation** section below.)*
+
+ 7. Install the frontend dev toolchain, paying attention to versions:
+
+ - [`nodejs`](https://nodejs.org/) (tested on LTS, v22)
+ - [`pnpm`](https://pnpm.io/installation) (tested on v10)
+
+ 8. Do a production build of the frontend:
+
+ ```sh
+ cd /invokeai/frontend/web
+ pnpm i
+ pnpm build
+ ```
+
+ 9. Restart the server and navigate to the URL. You should get a UI. After making changes to the python code, restart the server to see those changes.
+
+
+## Backend Development
+
+Experimenting with changes to the Python source code is a drag if you have to re-start the server and re-load multi-gigabyte models after every change.
+
+For a faster development workflow, add the `--dev_reload` flag when starting the server. The server will watch for changes to all the Python files in the `invokeai` directory and apply those changes to the running server on the fly.
+
+This will allow you to avoid restarting the server (and reloading models) in most cases, but there are some caveats; see the [jurigged documentation](https://github.com/breuleux/jurigged#caveats) for details.
+
+### Testing
+
+The backend tests require the `test` dependency group, which you installed during the initial setup.
+
+See the [Tests](../tests) documentation for information about running and writing tests.
+
+## Frontend Development
+
+You'll need to run `pnpm build` every time you pull in new changes to the frontend.
+
+Another option is to skip the build and instead run the UI in dev mode:
+
+```sh
+cd invokeai/frontend/web
+pnpm dev
+```
+
+This starts a vite dev server for the UI at `127.0.0.1:5173`, which you will use instead of `127.0.0.1:9090`.
+
+The dev mode is substantially slower than the production build but may be more convenient if you just need to test things out. It will hot-reload the UI as you make changes to the frontend code. Sometimes the hot-reload doesn't work, and you need to manually refresh the browser tab.
+
+## Documentation
+
+This documentation is built on [Astro Starlight](https://starlight.astro.build/). It provides a pleasant developer environment for writing engaging documentation, and is built on top of the Astro static site generator, which provides a powerful and flexible framework for building fast, modern websites.
+
+To contribute to the documentation, simply edit the markdown files in the `./docs` directory. You can run a local dev server with hot-reloading for changes made to the docs.
+
+
+ - **docs**
+ - public/
+ - src
+ - content docs content lives here
+ - docs
+ - lib
+ - components/
+ - utils/
+ - content.config.ts
+ - scripts/
+ - tests/
+ - invokeai/
+ - docker/
+ - coverage/
+
+
+
+ 1. Navigate to the `docs` directory and install the dependencies:
+
+ ```sh
+ cd docs
+ pnpm install
+ ```
+ 2. Start the dev server:
+
+ ```sh
+ pnpm run dev
+ ```
+
+
+## VSCode Setup
+
+VSCode offers excellent tools for InvokeAI development, including a python debugger, automatic virtual environment activation, and remote development capabilities.
+
+### Prerequisites
+
+First, ensure you have the following extensions installed:
+- [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python)
+- [Pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance)
+
+It's also highly recommended to install the Jupyter extensions if you plan on working with notebooks:
+- [Jupyter](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
+- [Jupyter Cell Tags](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.vscode-jupyter-cell-tags)
+- [Jupyter Notebook Renderers](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter-renderers)
+- [Jupyter Slide Show](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.vscode-jupyter-slideshow)
+
+### Configuration
+
+
+
+ Creating a VSCode workspace for working on InvokeAI is highly recommended to hold InvokeAI-specific settings and configs.
+
+ 1. Open the InvokeAI repository directory in VSCode
+ 2. Go to `File` > `Save Workspace As` and save it *outside* the repository
+
+ **Default Python Interpreter**
+
+ To enable automatic virtual environment activation:
+ 1. Open the command palette (`Ctrl+Shift+P` / `Cmd+Shift+P`) and run `Preferences: Open Workspace Settings (JSON)`
+ 2. Add `python.defaultInterpreterPath` to your settings, pointing to your virtual environment's python executable:
+
+ ```jsonc
+ {
+ "folders": [
+ { "path": "InvokeAI" },
+ { "path": "/path/to/invokeai_root" }
+ ],
+ "settings": {
+ "python.defaultInterpreterPath": "/path/to/invokeai_root/.venv/bin/python"
+ }
+ }
+ ```
+ Now, opening the integrated terminal or running python will automatically use your InvokeAI virtual environment.
+
+
+
+ We use Python's typing system in InvokeAI. PR reviews will include checking that types are present and correct.
+
+ Pylance provides type checking in the editor. To enable it:
+
+ 1. Open a Python file
+ 2. Look along the status bar in VSCode for `{ } Python`
+ 3. Click the `{ }`
+ 4. Turn type checking on (Basic is fine)
+
+ You'll now see red squiggly lines where type issues are detected. Hover your cursor over the indicated symbols to see what's wrong.
+
+
+
+ Debugging configs are managed in a `launch.json` file. Follow the [official guide](https://code.visualstudio.com/docs/python/debugging) to set up your `launch.json` and try it out.
+
+ Add these InvokeAI debugging configurations to your `launch.json`:
+
+ ```jsonc
+ {
+ "version": "0.2.0",
+ "configurations": [
+ {
+ "name": "InvokeAI Web",
+ "type": "python",
+ "request": "launch",
+ "program": "scripts/invokeai-web.py",
+ "args": [
+ "--root", "/path/to/invokeai_root",
+ "--host", "0.0.0.0"
+ ],
+ "justMyCode": true
+ },
+ {
+ "name": "InvokeAI CLI",
+ "type": "python",
+ "request": "launch",
+ "program": "scripts/invokeai-cli.py",
+ "justMyCode": true
+ },
+ {
+ "name": "InvokeAI Test",
+ "type": "python",
+ "request": "launch",
+ "module": "pytest",
+ "args": ["--capture=no"],
+ "justMyCode": true
+ },
+ {
+ "name": "InvokeAI Single Test",
+ "type": "python",
+ "request": "launch",
+ "module": "pytest",
+ "args": ["tests/nodes/test_invoker.py"],
+ "justMyCode": true
+ }
+ ]
+ }
+ ```
+
+
+
+ This provides a smooth experience for running the backend on a powerful Linux machine while developing on another device.
+
+ Consult the [official guide](https://code.visualstudio.com/docs/remote/remote-overview) to get it set up. We suggest using VSCode's included settings sync so that your remote dev host has all the same app settings and extensions automatically.
+
+ :::tip[Port Forwarding]
+ Automatic port forwarding can be flaky. You can disable it in `Preferences: Open Remote Settings (ssh: hostname)` by unticking `remote.autoForwardPorts`.
+
+ To forward ports reliably, use SSH on the remote dev client:
+ ```bash
+ ssh -L 9090:localhost:9090 -L 5173:localhost:5173 user@remote-dev-host
+ ```
+ Run this outside the VSCode integrated terminal so it persists across VSCode restarts.
+ :::
+
+
diff --git a/docs/src/content/docs/development/index.mdx b/docs/src/content/docs/development/index.mdx
new file mode 100644
index 00000000000..77e362bc10d
--- /dev/null
+++ b/docs/src/content/docs/development/index.mdx
@@ -0,0 +1,48 @@
+---
+title: InvokeAI Development
+sidebar:
+ order: 1
+lastUpdated: 2026-02-19
+---
+
+import { Card, CardGrid, LinkButton } from '@astrojs/starlight/components';
+
+This section of the documentation is for developers interested in contributing to the InvokeAI codebase, or building on top of it. It includes guides for setting up your development environment, understanding the project structure, and making your first contribution.
+
+
+
+ Instructions for setting up your local development environment, including how to run the project locally and how to set up your tooling.
+
+
+ Learn more
+
+
+
+ An introduction to the front end codebase, including the technologies used and how to get started.
+
+
+ Learn more
+
+
+
+ A collection of guides for common development tasks, such as adding new model architectures, making tests, and more.
+
+
+ Learn more
+
+
+
+ An overview of the InvokeAI architecture, including the major components and how they interact.
+
+
+ Learn more
+
+
+
+ An overview of the development processes we follow, including our pull request merge policy and release process.
+
+
+ Learn more
+
+
+
diff --git a/docs/src/content/docs/features/Canvas/canvas-projects.mdx b/docs/src/content/docs/features/Canvas/canvas-projects.mdx
new file mode 100644
index 00000000000..92c549abe2b
--- /dev/null
+++ b/docs/src/content/docs/features/Canvas/canvas-projects.mdx
@@ -0,0 +1,60 @@
+---
+title: Canvas Projects
+sidebar:
+ badge: New
+ order: 7
+---
+
+import { Steps } from '@astrojs/starlight/components';
+
+Canvas Projects let you save the entire state of a canvas — including all layers, masks, reference images, generation parameters, and LoRAs — into a single `.invk` file that you can reopen later or share with someone else.
+
+`.invk` files are ZIP archives. When saved images can be fetched successfully from the server, they embed the actual image bytes for every layer and reference image, so a project is self-contained: opening it on another machine or after wiping the gallery can restore those images.
+
+## Saving a project
+
+
+1. Open the canvas and arrange your layers, masks, reference images, and parameters the way you want them.
+2. Open the archive menu in the canvas toolbar, or open the canvas context menu and choose **Project**.
+3. Choose **Save Canvas Project**.
+4. Optionally rename the project (the default is **Canvas Project**).
+5. Save the `.invk` file to disk.
+
+
+What gets saved:
+
+- All raster, inpaint, and control layers, with their image data, transforms, opacity, and lock state.
+- All masks.
+- Reference images.
+- Currently configured generation parameters (model, prompts, scheduler, seed, dimensions, etc.).
+- LoRAs and their weights.
+
+## Loading a project
+
+
+1. Open the archive menu in the canvas toolbar, or open the canvas context menu and choose **Project**.
+2. Choose **Load Canvas Project**.
+3. Pick the `.invk` file.
+
+
+When a project is loaded, the canvas is replaced with the project's state. LoRAs are reset first, then re-applied from the project, so opening a project never leaves stale LoRAs from your previous session attached.
+
+### Image deduplication
+
+Loading a project does **not** blindly re-upload every embedded image. Invoke compares each embedded image against what is already in your gallery and only uploads the images that are missing. Re-opening the same project a second time, or opening it shortly after saving it, is therefore very fast — most or all images will already be on the server.
+
+This also means a project shared with another user will upload its missing embedded images the first time it is opened on that user's machine, then become nearly free to re-open after that.
+
+To keep the gallery responsive during large imports, image fetches and uploads are limited to a small number of concurrent requests.
+
+## What `.invk` does *not* save
+
+A `.invk` file is a canvas state snapshot. It does **not** contain:
+
+- The models, LoRAs, or embeddings themselves — only references to them. If you share a project, the recipient needs the same models installed (or compatible substitutes).
+- Workflow editor state (use **Save Workflow** in the workflow editor for that).
+- Gallery boards or images outside the canvas.
+
+## Sharing projects
+
+`.invk` files are safe to share directly. The recipient loads the file from the canvas toolbar archive menu or canvas context menu. They'll need any referenced models / LoRAs installed locally; if a referenced model is missing, the parameter slot will be empty and they can pick a substitute before generating.
diff --git a/docs/src/content/docs/features/Canvas/gradient-tool.mdx b/docs/src/content/docs/features/Canvas/gradient-tool.mdx
new file mode 100644
index 00000000000..0c9dee0f929
--- /dev/null
+++ b/docs/src/content/docs/features/Canvas/gradient-tool.mdx
@@ -0,0 +1,75 @@
+---
+title: Gradient Tool
+description: Learn how to paint linear and radial gradients on canvas raster layers.
+lastUpdated: 2026-05-16
+sidebar:
+ order: 4
+---
+
+import { Card, CardGrid } from '@astrojs/starlight/components';
+
+The Gradient tool paints a smooth transition between your current foreground and background colors on the canvas.
+
+You can activate the Gradient tool from the canvas toolbar.
+
+## Where Gradient Draws
+
+Gradient only draws into the **active raster layer**:
+
+- It does not draw into inpaint masks.
+- It does not draw into other non-raster layer types.
+- The result is always clipped to the current **generation bounding box**.
+
+If a raster layer is not selected, the tool is unavailable.
+
+## Common Behavior
+
+- Click and drag to define the gradient.
+- Release the pointer to commit the gradient.
+- Press Esc to discard the in-progress gradient.
+- Hold Alt to temporarily switch to the color picker.
+- Hold Space to temporarily switch to panning.
+
+The Gradient tool uses the current **FG/BG color pair**:
+
+- The **active** color swatch becomes the start color.
+- The **inactive** color swatch becomes the end color.
+
+## Gradient Modes
+
+
+
+ Click and drag to set the gradient direction. The drag defines the transition from the start color to the end
+ color.
+
+
+ Click to place the center, then drag outward to set the radius. The gradient fades from the start color at the
+ center to the end color toward the outside.
+
+
+
+## Clip Gradient
+
+The toolbar includes a **Clip Gradient** toggle:
+
+- **Enabled:** Limits the gradient to the dragged region.
+- **Disabled:** Lets the gradient extend across the full current bounding box.
+
+In practice:
+
+- A clipped **linear** gradient is limited to the span you dragged.
+- A clipped **radial** gradient is limited to the circle you dragged out.
+- With clipping disabled, both modes can be used to wash the entire bbox with a full gradient transition.
+
+## Practical Examples
+
+- Use **Linear** for sky fades, shadow ramps, and broad directional lighting.
+- Use **Radial** for vignettes, glows, spotlights, and soft falloff around a focal point.
+- Disable **Clip Gradient** when you want a full-bbox color transition.
+- Keep **Clip Gradient** enabled when you only want to affect a localized area.
+
+## Summary
+
+The Gradient tool is a raster-only canvas tool for painting linear and radial color transitions. Use it when you want
+soft blends between your FG and BG colors, and use **Clip Gradient** to decide whether the effect stays local or fills
+the full bbox.
diff --git a/docs/src/content/docs/features/Canvas/lasso-tool.mdx b/docs/src/content/docs/features/Canvas/lasso-tool.mdx
new file mode 100644
index 00000000000..7cc676aa6f9
--- /dev/null
+++ b/docs/src/content/docs/features/Canvas/lasso-tool.mdx
@@ -0,0 +1,77 @@
+---
+title: Lasso Tool
+description: Learn how to create and refine inpaint masks with the Lasso tool.
+lastUpdated: 2026-05-15
+sidebar:
+ order: 2
+---
+
+import { Card, CardGrid } from '@astrojs/starlight/components';
+
+The Lasso tool is the canvas's dedicated masking tool. It always draws into **inpaint mask layers** and is designed
+for quickly defining irregular regions for inpainting.
+
+You can activate the Lasso tool from the canvas toolbar or with the default hotkey L.
+
+## Where Lasso Draws
+
+Lasso always targets an **enabled inpaint mask**:
+
+- If an enabled inpaint mask is currently selected, Lasso draws into that mask.
+- If no enabled inpaint mask is available, Lasso creates a new inpaint mask automatically and commits the contour
+ there.
+
+:::note
+If a disabled inpaint mask is selected, Lasso does not draw into the disabled mask. It creates a new enabled mask for
+the next contour instead.
+:::
+
+## Common Behavior
+
+- Lasso always commits a **closed contour**.
+- Hold Ctrl on Windows/Linux or Cmd on macOS to switch to **subtractive** mode and remove area
+ from the mask instead of adding to it.
+- Press Esc to cancel the current lasso session.
+- Hold Space during an active session to pan the viewport without discarding the unfinished contour.
+
+## Lasso Modes
+
+
+
+ Click and drag to sketch an irregular contour. Releasing the pointer closes and commits the contour automatically.
+
+
+ Click to place vertices. Click the first point to close and commit the contour. Hold Shift while
+ placing the next edge to snap it to horizontal, vertical, and 45 degree angles.
+
+
+
+## Moving and Panning During Drawing
+
+The Lasso tool uses Space for panning in both modes:
+
+- **Freehand:** While drawing, hold Space to pan the viewport without discarding the unfinished contour.
+ Release Space to continue drawing.
+- **Polygon:** During an active polygon session, hold Space to pan the viewport without discarding the
+ unfinished contour. Release Space and continue placing points.
+
+This is especially useful when drawing large mask regions that extend beyond the current viewport.
+
+## Working With Masks
+
+- Use **Freehand** for organic shapes like hair, smoke, foliage, fabric, and quick blocking.
+- Use **Polygon** when you need straight edges and deliberate corner placement.
+- Use **subtractive mode** to trim or punch holes in an existing inpaint mask.
+- Use Lasso when you want mask-first editing behavior without first creating a mask layer by hand.
+
+## Practical Notes
+
+- Polygon mode shows the starting point so you can close the contour precisely.
+- After at least three polygon points, moving near the start point lets you click it to finish the shape.
+- Freehand is faster for loose silhouettes. Polygon is better when edge placement matters.
+
+## Summary
+
+The Lasso tool is the fastest way to create and refine inpaint masks on the canvas. Use Freehand for organic regions,
+Polygon for hard edges, and hold Ctrl/Cmd whenever you need to subtract from the mask instead of
+adding to it.
diff --git a/docs/src/content/docs/features/Canvas/layers-and-drops.mdx b/docs/src/content/docs/features/Canvas/layers-and-drops.mdx
new file mode 100644
index 00000000000..eadc002d696
--- /dev/null
+++ b/docs/src/content/docs/features/Canvas/layers-and-drops.mdx
@@ -0,0 +1,35 @@
+---
+title: Layer Tips
+sidebar:
+ order: 6
+---
+
+A couple of layer-related behaviors that aren't obvious from the canvas UI alone.
+
+## Drag & drop targets
+
+Dragging an image onto the canvas reveals **five** drop zones, arranged as two zones on top and three on the bottom:
+
+| Top row | |
+| :--- | :--- |
+| **New Raster Layer** | Create a regular raster layer from the dropped image. |
+| **New Control Layer** | Create a control layer from the dropped image. |
+
+| Bottom row | |
+| :--- | :--- |
+| **New Regional Reference** | Use the image as a regional reference. |
+| **New Inpaint Mask** | Create a new inpaint mask layer using the image as the mask source. |
+| **New Resized Control Layer** | Create a control layer resized to the current canvas dimensions. |
+
+You can drop from the gallery, from disk, or from any panel that shows a draggable image.
+
+## Lock transparency on raster layers
+
+Each raster layer has a **Lock Transparency** toggle (drop icon) in its layer header. When enabled, brush strokes only affect existing non-transparent pixels — painting over transparent areas does nothing. This behaves like Photoshop's "Lock Transparent Pixels".
+
+Typical uses:
+
+- **Recolor an existing shape** without bleeding paint into the empty space around it.
+- **Refine details on a subject** that was painted on an otherwise transparent layer, with no risk of growing its silhouette.
+
+Toggle it off to resume normal painting. The lock is per-layer, so different layers can be locked or unlocked independently. Pressure-sensitive pen input and undo/redo both respect the lock.
diff --git a/docs/src/content/docs/features/Canvas/run-workflow.mdx b/docs/src/content/docs/features/Canvas/run-workflow.mdx
new file mode 100644
index 00000000000..4134072c7f8
--- /dev/null
+++ b/docs/src/content/docs/features/Canvas/run-workflow.mdx
@@ -0,0 +1,70 @@
+---
+title: Run Workflow on Canvas
+sidebar:
+ order: 5
+---
+
+import { Steps } from '@astrojs/starlight/components';
+
+You can run any workflow against a raster layer directly from the canvas. The selected layer is passed in as the workflow's image input, and the results land in the canvas staging area where you can review and accept them — without leaving the canvas tab.
+
+## Requirements for a workflow
+
+For a workflow to be available from the canvas, it must satisfy three conditions:
+
+1. **Form Builder is enabled.** The workflow's parameters are presented through the Form Builder UI when the workflow is launched from the canvas, so the workflow needs to have a form configured.
+2. **At least one image input field.** The layer you right-click on is passed into the first eligible image field as the workflow's input.
+3. **At least one `Canvas Output` node.** This is the node that marks which images should be routed back to the canvas staging area.
+
+Workflows that do not meet all three are filtered out of the canvas workflow selector.
+
+## The `Canvas Output` node
+
+`Canvas Output` is a dedicated workflow node that explicitly marks the images you want shown in the canvas staging area. Add it at the end of any branch whose output should appear on the canvas.
+
+A workflow can include **multiple `Canvas Output` nodes**. Each one becomes its own entry in the staging area, with an individually selectable thumbnail. You can navigate between entries with the arrow keys and accept just one of them onto the canvas.
+
+:::note[Why an explicit node?]
+Earlier versions detected output images heuristically (by scanning for `board` fields). That was fragile and caused unrelated nodes — for example, `save_image` — to be mistaken for canvas outputs. `Canvas Output` makes the routing intentional.
+:::
+
+## Running a workflow
+
+
+1. On the canvas, **right-click a raster layer** to open its context menu.
+2. Choose **Run Workflow**.
+3. Pick a workflow from the list. Only workflows that meet the [requirements](#requirements-for-a-workflow) appear here.
+4. Adjust any exposed parameters in the form. All form field types are supported: text, numbers, booleans, enums, schedulers, boards, models, and images.
+5. Click **Run**. The workflow is queued and the results stream into the staging area as they complete.
+
+
+The current layer is automatically passed into the workflow's image input — you do not need to select an image manually.
+
+## Reviewing and accepting results
+
+Results appear in the canvas staging area strip at the bottom of the canvas:
+
+- If the workflow has a single `Canvas Output`, you get one thumbnail per run.
+- If it has multiple `Canvas Output` nodes, each run produces multiple thumbnails, one per output node.
+- Use the staging area's next / previous controls (or arrow keys) to cycle through entries. Navigation wraps across run boundaries.
+- Click **Accept** to commit the currently selected entry onto the canvas. Only that single image is committed — siblings stay in staging until you accept or discard them.
+
+## Troubleshooting
+
+### My workflow doesn't appear in the selector
+
+Check, in order:
+
+- The workflow has Form Builder enabled.
+- The workflow has at least one image input field.
+- The workflow contains at least one `Canvas Output` node.
+
+If any of these is missing, the workflow is hidden.
+
+### Queueing fails with a "BoardField" validation error
+
+This was a known issue with workflows that combined `save_image` and `canvas_output` nodes. It is fixed — update Invoke and try again.
+
+### Errors during execution
+
+Workflow errors are surfaced as toasts and the staging area is cleaned up so it returns to a usable state. Open the queue panel for the full error message.
diff --git a/docs/src/content/docs/features/Canvas/shapes-tool.mdx b/docs/src/content/docs/features/Canvas/shapes-tool.mdx
new file mode 100644
index 00000000000..ba3fb782a07
--- /dev/null
+++ b/docs/src/content/docs/features/Canvas/shapes-tool.mdx
@@ -0,0 +1,99 @@
+---
+title: Shapes Tool
+description: Learn how to draw filled shapes on raster and inpaint mask layers with the Shapes tool.
+lastUpdated: 2026-05-11
+sidebar:
+ order: 1
+---
+
+import { Card, CardGrid } from '@astrojs/starlight/components';
+
+The Shapes tool is a general-purpose filled-shape drawing tool for the canvas. It replaces the old Rectangle tool and
+adds four shape modes under a single toolbar button:
+
+- **Rect**
+- **Oval**
+- **Polygon**
+- **Freehand**
+
+You can activate the Shapes tool from the canvas toolbar or with the default hotkey U.
+
+## Where Shapes Draws
+
+Shapes always draws into the **active raster target**:
+
+- On a regular raster layer, Shapes adds filled pixels to that layer.
+- On an active inpaint mask layer, Shapes draws directly into the mask.
+
+:::note
+Shapes overlaps with some Lasso workflows on mask layers, but the tools are not identical. Lasso is still the more
+specialized masking tool and can create a new mask layer automatically when one does not already exist. See the
+[Lasso tool guide](./lasso-tool/) for mask-specific behavior.
+:::
+
+## Common Behavior
+
+- Shapes preview live while you draw.
+- The fill color uses the current active color.
+- On a raster layer, the active color's alpha is respected when adding pixels.
+- Hold Ctrl on Windows/Linux or Cmd on macOS to switch to **subtractive** mode and cut pixels
+ out of the active layer.
+- In subtractive mode, alpha is ignored and the shape fully clears pixels.
+- Press Esc to cancel the current shape session.
+
+:::tip
+When subtractive mode is active, the canvas cursor shows a small minus badge so you can tell at a glance that the next
+shape will erase instead of fill.
+:::
+
+## Shape Modes
+
+
+
+ Drag to draw a rectangle. Hold Shift to constrain to a square. Hold Alt to draw from the
+ center instead of from a corner.
+
+
+ Drag to draw an ellipse. Hold Shift to constrain to a perfect circle. Hold Alt to draw from
+ the center.
+
+
+ Click to place vertices. Click the first point to close and commit the shape. Hold Shift to snap the
+ pending edge to horizontal, vertical, and 45 degree angles.
+
+
+ Click and drag to sketch a filled freehand contour. Release the pointer to commit the shape.
+
+
+
+## Moving and Panning During Drawing
+
+The Shapes tool supports different Space behavior depending on the current mode:
+
+- **Rect / Oval:** While the pointer is still down, hold Space to move the uncommitted shape instead of
+ resizing it. Release Space to continue resizing.
+- **Polygon / Freehand:** Hold Space during an active session to pan the viewport without discarding the
+ unfinished shape.
+
+This is especially useful when drawing large shapes that extend beyond the current viewport.
+
+## Color Picking While Using Shapes
+
+The Alt key behaves differently depending on the active Shapes mode:
+
+- **Rect / Oval:** Before you start dragging, Alt can be used for the temporary color-picker quick-switch.
+ Once a drag is active, Alt is reserved for drawing from the center.
+- **Polygon:** Alt remains available for the temporary color-picker quick-switch between vertex placements.
+- **Freehand:** Alt is available before the stroke starts, but not during an active stroke.
+
+## Practical Examples
+
+- Use **Rect** or **Oval** to quickly add clean filled regions.
+- Use **Polygon** when you need straight edges and deliberate corner placement.
+- Use **Freehand** for irregular organic regions.
+- Use **subtractive mode** to cut holes back out of an existing filled region.
+
+## Summary
+
+The Shapes tool is the fastest way to add filled geometric or freeform regions to canvas layers. Use it for structured
+fills, mask authoring, and precise subtractive edits without switching away from the current raster target.
diff --git a/docs/src/content/docs/features/Canvas/text-tool.mdx b/docs/src/content/docs/features/Canvas/text-tool.mdx
new file mode 100644
index 00000000000..6e223767d8e
--- /dev/null
+++ b/docs/src/content/docs/features/Canvas/text-tool.mdx
@@ -0,0 +1,33 @@
+---
+title: Text Tool
+sidebar:
+ order: 3
+---
+
+import { LinkCard } from '@astrojs/starlight/components';
+
+## Font selection
+
+The Text tool uses a set of predefined font stacks. When you choose a font, the app resolves the first available font on your system from that stack and uses it for both the editor overlay and the rasterized result. This provides consistent styling across platforms while still falling back to safe system fonts if a preferred font is missing.
+
+## Size and spacing
+
+- **Size** controls the font size in pixels.
+- **Spacing** controls the line height multiplier (Dense, Normal, Spacious). This affects the distance between lines while editing the text.
+
+## Uncommitted state
+
+While text is uncommitted, it remains editable on-canvas. Access to other tools is blocked. Switching to other tabs (Generate, Upascaling, Workflows etc.) discards the text. The uncommitted box can be moved and rotated:
+
+- **Move:** Hold Ctrl (Windows/Linux) or Command (macOS) and drag to move the text box.
+- **Rotate:** Drag the rotation handle above the box. Hold **Shift** while rotating to snap to 15 degree increments.
+
+The text is committed to a raster layer when you press **Enter**. Press **Esc** to discard the current text session.
+
+## For Developers
+
+
diff --git a/docs/src/content/docs/features/External Models/alibabacloud.mdx b/docs/src/content/docs/features/External Models/alibabacloud.mdx
new file mode 100644
index 00000000000..0809b60442d
--- /dev/null
+++ b/docs/src/content/docs/features/External Models/alibabacloud.mdx
@@ -0,0 +1,54 @@
+---
+title: Alibaba Cloud DashScope
+---
+
+import { Steps } from '@astrojs/starlight/components'
+
+Invoke supports Alibaba Cloud's **DashScope** image generation service, giving access to the **Qwen Image** family and **Wan 2.6** text-to-image. Qwen Image is particularly strong at bilingual (Chinese / English) text rendering.
+
+## Getting an API Key
+
+
+1. Sign in to [Alibaba Cloud Model Studio](https://www.alibabacloud.com/en/product/modelstudio) (the international DashScope portal).
+2. Enable **DashScope** and activate the image generation models you plan to use.
+3. Create an API key from the **API Keys** section of the console.
+
+
+## Configuration
+
+Add your key to `api_keys.yaml` in your Invoke root directory:
+
+```yaml
+external_alibabacloud_api_key: "your-dashscope-api-key"
+
+# Optional — default is the international endpoint. Use the China endpoint if your account lives there:
+# https://dashscope.aliyuncs.com
+external_alibabacloud_base_url: "https://dashscope-intl.aliyuncs.com"
+```
+
+Restart Invoke for the change to take effect.
+
+:::note[International vs. China endpoints]
+DashScope has separate international (`dashscope-intl.aliyuncs.com`) and China (`dashscope.aliyuncs.com`) deployments. Your API key only works on the deployment it was issued on — if you get authentication errors, check that `external_alibabacloud_base_url` matches.
+:::
+
+## Available Models
+
+| Model | Modes | Aspect Ratios | Batch | Notes |
+| --- | --- | --- | --- | --- |
+| **Qwen Image 2.0 Pro** | txt2img | 1:1, 4:3, 3:4, 16:9, 9:16 | up to 4 | Best quality, 2K output, excellent bilingual text. |
+| **Qwen Image 2.0** | txt2img | 1:1, 4:3, 3:4, 16:9, 9:16 | up to 4 | Faster / cheaper 2K sibling of 2.0 Pro. |
+| **Qwen Image Max** | txt2img | 1:1, 4:3, 3:4, 16:9, 9:16 | up to 4 | High quality at ~1.3K native size. |
+| **Qwen Image Edit Max** | txt2img (with reference images) | 1:1, 4:3, 3:4, 16:9, 9:16 | up to 4 | Reference-image-driven generation with industrial / geometric reasoning. Accepts up to 14 reference images. |
+| **Wan 2.6 Text-to-Image** | txt2img | 1:1, 4:3, 3:4, 16:9, 9:16 | up to 4 | Photorealistic T2I at 1K. |
+
+All models support **seed**. Negative prompts are not currently plumbed through to DashScope, so the negative prompt input is ignored for these providers. None of the Alibaba Cloud models support img2img (denoising-strength edits) or inpaint (mask-based edits) in Invoke today.
+
+## Tips
+
+
+1. Bilingual prompts. Qwen Image is unusually good at rendering Chinese text and mixed-language prompts — it's a strong choice when your prompt or desired output contains non-Latin script.
+2. Reference-image input is only accepted by Qwen Image Edit Max — provide images via the reference-images panel. Masks and denoising strength are not supported for any Alibaba Cloud model.
+3. Batching is capped at 4 images per request. Larger batches are split across multiple API calls.
+4. Costs vary per model — Qwen Image 2.0 Pro is the most expensive, Qwen Image 2.0 the cheapest of the 2.0 family. Check Alibaba Cloud's pricing page before running large batches.
+
diff --git a/docs/src/content/docs/features/External Models/gemini.mdx b/docs/src/content/docs/features/External Models/gemini.mdx
new file mode 100644
index 00000000000..53067376488
--- /dev/null
+++ b/docs/src/content/docs/features/External Models/gemini.mdx
@@ -0,0 +1,48 @@
+---
+title: Google Gemini
+---
+
+import { Steps } from '@astrojs/starlight/components'
+
+Invoke supports Google's Gemini image generation models through the Gemini API. This provider is a good fit if you want high-quality text-to-image and reference-based image edits without running a local model.
+
+## Getting an API Key
+
+
+1. Open [Google AI Studio](https://aistudio.google.com/) and sign in with your Google account.
+2. Generate a new API key.
+3. Note the key — it will only be shown once.
+
+
+## Configuration
+
+Add your key to `api_keys.yaml` in your Invoke root directory:
+
+```yaml
+external_gemini_api_key: "your-gemini-api-key"
+
+# Optional — only set this if you need to route requests through a different endpoint
+external_gemini_base_url: "https://generativelanguage.googleapis.com"
+```
+
+Restart Invoke for the change to take effect.
+
+## Available Models
+
+| Model | Modes | Reference Images | Notes |
+| --- | --- | --- | --- |
+| **Gemini 2.5 Flash Image** | txt2img | Yes | 10 aspect ratios, fixed per-ratio resolutions. |
+| **Gemini 3 Pro Image Preview** | txt2img | Up to 14 (6 object + 5 character) | 1K / 2K / 4K resolution presets. |
+| **Gemini 3.1 Flash Image Preview** | txt2img | Up to 14 (10 object + 4 character) | 512 / 1K / 2K / 4K resolution presets. |
+
+Reference-image input is used to condition generation but counts as txt2img — neither img2img (denoising strength) nor inpaint (mask) is supported for Gemini.
+
+All Gemini models are single-image-per-request — batch size is fixed at 1. To generate multiple variations, queue multiple invocations.
+
+## Tips
+
+
+1. Reference images are sent directly to the API as inlined PNG data. Large references increase request latency and cost — crop tightly where possible.
+2. Aspect ratios are mapped to the closest Gemini-supported ratio. For Gemini 3 models, use the resolution presets to stay at the provider's native output sizes and avoid unnecessary rescaling.
+3. Pricing varies by model and region. Check Google's documentation before running large batches.
+
diff --git a/docs/src/content/docs/features/External Models/index.mdx b/docs/src/content/docs/features/External Models/index.mdx
new file mode 100644
index 00000000000..358b68fe68e
--- /dev/null
+++ b/docs/src/content/docs/features/External Models/index.mdx
@@ -0,0 +1,58 @@
+---
+title: External Models
+---
+
+External models let you generate images in Invoke by calling third-party image generation APIs instead of running a model locally. This is useful when:
+
+- You don't have the GPU or VRAM to run a model locally.
+- You want access to closed-source models (e.g. GPT Image, Gemini).
+- You need a specific provider capability (very high resolutions, fast batches, bilingual text rendering, etc.).
+
+External models appear in the model picker alongside locally installed models. Generations are routed to the provider's API, billed against your provider account, and the resulting images are imported back into Invoke like any other generation.
+
+## Supported Providers
+
+- [Google Gemini](/features/external-models/gemini/) — Gemini 2.5 Flash Image, Gemini 3 Pro Image Preview, Gemini 3.1 Flash Image Preview
+- [OpenAI](/features/external-models/openai/) — GPT Image 1 / 1.5 / 1-mini, DALL·E 3
+- [BytePlus Seedream](/features/external-models/seedream/) — Seedream 5.0, 5.0 Lite, 4.5, 4.0
+- [Alibaba Cloud DashScope](/features/external-models/alibabacloud/) — Qwen Image 2.0 / 2.0 Pro / Max / Edit Max, Wan 2.6 T2I
+
+## Configuring API Keys
+
+External provider credentials are stored in a dedicated `api_keys.yaml` file alongside `invokeai.yaml` in your Invoke root directory.
+
+```yaml
+# api_keys.yaml
+external_gemini_api_key: "your-gemini-api-key"
+external_openai_api_key: "your-openai-api-key"
+
+# Optional: override the provider base URL (e.g. for a compatible proxy or regional endpoint)
+external_gemini_base_url: "https://generativelanguage.googleapis.com"
+external_openai_base_url: "https://api.openai.com"
+```
+
+Restart Invoke after editing `api_keys.yaml` so the new values are picked up.
+
+!!! warning "Keep your keys private"
+ `api_keys.yaml` contains secrets. Do not commit it to version control and do not share it with other users of your machine.
+
+## Installing External Models
+
+External models are listed in the starter models dialog under their provider. Install them like any other starter model — Invoke records a model reference but does not download weights (there are no weights to download).
+
+Once installed, external models show up everywhere a model can be selected. Choose one, set the usual parameters (prompt, dimensions, num images, etc.), and invoke as normal.
+
+## Capabilities and Settings Visibility
+
+Each external model declares its own **capabilities** — for example:
+
+- Which generation modes it supports (`txt2img`, `img2img`). Inpainting is not currently supported by any external provider.
+- Whether it accepts reference images, and how many.
+- Which aspect ratios and resolutions it allows.
+- Whether it supports a negative prompt, seed, or batch size > 1.
+
+Invoke uses these capabilities to drive the UI: only the settings a given model actually supports will be shown in the parameters panel. If a field you expect is missing, it's because the selected model does not support it.
+
+## Costs and Rate Limits
+
+External providers charge for each request. Check the provider's pricing page before running large batches. Rate-limit errors from the provider are surfaced in Invoke as generation failures — wait a moment and try again, or lower your concurrent batch size.
diff --git a/docs/src/content/docs/features/External Models/openai.mdx b/docs/src/content/docs/features/External Models/openai.mdx
new file mode 100644
index 00000000000..2ee4628ebd3
--- /dev/null
+++ b/docs/src/content/docs/features/External Models/openai.mdx
@@ -0,0 +1,65 @@
+---
+title: OpenAI
+---
+
+import { Steps } from '@astrojs/starlight/components'
+
+Invoke supports OpenAI's image generation models — the GPT Image family and DALL·E 3 — through the OpenAI API.
+
+:::note[DALL·E 2 removed]
+DALL·E 2 was deprecated by OpenAI and is scheduled for shutdown on 2026-05-12. It is no longer offered as a starter model in Invoke.
+:::
+
+## Getting an API Key
+
+
+1. Open the [OpenAI API Platform](https://platform.openai.com/api-keys) and sign in.
+2. Create a new secret API key.
+3. Make sure your account has billing set up — image endpoints are paid per request.
+
+
+## Configuration
+
+Add your key to `api_keys.yaml` in your Invoke root directory:
+
+```yaml
+external_openai_api_key: "sk-..."
+
+# Optional — use this to point at a compatible proxy or Azure OpenAI deployment
+external_openai_base_url: "https://api.openai.com"
+```
+
+Restart Invoke for the change to take effect.
+
+## Available Models
+
+| Model | Modes | Aspect Ratios | Batch | Notes |
+| --- | --- | --- | --- | --- |
+| **GPT Image 1.5** | txt2img, img2img | 1:1, 3:2, 2:3 | up to 10 | Fastest and cheapest GPT Image model. |
+| **GPT Image 1** | txt2img, img2img | 1:1, 3:2, 2:3 | up to 10 | Highest quality of the GPT Image family. |
+| **GPT Image 1 Mini** | txt2img, img2img | 1:1, 3:2, 2:3 | up to 10 | ~80% cheaper than GPT Image 1. |
+| **DALL·E 3** | txt2img only | 1:1, 7:4, 4:7 | 1 | No reference-image / edit support. |
+
+Inpainting (mask-based editing) is not currently supported for any OpenAI model in Invoke. img2img on the GPT Image family routes through the `/v1/images/edits` endpoint without a mask.
+
+## Provider-Specific Options
+
+For **GPT Image** models, Invoke surfaces two provider-specific options in the parameters panel:
+
+- **Quality** — `low`, `medium`, `high`, or `auto`. Higher quality costs more and takes longer.
+- **Background** — `auto`, `transparent`, or `opaque`. Use `transparent` for PNG output with an alpha channel.
+
+DALL·E 2 and DALL·E 3 do not expose these options.
+
+## How Requests Are Routed
+
+- Pure text-to-image requests hit `/v1/images/generations`.
+- Any request with an init image or reference images is sent to `/v1/images/edits` instead. This is done transparently — you don't need to pick an endpoint.
+
+## Tips
+
+
+1. Batching on GPT Image tops out at 10 per request. Larger batches are split into multiple API calls.
+2. Costs can climb quickly with high-quality GPT Image generations. Start with GPT Image 1 Mini when iterating on prompts.
+3. Rate limits from OpenAI surface as failed invocations — retry after a short wait.
+
diff --git a/docs/src/content/docs/features/External Models/seedream.mdx b/docs/src/content/docs/features/External Models/seedream.mdx
new file mode 100644
index 00000000000..de25273d289
--- /dev/null
+++ b/docs/src/content/docs/features/External Models/seedream.mdx
@@ -0,0 +1,68 @@
+---
+title: BytePlus Seedream
+---
+
+import { Steps } from '@astrojs/starlight/components'
+
+Invoke supports BytePlus's **Seedream** image generation family through the BytePlus Ark API. Seedream is a strong fit for 2K/4K generations and multi-reference image composition.
+
+## Getting an API Key
+
+
+1. Open the [BytePlus Console](https://console.byteplus.com/) and sign in.
+2. Enable the **Ark** (model serving) product.
+3. Create an API key with access to the Seedream models you plan to use.
+
+
+## Configuration
+
+Add your key to `api_keys.yaml` in your Invoke root directory:
+
+```yaml
+external_seedream_api_key: "your-seedream-api-key"
+
+# Optional — change only if you need a different regional endpoint
+external_seedream_base_url: "https://ark.ap-southeast.bytepluses.com"
+```
+
+Restart Invoke for the change to take effect.
+
+## Available Models
+
+| Model | Modes | Reference Images | Batch | Native Size |
+| --- | --- | --- | --- | --- |
+| **Seedream 5.0** | txt2img, img2img | up to 14 | up to 15 | 2K |
+| **Seedream 5.0 Lite** | txt2img, img2img | up to 14 | up to 15 | 2K |
+| **Seedream 4.5** | txt2img, img2img | up to 14 | up to 15 | 2K |
+| **Seedream 4.0** | txt2img, img2img | up to 14 | up to 15 | 2K |
+
+The 4.x / 5.x models are batch-capable and accept up to 14 reference images per request.
+
+:::note[Model IDs]
+BytePlus uses date-stamped model IDs (e.g. `seedream-5-0-260128`). When BytePlus releases a new dated revision, the starter model IDs in Invoke need to be updated. Seedream 3.0 T2I (`seedream-3-0-t2i-250415`) was deprecated by BytePlus and replaced by Seedream 4.0.
+:::
+
+### Supported Aspect Ratios
+
+All Seedream models share the same aspect ratio set: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `9:16`, `16:9`, `21:9`, rendered at 2K.
+
+## Provider-Specific Options
+
+Seedream exposes two provider-specific toggles in the parameters panel:
+
+- **Watermark** — When enabled, BytePlus adds a small watermark to the output. Off by default.
+- **Optimize Prompt** — When enabled, BytePlus rewrites your prompt server-side for better generation quality. Useful for short prompts; disable if you want the exact wording preserved.
+
+**Seed** and **guidance scale** are not accepted by the 4.x / 5.x family.
+
+## Reference Images
+
+4.x and 5.x Seedream models accept up to 14 reference images alongside the prompt. Invoke's standard reference-image panel is used — drag images in, and they are forwarded as base64 PNGs to the API.
+
+## Tips
+
+
+1. For multi-image composition (e.g. character + product), Seedream 4.5 is a good default.
+2. When running large batches (`num_images > 1` on 4.x / 5.x), Invoke uses the `sequential_image_generation` API flag — each image is returned as it completes.
+3. Set `external_seedream_base_url` if you need to route through a region-specific Ark endpoint.
+
diff --git a/docs/src/content/docs/features/Multi-User Mode/admin-guide.mdx b/docs/src/content/docs/features/Multi-User Mode/admin-guide.mdx
new file mode 100644
index 00000000000..bcef946fb3c
--- /dev/null
+++ b/docs/src/content/docs/features/Multi-User Mode/admin-guide.mdx
@@ -0,0 +1,642 @@
+---
+title: Multi-User Administrator Guide
+description: How to set up and manage a multi-user InvokeAI installation.
+sidebar:
+ order: 4
+---
+
+import { Steps } from '@astrojs/starlight/components'
+
+## Overview
+
+This guide is for administrators managing a multi-user InvokeAI
+installation. It covers initial setup, user management, security best
+practices, and troubleshooting.
+
+## Prerequisites
+
+Before enabling multi-user support, ensure you have:
+
+- InvokeAI installed and running
+- Access to the server filesystem (for initial setup)
+- Understanding of your deployment environment
+- Backup of your existing data (recommended)
+
+## Initial Setup
+
+### Activating Multiuser Mode
+
+To put InvokeAI into multiuser mode, you will need to add the option `multiuser: true` to its configuration file. This file is located at `INVOKEAI_ROOT/invokeai.yaml`. With the InvokeAI backend halted, add the new configuration option to the end of the file with a text editor so that it looks like this:
+
+```yaml
+# Internal metadata - do not edit:
+schema_version: 4.0.2
+
+# Enable/disable multi-user mode
+multiuser: true
+```
+
+Then restart the InvokeAI server backend from the command line or using the launcher.
+
+:::note[Reverting to single-user mode]
+If at any time you wish to revert to single-user mode, simply comment out the `multiuser` line, or change "true" to "false". Then restart the server. Because of the way that browsers cache pages, users with open InvokeAI sessions may need to force-refresh their browsers.
+:::
+
+### First Administrator Account
+
+When InvokeAI starts for the first time in multi-user mode, you'll see the **Administrator Setup** dialog.
+
+**Setup Steps:**
+
+
+1. **Email Address**: Enter a valid email address (this becomes your username)
+
+ - Example: `admin@example.com` or `admin@localhost` for testing
+ - Must be a valid email format
+ - Cannot be changed later without database access
+
+2. **Display Name**: Enter a friendly name
+
+ - Example: "System Administrator" or your real name
+ - Can be changed later in your profile
+ - Visible to other users in shared contexts
+
+3. **Password**: Create a strong administrator password
+
+ - **Minimum requirements:**
+
+ - At least 8 characters long
+ - Contains uppercase letters (A-Z)
+ - Contains lowercase letters (a-z)
+ - Contains numbers (0-9)
+
+ - **Recommended:**
+
+ - Use 12+ characters
+ - Include special characters (!@#$%^&*)
+ - Use a password manager to generate and store
+ - Don't reuse passwords from other services
+
+4. **Confirm Password**: Re-enter the password
+
+5. Click **Create Administrator Account**
+
+
+:::caution[Important]
+Store these credentials securely! The first administrator account can reset the password to something new, but cannot retrieve a lost one.
+:::
+
+### Configuration
+
+InvokeAI can run in single-user or multi-user mode, controlled by the `multiuser` configuration option in `invokeai.yaml`:
+
+```yaml
+# Enable/disable multi-user mode
+multiuser: true # Enable multi-user mode (requires authentication)
+
+# Optional password policy
+strict_password_checking: true # Enforce uppercase/lowercase/number requirements
+```
+
+JWT secrets are generated automatically and stored in the database. Session lifetimes default to 24 hours, or 7 days when the user selects "Remember me". See Secret Key Management below if you need to rotate the JWT secret.
+
+:::caution[Mode Switching Behavior]
+**Switching to Single-User Mode:** If boards or images were created in multi-user mode, they will all be combined into a single unified view when switching to single-user mode.
+
+**Switching to Multi-User Mode:** Legacy boards and images created under single-user mode will be owned by an internal user named "system." Only the Administrator will have access to these legacy assets. A utility to migrate these legacy assets to another user will be part of a future release.
+:::
+
+### Migration from Single-User
+
+When upgrading from a single-user installation or switching modes:
+
+
+1. **Automatic Migration**: The database will automatically migrate to multi-user schema when multi-user mode is first enabled
+2. **Legacy Data Ownership**: Existing data (boards, images, workflows) created in single-user mode is assigned to an internal user named "system"
+3. **Administrator Access**: Only administrators will have access to legacy "system"-owned assets when in multi-user mode
+4. **No Data Loss**: All existing content is preserved
+
+
+**Migration Process:**
+
+```bash
+# Backup your database first
+cp databases/invokeai.db databases/invokeai.db.backup
+
+# Enable multi-user mode in invokeai.yaml
+# multiuser: true
+
+# Start InvokeAI (migration happens automatically)
+invokeai-web
+
+# Complete the administrator setup dialog
+# Legacy data will be owned by "system" user
+```
+
+:::note[Legacy Asset Migration]
+A utility to migrate legacy "system"-owned assets to specific user accounts will be available in a future release. Until then, administrators can access and manage all legacy content.
+:::
+
+## User Management
+
+### Creating Users
+
+Administrators can create and modify users (including other
+administrators) via a built-in web interface or using command-line
+scripts.
+
+#### **Via the Web Frontend:**
+
+Please see the Multi-User Guide's section on [Adding and Modifying Users](./user-guide#adding-and-modifying-users)
+for a walk-through.
+
+#### **Via Command Line Scripts:**
+
+##### Command-line User Management Scripts
+
+Administrators can also use a series of command-line scripts to add, modify, or delete users. If you use the launcher, click the ">" icon to enter the command-line interface. Otherwise, if you are a native command-line user, activate the InvokeAI environment from your terminal.
+
+All command-line arguments are optional. The scripts will prompt you to provide any missing arguments.
+
+The commands are:
+
+| Name | Function | Example CLI Usage |
+|--------------------|---------------|--------------------|
+|**invoke-useradd** | add a user | `invoke-useradd --email user@example.com --name "Example User" --password "badpassword"` |
+|**invoke-usermod** | modify a user | `invoke-usermod --email user@example.com --name "Mr. Example User" --password "8adsf2**%"` |
+|**invoke-userdel** | delete a user | `invoke-userdel --email user@example.com --force` |
+|**invoke-userlist** | list all users| `invoke-userlist` |
+
+Pass the `--help` argument to get the usage of each script. For example:
+
+```bash
+> invoke-useradd --help
+usage: invoke-useradd [-h] [--root ROOT] [--email EMAIL] [--password PASSWORD] [--name NAME] [--admin]
+
+Add a user to the InvokeAI database
+
+options:
+ -h, --help show this help message and exit
+ --root ROOT, -r ROOT Path to the InvokeAI root directory. If omitted, the root is resolved in this order: the $INVOKEAI_ROOT environment
+ variable, the active virtual environment's parent directory, or $HOME/invokeai.
+ --email EMAIL, -e EMAIL
+ User email address
+ --password PASSWORD, -p PASSWORD
+ User password
+ --name NAME, -n NAME User display name (optional)
+ --admin, -a Make user an administrator
+
+If no arguments are provided, the script will run in interactive mode.
+```
+
+:::danger[Data Loss]
+Deleting a user removes the user record and cascades to their sessions, board shares, sent
+invitations, and per-user client state. It does **not** delete the boards, images, workflows, queue
+items, or style presets they created — those rows remain in the database, owned by a user_id that no
+longer exists, and will not appear in any user's gallery. Physical image files in `outputs/images`
+are also left in place until a gallery maintenance script is run to remove orphan images.
+
+If you want their content gone as well, reassign or delete it before deleting the user. Back up the
+database first if recovery might be needed.
+:::
+
+### Viewing User Activity
+
+**Queue Management:**
+
+There is no separate admin-only queue view. When signed in as an administrator, the regular queue
+panel automatically shows every user's queue items (each item is labelled with the submitting user's
+display name or email), and you can cancel or clear any of them. There is no built-in UI to filter
+the queue by user; use your browser's find-in-page to scan by name if needed.
+
+## Model Management
+
+As an administrator, you have full access to the [Model
+Manager](/concepts/models) and can install, edit and delete
+models just as in single-user mode. Unprivileged users, however, can
+view the models previously installed, but cannot add or modify them.
+
+## Security
+
+:::note[Strict Password Checking]
+It is recommended that you enable strict password checking. This will
+force all users to select good passwords that follow the
+"minimal requirements" below. Do this by adding `strict_password_checking` to
+the `invokeai.yaml` configuration file:
+
+```
+strict_password_checking: true
+```
+:::
+
+### Password Policies
+
+**Minimal Requirements:**
+
+- Minimum 8 characters
+- Must contain uppercase letters
+- Must contain lowercase letters
+- Must contain numbers
+
+If `strict_password_checking` is active (recommended), then these
+minimal requirements will be enforced and users will not be able to
+proceed until they have picked a password that satisfies
+them. Otherwise, the user will simply be warned when they use a weak
+password.
+
+**Recommended Policies:**
+
+- Require 12+ character passwords
+- Include special characters
+- Implement password rotation every 90 days
+- Prevent password reuse
+
+### Session Management
+
+**Session Security and Token Management:**
+
+This system uses stateless JWT tokens with HMAC signatures to identify users after they provide their initial credentials. The tokens will persist for 24 hours by default, or for 7 days if the user clicks the "Remember me" checkbox at login. Expired tokens are automatically rejected and the user will have to log in again.
+
+At the client side, tokens are stored in browser localStorage. Logging out clears them. No server-side session storage is required.
+
+The tokens include the user's ID, email, and admin status, along with an HMAC signature.
+
+### Secret Key Management
+
+**Important:** The JWT secret key must be kept confidential.
+
+To generate tokens, each InvokeAI instance has a distinct secret JWT
+key that must be kept confidential. The key is stored in the
+`app_settings` table of the InvokeAI database within a field value
+named `jwt_secret`.
+
+The secret key is automatically generated during database creation or
+migration. If you wish to change the key, you may generate a
+replacement using either of these commands:
+
+```bash
+# Python
+python -c "import secrets; print(secrets.token_urlsafe(32))"
+
+# OpenSSL
+openssl rand -base64 32
+```
+
+Then cut and paste the printed secret into this Sqlite3 command:
+
+```bash
+sqlite3 INVOKE_ROOT/databases/invokeai.db 'update app_settings set value="THE_SECRET" where key="jwt_secret"'
+```
+
+(replace INVOKE_ROOT with your InvokeAI root directory and THE_SECRET with the new secret).
+
+After this, restart the server. All logged in users will be logged out and will need to provide their usernames and passwords again.
+
+### Hosting a Shared InvokeAI Instance
+
+The multiuser feature allows you to run an InvokeAI backend that can be accessed by your friends and family across your home network. It is also possible to host a backend that is accessible over the Internet.
+
+By default, InvokeAI runs on `localhost`, IP address `127.0.0.1`, which is only accessible to browsers running on the same machine as the backend. To make the backend accessible to any machine on your home or work LAN, add the line `host: 0.0.0.0` to the InvokeAI configuration file, usually stored at `INVOKE_ROOT/invokeai.yaml`.
+
+Here is a minimal example.
+
+```yaml
+# Internal metadata - do not edit:
+schema_version: 4.0.2
+
+# Put user settings here - see https://invoke-ai.github.io/InvokeAI/configuration/:
+multiuser: true
+host: 0.0.0.0
+```
+
+After relaunching the backend you will be able to reach the server from other machines on the LAN using the server machine's IP address or hostname and port 9090.
+
+#### Making InvokeAI Accessible to the Internet
+
+:::danger[Use at your own risk]
+The InvokeAI team has done its best to make the software free of exploitable bugs, but the software has not undergone a rigorous security audit or intrusion testing. Use at your own risk.
+:::
+
+It is also possible to create a (semi) public server accessible from the Internet. The details of how to do this depend very much on your home or corporate router/firewall system and are beyond the scope of this document.
+
+If you expose InvokeAI to the Internet, there are a number of precautions to take. Here is a brief list of recommended network security practices.
+
+**HTTPS Configuration:**
+
+For internet deployments, always use HTTPS:
+
+```nginx
+# Use a reverse proxy like nginx or Traefik
+# Example nginx configuration:
+
+server {
+ listen 443 ssl http2;
+ server_name invoke.example.com;
+
+ ssl_certificate /path/to/cert.pem;
+ ssl_certificate_key /path/to/key.pem;
+
+ location / {
+ proxy_pass http://localhost:9090;
+ proxy_set_header Host $host;
+ proxy_set_header X-Real-IP $remote_addr;
+ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+ proxy_set_header X-Forwarded-Proto $scheme;
+
+ # WebSocket support
+ proxy_http_version 1.1;
+ proxy_set_header Upgrade $http_upgrade;
+ proxy_set_header Connection "upgrade";
+ }
+}
+```
+
+**Firewall Rules:**
+
+It is best to restrict access to trusted networks and remote IP addresses, or use a VPN to connect to your home network. Rate limit connections to InvokeAI's authentication endpoint `http://your.host:9090/api/v1/auth/login`.
+
+**Backup and Recovery:**
+
+It is always a good idea to periodically backup your InvokeAI database and images, but especially
+so if the server is publicly accessible to the Internet.
+
+**Manual Backup:**
+
+```bash
+# Stop InvokeAI
+# Copy database file
+cd INVOKE_ROOT
+cp databases/invokeai.db databases/invokeai.db.$(date +%Y%m%d)
+
+# Or create compressed backup
+tar -czf invokeai_backup_$(date +%Y%m%d).tar.gz databases/
+```
+
+**Automated Backup Script:**
+
+```bash
+#!/bin/bash
+# backup_invokeai.sh
+
+INVOKE_ROOT="/path/to/invoke_root"
+BACKUP_DIR="/path/to/backups"
+DB_PATH="$INVOKE_ROOT/databases/invokeai.db"
+DATE=$(date +%Y%m%d_%H%M%S)
+
+# Create backup directory
+mkdir -p "$BACKUP_DIR"
+
+# Copy database
+cp "$DB_PATH" "$BACKUP_DIR/invokeai_$DATE.db"
+
+# Keep only last 30 days
+find "$BACKUP_DIR" -name "invokeai_*.db" -mtime +30 -delete
+
+echo "Backup completed: invokeai_$DATE.db"
+```
+
+**Schedule with cron:**
+
+```bash
+# Edit crontab
+crontab -e
+
+# Add daily backup at 2 AM
+0 2 * * * /path/to/backup_invokeai.sh
+```
+
+**Restore from Backup:**
+
+```bash
+# Stop InvokeAI
+# Replace current database with backup
+cd INVOKE_ROOT
+cp databases/invokeai.db databases/invokeai.db.old # Save current
+cp databases/invokeai_backup.db databases/invokeai.db
+
+# Restart InvokeAI
+invokeai-web
+```
+
+**Disaster Recovery — Complete System Backup:**
+
+Include these directories/files:
+
+- `databases/` — All database files
+- `models/` — Installed models (if locally stored)
+- `outputs/` — Generated images
+- `invokeai.yaml` — Configuration file
+- Any custom scripts or modifications
+
+**Recovery Process:**
+
+
+1. Install InvokeAI on new system
+2. Restore configuration file
+3. Restore database directory
+4. Restore models and outputs
+5. Verify file permissions
+6. Start InvokeAI and test
+
+
+## Troubleshooting
+
+### User Cannot Login
+
+**Symptom:** User reports unable to log in
+
+**Diagnosis:**
+
+1. Verify account exists and is active
+
+ ```bash
+ sqlite3 databases/invokeai.db "SELECT * FROM users WHERE email = 'user@example.com';"
+ ```
+
+2. Check password (have user try resetting)
+3. Verify account is active (`is_active = 1`)
+4. Check for account lockout (if implemented)
+
+**Solutions:**
+
+- Reset user password
+- Reactivate disabled account
+- Verify email address is correct
+- Check system logs for auth errors
+
+### Database Locked Errors
+
+**Symptom:** "Database is locked" errors
+
+**Causes:**
+
+- Concurrent write operations
+- Long-running transactions
+- Backup process accessing database
+- File system issues
+
+**Solutions:**
+
+```bash
+# Check for locks
+fuser databases/invokeai.db
+
+# Increase timeout (in config)
+# Or switch to WAL mode:
+sqlite3 databases/invokeai.db "PRAGMA journal_mode=WAL;"
+```
+
+### Forgotten Admin Password
+
+**Recovery Process:**
+
+
+1. Stop InvokeAI
+2. Direct database access:
+
+ ```bash
+ sqlite3 databases/invokeai.db
+ ```
+
+3. Reset admin password (requires password hash):
+
+ ```sql
+ -- Generate hash first using Python:
+ -- from passlib.context import CryptContext
+ -- pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+ -- print(pwd_context.hash("NewPassword123"))
+
+ UPDATE users
+ SET password_hash = '$2b$12$...'
+ WHERE email = 'admin@example.com';
+ ```
+
+4. Restart InvokeAI
+
+
+:::note[Alternative Step 3]
+Remove the admin from the database entirely in order
+to trigger the setup process when InvokeAI restarts:
+
+```sql
+DELETE FROM users
+WHERE email = 'admin@example.com';
+```
+:::
+
+
+### Performance Issues
+
+**Symptom:** Slow generation or UI
+
+**Diagnosis:**
+
+
+1. Check active generation count
+2. Review resource usage (CPU/GPU/RAM)
+3. Check database size and performance
+4. Review network latency
+
+
+**Solutions:**
+
+- Limit concurrent generations
+- Increase hardware resources
+- Optimize database (`VACUUM`, `ANALYZE`)
+- Add indexes for slow queries
+- Consider load balancing
+
+### Migration Failures
+
+**Symptom:** Database migration fails on upgrade
+
+**Prevention:**
+
+- Always backup before upgrading
+- Test migration on copy of database
+- Review migration logs
+
+**Recovery:**
+
+```bash
+# Restore backup
+cp databases/invokeai.db.backup databases/invokeai.db
+
+# Try migration again with verbose logging
+invokeai-web --log-level DEBUG
+```
+
+## Configuration Reference
+
+### Complete Configuration Example for a Public Site
+
+```yaml
+# invokeai.yaml - Multi-user configuration
+
+# Internal metadata - do not edit:
+schema_version: 4.0.2
+
+# Put user settings here
+multiuser: true
+
+# Server
+host: "0.0.0.0"
+port: 9090
+
+# Performance
+enable_partial_loading: true
+precision: float16
+pytorch_cuda_alloc_conf: "backend:cudaMallocAsync"
+hashing_algorithm: blake3_multi
+```
+
+## Frequently Asked Questions
+
+### How many users can InvokeAI support?
+
+The backend will support dozens of concurrent users. However, because the image generation queue is single-threaded, image generation tasks are processed on a first-come, first-serve basis. This means that a user may have to wait for all the other users' image generation jobs to complete before their generation job starts to execute.
+
+A future version of InvokeAI may support concurrent execution on systems with multiple GPUs/graphics cards.
+
+### Can I integrate with existing authentication systems?
+
+OAuth2/OpenID Connect support is planned for a future release. Currently, InvokeAI uses its own authentication system.
+
+### How do I audit user actions?
+
+Full audit logging is planned for a future release. Currently, you can:
+
+- Monitor the generation queue
+- Review database changes
+- Check application logs
+
+### Can users have different model access?
+
+Currently all users can view and use all installed models. Per-user
+model access is a possible enhancement. Please let the development
+team know if you want this feature.
+
+### How do I handle user data when they leave?
+
+Best practice:
+
+
+1. Deactivate the account first
+2. Transfer ownership of shared boards
+3. After transition period, delete the account
+4. Or keep the account deactivated for audit purposes
+
+
+### What's the licensing impact of multi-user mode?
+
+InvokeAI remains under its existing license. Multi-user mode does not change licensing terms.
+
+## Getting Help
+
+### Support
+
+- **General Documentation**: [InvokeAI Docs](https://invoke.ai/)
+- **User Guide**: [For Users](/features/multi-user-mode/user-guide/)
+- **API Guide**: [For Developers](/features/multi-user-mode/api-guide/)
+- **Discord**: [Join Community](https://discord.gg/ZmtBAhwWhy)
+- **GitHub Issues**: [Report Problems](https://github.com/invoke-ai/InvokeAI/issues)
diff --git a/docs/src/content/docs/features/Multi-User Mode/api-guide.mdx b/docs/src/content/docs/features/Multi-User Mode/api-guide.mdx
new file mode 100644
index 00000000000..36083388daf
--- /dev/null
+++ b/docs/src/content/docs/features/Multi-User Mode/api-guide.mdx
@@ -0,0 +1,1236 @@
+---
+title: Multi-User API Guide
+description: How to authenticate and interact with the InvokeAI API in multi-user mode.
+sidebar:
+ order: 5
+---
+import { Steps } from '@astrojs/starlight/components'
+
+## Overview
+
+This guide explains how to interact with InvokeAI's API in both single-user and multi-user modes. The API behavior depends on the `multiuser` configuration setting.
+
+### Single-User vs Multi-User Mode
+
+**Single-User Mode** (`multiuser: false` or option absent):
+
+- No authentication required
+- All API endpoints accessible without tokens
+- Direct API access like previous InvokeAI versions
+- All content visible in unified view
+
+**Multi-User Mode** (`multiuser: true`):
+
+- JWT token authentication required
+- User-scoped access to resources
+- Role-based authorization (admin vs regular user)
+- Data isolation between users
+
+## Authentication (Multi-User Mode Only)
+
+### Authentication Flow
+
+When multi-user mode is enabled, most API endpoints require authentication using JWT bearer tokens. The unauthenticated authentication endpoints are `GET /api/v1/auth/status`, `POST /api/v1/auth/setup`, and `POST /api/v1/auth/login`.
+
+**Authentication Process:**
+
+
+1. **Obtain Token**: POST credentials to `/api/v1/auth/login`
+2. **Store Token**: Save the JWT token securely
+3. **Use Token**: Include token in `Authorization` header for all requests
+4. **Refresh**: Re-authenticate when token expires
+
+
+:::note[Single-User Mode]
+When running in single-user mode (`multiuser: false`), authentication endpoints are not available and authentication headers are not required.
+:::
+
+### Login Endpoint
+
+**Endpoint:** `POST /api/v1/auth/login`
+
+**Request:**
+
+```json
+{
+ "email": "user@example.com",
+ "password": "SecurePassword123",
+ "remember_me": false
+}
+```
+
+**Response (Success):**
+
+```json
+{
+ "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+ "user": {
+ "user_id": "abc123",
+ "email": "user@example.com",
+ "display_name": "John Doe",
+ "is_admin": false,
+ "is_active": true,
+ "created_at": "2024-01-15T10:00:00Z",
+ "updated_at": "2024-01-15T10:00:00Z",
+ "last_login_at": "2024-01-15T15:30:00Z"
+ },
+ "expires_in": 86400
+}
+```
+
+**Response (Error):**
+
+```json
+{
+ "detail": "Incorrect email or password"
+}
+```
+
+**Status Codes:**
+
+- `200 OK` — Authentication successful
+- `401 Unauthorized` — Invalid credentials
+- `403 Forbidden` — Account disabled
+- `422 Unprocessable Entity` — Invalid request format
+
+### Using the Token
+
+Include the JWT token in the `Authorization` header with the `Bearer` scheme:
+
+**HTTP Header:**
+
+```
+Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+```
+
+**Example HTTP Request:**
+
+```http
+GET /api/v1/boards HTTP/1.1
+Host: localhost:9090
+Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+Content-Type: application/json
+```
+
+### Token Expiration
+
+Tokens have a limited lifetime:
+
+- **Default**: 24 hours (86400 seconds)
+- **Remember Me**: 7 days (604800 seconds)
+
+**Handling Expiration:**
+
+```python
+import requests
+import time
+
+def api_request(url, token, max_retries=1):
+ headers = {"Authorization": f"Bearer {token}"}
+ response = requests.get(url, headers=headers)
+
+ if response.status_code == 401: # Token expired
+ # Re-authenticate and retry
+ new_token = login()
+ headers = {"Authorization": f"Bearer {new_token}"}
+ response = requests.get(url, headers=headers)
+
+ return response
+```
+
+### Logout Endpoint
+
+**Endpoint:** `POST /api/v1/auth/logout`
+
+**Request:**
+
+```http
+POST /api/v1/auth/logout HTTP/1.1
+Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+```
+
+**Response:**
+
+```json
+{
+ "success": true
+}
+```
+
+**Note:** With JWT tokens, logout is primarily client-side (delete token). Server-side session invalidation may be added in future releases.
+
+## Code Examples
+
+### Python
+
+**Using `requests` library:**
+
+```python
+import requests
+import json
+
+class InvokeAIClient:
+ def __init__(self, base_url="http://localhost:9090"):
+ self.base_url = base_url
+ self.token = None
+
+ def login(self, email, password, remember_me=False):
+ """Authenticate and store token."""
+ url = f"{self.base_url}/api/v1/auth/login"
+ payload = {
+ "email": email,
+ "password": password,
+ "remember_me": remember_me
+ }
+
+ response = requests.post(url, json=payload)
+ response.raise_for_status()
+
+ data = response.json()
+ self.token = data["token"]
+ return data["user"]
+
+ def _get_headers(self):
+ """Get headers with authentication token."""
+ if not self.token:
+ raise Exception("Not authenticated. Call login() first.")
+
+ return {
+ "Authorization": f"Bearer {self.token}",
+ "Content-Type": "application/json"
+ }
+
+ def get_boards(self):
+ """Get user's boards."""
+ url = f"{self.base_url}/api/v1/boards/"
+ response = requests.get(url, headers=self._get_headers())
+ response.raise_for_status()
+ return response.json()
+
+ def create_board(self, board_name):
+ """Create a new board."""
+ url = f"{self.base_url}/api/v1/boards/"
+ response = requests.post(
+ url,
+ params={"board_name": board_name},
+ headers=self._get_headers()
+ )
+ response.raise_for_status()
+ return response.json()
+
+ def logout(self):
+ """Logout and clear token."""
+ url = f"{self.base_url}/api/v1/auth/logout"
+ response = requests.post(url, headers=self._get_headers())
+ self.token = None
+ return response.json()
+
+# Usage
+client = InvokeAIClient()
+user = client.login("user@example.com", "SecurePassword123")
+print(f"Logged in as: {user['display_name']}")
+
+boards = client.get_boards()
+print(f"User has {len(boards['items'])} boards")
+
+new_board = client.create_board("My New Board")
+print(f"Created board: {new_board['board_name']}")
+
+client.logout()
+```
+
+**Error Handling:**
+
+```python
+import requests
+from requests.exceptions import HTTPError
+
+def safe_api_call(client, method, *args, **kwargs):
+ """Make API call with error handling."""
+ try:
+ func = getattr(client, method)
+ return func(*args, **kwargs)
+
+ except HTTPError as e:
+ if e.response.status_code == 401:
+ print("Authentication failed or token expired")
+ # Re-authenticate
+ client.login(email, password)
+ # Retry
+ return func(*args, **kwargs)
+ elif e.response.status_code == 403:
+ print("Permission denied")
+ elif e.response.status_code == 404:
+ print("Resource not found")
+ else:
+ print(f"API error: {e.response.status_code}")
+ print(e.response.text)
+
+ raise
+
+# Usage
+try:
+ boards = safe_api_call(client, "get_boards")
+except Exception as e:
+ print(f"Failed to get boards: {e}")
+```
+
+### JavaScript/TypeScript
+
+**Using `fetch` API:**
+
+```javascript
+class InvokeAIClient {
+ constructor(baseUrl = 'http://localhost:9090') {
+ this.baseUrl = baseUrl;
+ this.token = null;
+ }
+
+ async login(email, password, rememberMe = false) {
+ const response = await fetch(`${this.baseUrl}/api/v1/auth/login`, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify({
+ email,
+ password,
+ remember_me: rememberMe,
+ }),
+ });
+
+ if (!response.ok) {
+ throw new Error(`Login failed: ${response.statusText}`);
+ }
+
+ const data = await response.json();
+ this.token = data.token;
+
+ // Store token in localStorage
+ localStorage.setItem('invokeai_token', data.token);
+
+ return data.user;
+ }
+
+ getHeaders() {
+ if (!this.token) {
+ throw new Error('Not authenticated. Call login() first.');
+ }
+
+ return {
+ 'Authorization': `Bearer ${this.token}`,
+ 'Content-Type': 'application/json',
+ };
+ }
+
+ async getBoards() {
+ const response = await fetch(`${this.baseUrl}/api/v1/boards/`, {
+ headers: this.getHeaders(),
+ });
+
+ if (!response.ok) {
+ throw new Error(`Failed to get boards: ${response.statusText}`);
+ }
+
+ return response.json();
+ }
+
+ async createBoard(boardName) {
+ const url = new URL(`${this.baseUrl}/api/v1/boards/`);
+ url.searchParams.set('board_name', boardName);
+ const response = await fetch(url, {
+ method: 'POST',
+ headers: this.getHeaders(),
+ });
+
+ if (!response.ok) {
+ throw new Error(`Failed to create board: ${response.statusText}`);
+ }
+
+ return response.json();
+ }
+
+ async logout() {
+ const response = await fetch(`${this.baseUrl}/api/v1/auth/logout`, {
+ method: 'POST',
+ headers: this.getHeaders(),
+ });
+
+ this.token = null;
+ localStorage.removeItem('invokeai_token');
+
+ return response.json();
+ }
+}
+
+// Usage
+(async () => {
+ const client = new InvokeAIClient();
+
+ try {
+ const user = await client.login('user@example.com', 'SecurePassword123');
+ console.log(`Logged in as: ${user.display_name}`);
+
+ const boards = await client.getBoards();
+ console.log(`User has ${boards.items.length} boards`);
+
+ const newBoard = await client.createBoard('My New Board');
+ console.log(`Created board: ${newBoard.board_name}`);
+
+ await client.logout();
+ } catch (error) {
+ console.error('Error:', error.message);
+ }
+})();
+```
+
+**TypeScript with Types:**
+
+```typescript
+interface LoginRequest {
+ email: string;
+ password: string;
+ remember_me?: boolean;
+}
+
+interface User {
+ user_id: string;
+ email: string;
+ display_name: string;
+ is_admin: boolean;
+ is_active: boolean;
+ created_at: string;
+}
+
+interface LoginResponse {
+ token: string;
+ user: User;
+ expires_in: number;
+}
+
+interface Board {
+ board_id: string;
+ board_name: string;
+ created_at: string;
+ updated_at: string;
+ deleted_at?: string;
+ cover_image_name?: string;
+}
+
+class InvokeAIClient {
+ private baseUrl: string;
+ private token: string | null = null;
+
+ constructor(baseUrl: string = 'http://localhost:9090') {
+ this.baseUrl = baseUrl;
+ }
+
+ async login(
+ email: string,
+ password: string,
+ rememberMe: boolean = false
+ ): Promise {
+ const response = await fetch(`${this.baseUrl}/api/v1/auth/login`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ email, password, remember_me: rememberMe }),
+ });
+
+ if (!response.ok) {
+ const error = await response.json();
+ throw new Error(error.detail || 'Login failed');
+ }
+
+ const data: LoginResponse = await response.json();
+ this.token = data.token;
+ return data.user;
+ }
+
+ private getHeaders(): HeadersInit {
+ if (!this.token) {
+ throw new Error('Not authenticated');
+ }
+ return {
+ 'Authorization': `Bearer ${this.token}`,
+ 'Content-Type': 'application/json',
+ };
+ }
+
+ async getBoards(): Promise<{ items: Board[] }> {
+ const response = await fetch(`${this.baseUrl}/api/v1/boards/`, {
+ headers: this.getHeaders(),
+ });
+
+ if (!response.ok) {
+ throw new Error('Failed to get boards');
+ }
+
+ return response.json();
+ }
+}
+```
+
+### cURL
+
+**Login:**
+
+```bash
+# Login and extract token
+TOKEN=$(curl -X POST http://localhost:9090/api/v1/auth/login \
+ -H "Content-Type: application/json" \
+ -d '{
+ "email": "user@example.com",
+ "password": "SecurePassword123",
+ "remember_me": false
+ }' | jq -r '.token')
+
+echo "Token: $TOKEN"
+```
+
+**Get Boards:**
+
+```bash
+curl -X GET http://localhost:9090/api/v1/boards/ \
+ -H "Authorization: Bearer $TOKEN" \
+ -H "Content-Type: application/json"
+```
+
+**Create Board:**
+
+```bash
+curl -X POST "http://localhost:9090/api/v1/boards/?board_name=My%20API%20Board" \
+ -H "Authorization: Bearer $TOKEN"
+```
+
+## API Endpoint Changes
+
+### Authentication Required
+
+All endpoints now require authentication except:
+
+- `GET /api/v1/auth/status` — Check whether multi-user setup is required
+- `POST /api/v1/auth/setup` — Initial admin setup
+- `POST /api/v1/auth/login` — User login
+- `GET /api/v1/images/i/{image_name}/full` — Full-resolution image file
+- `GET /api/v1/images/i/{image_name}/thumbnail` — Image thumbnail
+- `GET /api/v1/workflows/i/{workflow_id}/thumbnail` — Workflow thumbnail
+
+The image and thumbnail endpoints are intentionally unauthenticated because browsers load these resources via `` tags, which cannot send `Authorization` headers. Security relies on the fact that image and workflow IDs are UUIDs and therefore unguessable.
+
+### User-Scoped Resources
+
+Resources are now filtered by the authenticated user:
+
+**Boards:**
+
+```python
+# Before (single-user)
+GET /api/v1/boards/?all=true # Returns all boards
+
+# After (multi-user)
+GET /api/v1/boards/?all=true # Returns boards the current user can access, including their own boards plus shared/public boards; admins can see all boards
+```
+
+**Images:**
+
+```python
+# Images are filtered by board ownership
+GET /api/v1/images/ # Only shows images on user's boards
+```
+
+**Workflows:**
+
+```python
+# Returns user's workflows + public workflows
+GET /api/v1/workflows/
+```
+
+**Queue:**
+
+```python
+# Regular users see their own queue items in full and may see redacted details for other users' items on queue-status endpoints
+GET /api/v1/queue/... # Queue data, sanitized for non-admin viewers
+
+# Administrators see all queue items in full
+GET /api/v1/queue/... # Full queue data
+```
+
+### Administrator Endpoints
+
+Some endpoints require administrator privileges:
+
+**User Management:**
+
+```python
+GET /api/v1/auth/users # List users (admin only)
+POST /api/v1/auth/users # Create user (admin only)
+GET /api/v1/auth/users/{id} # Get user (admin only)
+PATCH /api/v1/auth/users/{id} # Update user (admin only)
+DELETE /api/v1/auth/users/{id} # Delete user (admin only)
+```
+
+**Model Management (Write Operations):**
+
+```python
+POST /api/v2/models/install # Install model (admin only)
+DELETE /api/v2/models/i/{key} # Delete model (admin only)
+PATCH /api/v2/models/i/{key} # Update model (admin only)
+PUT /api/v2/models/convert/{key} # Convert model (admin only)
+```
+
+**Model Management (Read Operations):**
+
+```python
+GET /api/v2/models/ # List models (all users)
+GET /api/v2/models/i/{key} # Get model details (all users)
+```
+
+### Error Responses
+
+**401 Unauthorized:**
+
+```json
+{
+ "detail": "Invalid authentication credentials"
+}
+```
+
+Occurs when:
+
+- Token is missing
+- Token is invalid
+- Token is expired
+- Token signature is invalid
+
+**403 Forbidden:**
+
+```json
+{
+ "detail": "Admin privileges required"
+}
+```
+
+Occurs when:
+
+- User attempts admin-only operation
+- Account is disabled
+- Insufficient permissions
+
+**404 Not Found:**
+
+```json
+{
+ "detail": "Resource not found"
+}
+```
+
+Occurs when:
+
+- Resource doesn't exist
+- User doesn't have access to resource
+
+## Multiuser API Endpoints
+
+### Authentication Endpoints
+
+#### Check if initial administrator setup is required
+
+**Endpoint:** `GET /api/v1/auth/status`
+
+**Description:** Returns a SetupStatusResponse indicating whether setup is needed and multiuser mode status.
+
+**Request:** No parameters
+
+**Response (initial setup not yet complete):**
+```json
+{
+ "setup_required": true,
+ "multiuser_enabled": true,
+ "strict_password_checking": true,
+ "admin_email": "admin@example.com"
+}
+```
+
+**Response (setup already complete, or multiuser disabled):**
+```json
+{
+ "setup_required": false,
+ "multiuser_enabled": true,
+ "strict_password_checking": true,
+ "admin_email": null
+}
+```
+
+:::note
+`admin_email` is only populated while `setup_required` is `true` (to help locate the pre-seeded
+administrator account during initial setup). Once an admin has been created — and whenever
+multiuser mode is disabled — it is returned as `null` to avoid leaking administrator identity on
+public deployments.
+:::
+
+
+#### Setup Administrator
+
+**Endpoint:** `POST /api/v1/auth/setup`
+
+**Description:** Create initial administrator account (only works if no admin exists)
+
+**Request:**
+
+```json
+{
+ "email": "admin@example.com",
+ "display_name": "Administrator",
+ "password": "SecureAdminPass123"
+}
+```
+
+**Response:**
+
+```json
+{
+ "success": true,
+ "user": {
+ "user_id": "abc123",
+ "email": "admin@example.com",
+ "display_name": "Administrator",
+ "is_admin": true,
+ "is_active": true
+ }
+}
+```
+
+
+#### Get Current User
+
+**Endpoint:** `GET /api/v1/auth/me`
+
+**Description:** Get currently authenticated user's information
+
+**Request:**
+
+```http
+GET /api/v1/auth/me
+Authorization: Bearer
+```
+
+**Response:**
+
+```json
+{
+ "user_id": "abc123",
+ "email": "user@example.com",
+ "display_name": "John Doe",
+ "is_admin": false,
+ "is_active": true,
+ "created_at": "2024-01-15T10:00:00Z",
+ "updated_at": "2024-01-15T10:00:00Z",
+ "last_login_at": "2024-01-15T15:30:00Z"
+}
+```
+
+### User Management Endpoints (Admin Only)
+
+#### List Users
+
+**Endpoint:** `GET /api/v1/auth/users`
+
+**Request:**
+
+```http
+GET /api/v1/auth/users
+Authorization: Bearer
+```
+
+**Response:**
+
+```json
+[
+ {
+ "user_id": "abc123",
+ "email": "user@example.com",
+ "display_name": "John Doe",
+ "is_admin": false,
+ "is_active": true,
+ "created_at": "2024-01-15T10:00:00Z",
+ "updated_at": "2024-04-25T17:23:00Z",
+ "last_login_at": "2024-01-15T15:30:00Z"
+ }
+]
+```
+
+#### Create User
+
+**Endpoint:** `POST /api/v1/auth/users`
+
+**Request:**
+
+```json
+{
+ "email": "newuser@example.com",
+ "display_name": "New User",
+ "password": "TempPassword123",
+ "is_admin": false
+}
+```
+
+**Response:**
+
+```json
+{
+ "user_id": "xyz789",
+ "email": "newuser@example.com",
+ "display_name": "New User",
+ "is_admin": false,
+ "is_active": true,
+ "created_at": "2024-01-15T16:00:00Z"
+}
+```
+
+#### Update User
+
+**Endpoint:** `PATCH /api/v1/auth/users/{user_id}`
+
+**Request:**
+
+```json
+{
+ "display_name": "Updated Name",
+ "is_active": true,
+ "is_admin": false
+}
+```
+
+**Response:**
+
+```json
+{
+ "user_id": "xyz789",
+ "email": "newuser@example.com",
+ "display_name": "Updated Name",
+ "is_admin": false,
+ "is_active": true
+}
+```
+
+#### Delete User
+
+**Endpoint:** `DELETE /api/v1/auth/users/{user_id}`
+
+**Response:**
+
+Returns `204 No Content` on success.
+
+On an error, it returns `422 Unprocessable Content` and the following JSON:
+
+```json
+{
+ "detail": [
+ {
+ "loc": [
+ "string",
+ 0
+ ],
+ "msg": "string",
+ "type": "string"
+ }
+ ]
+}
+```
+
+#### List Image Boards
+
+**Endpoint:** `GET /api/v1/boards/`
+
+**Response:**
+
+```json
+{
+ "limit": 0,
+ "offset": 0,
+ "total": 0,
+ "items": [
+ {
+ "board_id": "8b31a33d-0acb-46fe-8612-83601481cf2c",
+ "board_name": "Testing Board",
+ "user_id": "string",
+ "created_at": "2026-05-07T03:04:00.738Z",
+ "updated_at": "2026-05-07T03:04:00.738Z",
+ "deleted_at": "2026-05-07T03:04:00.738Z",
+ "cover_image_name": "string",
+ "archived": false,
+ "board_visibility": "private",
+ "image_count": 0,
+ "asset_count": 0,
+ "owner_username": "string"
+ }
+ ]
+}
+```
+
+This returns a paged response. See the swagger page (`http://localhost:9090/docs#/boards/list_boards`) for details.
+The `board_visibility` field will be one of:
+
+- `private` -- private to the owner and administrator
+- `shared` -- read/write to the owner and administrator, read-only to everyone else
+- `public` -- read/write by everyone
+
+#### Get One Board
+
+**Endpoint:** `GET /api/v1/boards/{board_id}`
+
+**Response:**
+
+```json
+{
+ "board_id": "8b31a33d-0acb-46fe-8612-83601481cf2c",
+ "board_name": "Testing Board",
+ "user_id": "3c59a0ba-f4c7-4275-b96f-82179e8aaff8",
+ "created_at": "2026-03-09 16:10:47.095",
+ "updated_at": "2026-03-09 16:10:55",
+ "deleted_at": null,
+ "cover_image_name": "08689e4b-f084-4c49-83a8-4fc1edb167c4.png",
+ "archived": false,
+ "board_visibility": "shared",
+ "image_count": 55,
+ "asset_count": 0,
+ "owner_username": null
+}
+```
+
+
+## Best Practices
+
+### Token Storage
+
+**Do:**
+
+- Store tokens securely (keychain, secure storage)
+- Use HTTPS to transmit tokens
+- Clear tokens on logout
+- Handle token expiration gracefully
+
+**Don't:**
+
+- Store tokens in URL parameters
+- Log tokens in plain text
+- Share tokens between users
+- Store tokens in version control
+
+### Error Handling
+
+Always handle authentication errors:
+
+```python
+def make_request(client, func, *args, **kwargs):
+ max_retries = 3
+ retry_count = 0
+
+ while retry_count < max_retries:
+ try:
+ return func(*args, **kwargs)
+ except AuthenticationError:
+ if retry_count >= max_retries - 1:
+ raise
+ # Re-authenticate
+ client.login(email, password)
+ retry_count += 1
+ except Exception as e:
+ logger.error(f"Request failed: {e}")
+ raise
+```
+
+### Rate Limiting
+
+Be mindful of API rate limits:
+
+- Implement exponential backoff for retries
+- Cache frequently accessed data
+- Batch requests when possible
+- Don't hammer the login endpoint
+
+### Connection Management
+
+```python
+import requests
+from requests.adapters import HTTPAdapter
+from urllib3.util.retry import Retry
+
+def create_session():
+ """Create session with retry logic."""
+ session = requests.Session()
+
+ retry = Retry(
+ total=3,
+ backoff_factor=0.3,
+ status_forcelist=[500, 502, 503, 504],
+ )
+
+ adapter = HTTPAdapter(max_retries=retry)
+ session.mount('http://', adapter)
+ session.mount('https://', adapter)
+
+ return session
+```
+
+## Migration Guide
+
+### Updating Existing Code
+
+**Before (single-user mode):**
+
+```python
+import requests
+
+def get_boards():
+ response = requests.get("http://localhost:9090/api/v1/boards/")
+ return response.json()
+```
+
+**After (multi-user mode):**
+
+```python
+import requests
+
+class APIClient:
+ def __init__(self):
+ self.token = None
+
+ def login(self, email, password):
+ response = requests.post(
+ "http://localhost:9090/api/v1/auth/login",
+ json={"email": email, "password": password}
+ )
+ self.token = response.json()["token"]
+
+ def get_boards(self):
+ headers = {"Authorization": f"Bearer {self.token}"}
+ response = requests.get(
+ "http://localhost:9090/api/v1/boards/",
+ headers=headers
+ )
+ return response.json()
+
+# Usage
+client = APIClient()
+client.login("user@example.com", "password")
+boards = client.get_boards()
+```
+
+### Backward Compatibility
+
+InvokeAI supports both single-user and multi-user modes via the `multiuser` configuration option.
+
+**Configuration:**
+
+```yaml
+# invokeai.yaml
+
+# Single-user mode (no authentication)
+multiuser: false # or omit the option entirely
+
+# Multi-user mode (authentication required)
+multiuser: true
+```
+
+**Checking Mode Programmatically:**
+
+```python
+def is_multiuser_enabled(base_url):
+ response = requests.get(f"{base_url}/api/v1/auth/status")
+ response.raise_for_status()
+ return response.json()["multiuser_enabled"]
+
+# Example usage
+base_url = "http://localhost:9090"
+if is_multiuser_enabled(base_url):
+ print("Multi-user mode: authentication required")
+ # Use authenticated API calls
+else:
+ print("Single-user mode: no authentication needed")
+ # Use direct API calls
+```
+
+**Adaptive Client:**
+
+```python
+class AdaptiveInvokeAIClient:
+ def __init__(self, base_url="http://localhost:9090"):
+ self.base_url = base_url
+ self.token = None
+ self.multiuser_mode = self._check_multiuser_mode()
+
+ def _check_multiuser_mode(self):
+ """Detect if multi-user mode is enabled."""
+ try:
+ response = requests.get(f"{self.base_url}/api/v1/boards/")
+ return response.status_code == 401
+ except:
+ return False
+
+ def login(self, email, password):
+ """Login (only needed in multi-user mode)."""
+ if not self.multiuser_mode:
+ print("Single-user mode: login not required")
+ return
+
+ response = requests.post(
+ f"{self.base_url}/api/v1/auth/login",
+ json={"email": email, "password": password}
+ )
+ self.token = response.json()["token"]
+
+ def _get_headers(self):
+ """Get headers (with auth token if in multi-user mode)."""
+ if self.multiuser_mode and self.token:
+ return {"Authorization": f"Bearer {self.token}"}
+ return {}
+
+ def get_boards(self):
+ """Get boards (works in both modes)."""
+ response = requests.get(
+ f"{self.base_url}/api/v1/boards/",
+ headers=self._get_headers()
+ )
+ return response.json()
+```
+
+## Programmatic Graph Execution
+
+If you are building an external client against the HTTP API, see the dedicated [Workflow Execution guide](/development/guides/workflow-api/).
+
+In multi-user mode, remember to include your `Authorization: Bearer ` header on queue and workflow requests.
+
+## OpenAPI/Swagger Documentation
+
+InvokeAI provides OpenAPI documentation for all endpoints.
+
+**Access Swagger UI:**
+
+```
+http://localhost:9090/docs
+```
+
+**Download OpenAPI Schema:**
+
+```bash
+curl http://localhost:9090/openapi.json > invokeai_openapi.json
+```
+
+**Generate Client Code:**
+
+Use tools like `openapi-generator` to generate client libraries:
+
+```bash
+# Generate Python client
+openapi-generator generate \
+ -i http://localhost:9090/openapi.json \
+ -g python \
+ -o ./invokeai-client
+
+# Generate TypeScript client
+openapi-generator generate \
+ -i http://localhost:9090/openapi.json \
+ -g typescript-fetch \
+ -o ./invokeai-client-ts
+```
+
+## Security Considerations
+
+### HTTPS
+
+Always use HTTPS in production:
+
+```python
+# Development
+client = InvokeAIClient("http://localhost:9090")
+
+# Production
+client = InvokeAIClient("https://invoke.example.com")
+```
+
+### Token Security
+
+Protect JWT tokens:
+
+```python
+# Never log tokens
+logger.info(f"User logged in") # Good
+logger.info(f"Token: {token}") # Bad!
+
+# Use environment variables for credentials
+import os
+email = os.environ.get("INVOKEAI_EMAIL")
+password = os.environ.get("INVOKEAI_PASSWORD")
+```
+
+### Input Validation
+
+Always validate user input:
+
+```python
+import re
+
+def validate_email(email):
+ pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
+ return re.match(pattern, email) is not None
+
+def validate_password(password):
+ """Check password meets requirements."""
+ if len(password) < 8:
+ return False, "Password must be at least 8 characters"
+ if not any(c.isupper() for c in password):
+ return False, "Password must contain uppercase letters"
+ if not any(c.islower() for c in password):
+ return False, "Password must contain lowercase letters"
+ if not any(c.isdigit() for c in password):
+ return False, "Password must contain numbers"
+ return True, ""
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**Issue: "Invalid authentication credentials"**
+
+- Token expired — re-authenticate
+- Token malformed — check token string
+- Token signature invalid — check secret key hasn't changed
+
+**Issue: "Admin privileges required"**
+
+- User is not an administrator
+- Use admin account for this operation
+
+**Issue: Token not being sent**
+
+- Check `Authorization` header is present
+- Verify `Bearer` prefix is included
+- Check token isn't truncated
+
+**Issue: CORS errors**
+
+Configure CORS in InvokeAI:
+
+```yaml
+# invokeai.yaml
+allow_origins:
+ - "http://localhost:3000"
+ - "https://myapp.example.com"
+allow_credentials: true
+allow_methods:
+ - "*"
+allow_headers:
+ - "*"
+```
+
+## Additional Resources
+
+- [User Guide](./user-guide/) — For end users
+- [Administrator Guide](./admin-guide/) — For administrators
+- [GitHub Repository](https://github.com/invoke-ai/InvokeAI) — Source code
+
+---
+
+**Questions?** Visit the [InvokeAI Discord](https://discord.gg/ZmtBAhwWhy) or check the [FAQ](/troubleshooting/faq/).
diff --git a/docs/src/content/docs/features/Multi-User Mode/assets/admin-add-user-1.png b/docs/src/content/docs/features/Multi-User Mode/assets/admin-add-user-1.png
new file mode 100644
index 00000000000..706039d50cb
Binary files /dev/null and b/docs/src/content/docs/features/Multi-User Mode/assets/admin-add-user-1.png differ
diff --git a/docs/src/content/docs/features/Multi-User Mode/assets/admin-add-user-2.png b/docs/src/content/docs/features/Multi-User Mode/assets/admin-add-user-2.png
new file mode 100644
index 00000000000..44bf2e180a3
Binary files /dev/null and b/docs/src/content/docs/features/Multi-User Mode/assets/admin-add-user-2.png differ
diff --git a/docs/src/content/docs/features/Multi-User Mode/assets/admin-add-user-3.png b/docs/src/content/docs/features/Multi-User Mode/assets/admin-add-user-3.png
new file mode 100644
index 00000000000..708f9a85135
Binary files /dev/null and b/docs/src/content/docs/features/Multi-User Mode/assets/admin-add-user-3.png differ
diff --git a/docs/src/content/docs/features/Multi-User Mode/assets/admin-setup.png b/docs/src/content/docs/features/Multi-User Mode/assets/admin-setup.png
new file mode 100644
index 00000000000..fbe035e5c6e
Binary files /dev/null and b/docs/src/content/docs/features/Multi-User Mode/assets/admin-setup.png differ
diff --git a/docs/src/content/docs/features/Multi-User Mode/assets/user-login-1.png b/docs/src/content/docs/features/Multi-User Mode/assets/user-login-1.png
new file mode 100644
index 00000000000..8c4bec22943
Binary files /dev/null and b/docs/src/content/docs/features/Multi-User Mode/assets/user-login-1.png differ
diff --git a/docs/src/content/docs/features/Multi-User Mode/user-guide.mdx b/docs/src/content/docs/features/Multi-User Mode/user-guide.mdx
new file mode 100644
index 00000000000..d595668a65e
--- /dev/null
+++ b/docs/src/content/docs/features/Multi-User Mode/user-guide.mdx
@@ -0,0 +1,366 @@
+---
+title: Multi-User Guide
+description: How to use InvokeAI in multi-user mode as an end user.
+sidebar:
+ order: 3
+---
+import { Steps } from '@astrojs/starlight/components'
+
+## Overview
+
+Multi-User mode is a recent feature (introduced in version 6.12), which allows multiple individuals to share a single InvokeAI server while keeping their work separate and organized. Each user has their own username and login password, images, assets, image boards, customization settings and workflows.
+
+Two types of users are recognized:
+
+- A user with **Administrator** status can add, remove and modify other users, and can install models. They also have the ability to view the full session queue and pause or kill other users' jobs.
+- **Non-administrator** users can modify their own profile but not others. They also do not have the ability to install or configure models, but must ask an Administrator to do this task. When viewing the generation queue, they can see the full details of their own jobs, but jobs owned by other users will have the user id, generation parameters, and other details redacted.
+
+Multiple users can be granted Administrator status.
+
+---
+
+## Getting Started
+
+To activate Multi-User mode, open the `INVOKEAI_ROOT/invokeai.yaml` configuration file in a text editor. Add this line anywhere in the file:
+
+```yaml
+multiuser: true
+```
+
+You may also wish to make InvokeAI available to other machines on your local LAN. Add an additional line to `invokeai.yaml`:
+
+```yaml
+host: 0.0.0.0
+```
+
+Restart the server. It will now be in multi-user mode. If you enabled the `host` option, other users on your home or office LAN will be able to reach it by browsing to the IP address of the machine the backend is running on (`http://host-ip-address:9090`).
+
+:::tip[Do not expose InvokeAI to the internet]
+It is not recommended to expose the InvokeAI host to the internet due to security concerns.
+:::
+
+### Initial Setup (First Time in Multi-User Mode)
+
+If you're the first person to access a fresh InvokeAI installation in multi-user mode, you'll see the **Administrator Setup** dialog:
+
+
+
+Now:
+
+
+1. Enter your email address (this will be your login name)
+2. Create a display name (this will be the name other users see)
+3. Choose a strong password. The following criteria are required with `strict_password_checking: true`.
+ - At least 8 characters long
+ - Contains uppercase letters
+ - Contains lowercase letters
+ - Contains numbers
+4. Confirm your password
+5. Click **Create Administrator Account**
+
+
+With `strict_password_checking` disabled, you'll be warned if you choose a
+weak password, but not prevented from doing so.
+
+You'll now be taken to a login screen and can enter the credentials you just created.
+
+### Adding and Modifying Users
+
+If you are logged in as Administrator, you can add additional users. Click on the small "person silhouette" icon at the bottom left of the main Invoke screen and select "User Management"
+
+
+
+This will take you to the User Management screen...
+
+
+
+...where you can click "Create User" to add a new user.
+
+
+
+The User Management screen also allows you to:
+
+
+1. Temporarily change a user's status to Inactive, preventing them from logging in to Invoke.
+2. Edit a user (by clicking on the pencil icon) to change the user's display name or password.
+3. Permanently delete a user.
+4. Grant a user Administrator privileges.
+
+
+---
+
+## Logging in as a Non-Administrative User
+
+If you are a registered user on the system, enter your email address and password to log in. The Administrator will be able to provide you with the values to use:
+
+
+
+As an unprivileged user you can do pretty much anything that's allowed under single-user mode — generating images, using LoRAs, creating and running workflows, creating image boards — but you are restricted against installing new models, changing low-level server settings, or interfering with other users. More information on user roles is given below.
+
+### Changing your Profile
+
+To change your display name or profile, click on the person silhouette icon at the bottom left of the screen and choose "My Profile". This will take you to a screen that lets you change these values. At this time you can change your display name but not your login ID (ordinarily your contact email address).
+
+---
+
+## Understanding User Roles
+
+In single-user mode, you have access to all features without restrictions. In multi-user mode, InvokeAI has two user roles:
+
+### Regular User
+
+As a regular user, you can:
+
+- Create and manage your own image boards
+- Generate images using all AI tools (Linear, Canvas, Upscale, Workflows)
+- Create, save, and load your own workflows
+- View the full details of jobs you own on the session queue
+- View redacted information for jobs being run by other users
+- Customize your UI preferences (theme, hotkeys, etc.)
+- View available models (read-only access to Model Manager)
+- View shared and public boards created by other users
+- View and use workflows marked as shared by other users
+
+You cannot:
+
+- Add, delete, or modify models
+- View or modify other users' private boards, images, or workflows
+- Manage user accounts
+- Access system configuration
+- Cancel other users' generation jobs
+
+:::tip[The generation queue]
+When two or more users are accessing InvokeAI at the same time, their image generation jobs will be placed on the session queue on a first-come, first-serve basis. This means that you will have to wait for other users' image rendering jobs to complete before yours will start.
+
+While other users' jobs are running you will see the shared image generation progress bar, and the queue badge will show a single number — the count of your own jobs that are pending or in progress. It does not show other users' counts.
+
+Open the Queue tab to see where your job sits in relation to the other queued tasks.
+:::
+
+### Administrator
+
+Administrators have all regular user capabilities, plus:
+
+- Full model management (add, delete, configure models)
+- Create and manage user accounts
+- View and manage all users' generation queues
+- View and manage all users' boards, images, and workflows (including system-owned legacy content)
+- Access system configuration
+- Grant or revoke admin privileges
+
+---
+
+## Working with Your Content in Multi-User Mode
+
+### Image Boards
+
+In multi-user mode, each user can create an unlimited number of boards and organize their images and assets as they see fit. Boards have three visibility levels:
+
+- **Private** (default): Only you (and administrators) can see and modify the board.
+- **Shared**: All users can view the board and its contents, but only you (and administrators) can modify it (rename, archive, delete, or add/remove images).
+- **Public**: All users can view the board. Only you (and administrators) can modify the board's structure (rename, archive, delete).
+
+To change a board's visibility, right-click on the board and select the desired visibility option.
+
+Administrators can see and manage all users' image boards and their contents regardless of visibility settings.
+
+### Going From Multi-User to Single-User Mode
+
+If an InvokeAI instance was in multiuser mode and then restarted in single user mode (by setting `multiuser: false` in the configuration file), all users' boards will be consolidated in one place. Any images that were in "Uncategorized" will be merged together into a single Uncategorized board. If, at a later date, the server is restarted in multi-user mode, the boards and images will be assigned to the internal 'system' user. Admins can access this legacy content, and will not be restored to original owners.
+
+### Workflows
+
+Each user has their own private workflow library. Workflows you create are visible only to you by default.
+
+You can share a workflow with other users by marking it as **shared** (public). Shared workflows appear in all users' workflow libraries and can be opened by anyone, but only the owner (or an administrator) can modify or delete them.
+
+To share a workflow, open it and use the sharing controls to toggle its public/shared status.
+
+:::caution[Preexisting workflows after enabling multi-user mode]
+When you enable multi-user mode for the first time on an existing InvokeAI installation, all workflows that were created before multi-user mode was activated will appear in the **shared workflows** section. These preexisting workflows are owned by the internal "system" account and are visible to all users. Administrators can edit or delete these shared legacy workflows. Regular users can view and use them but cannot modify them.
+:::
+
+### The Generation Queue
+
+The queue shows your pending and running generation tasks.
+
+**Queue Features:**
+
+- View your current and completed generations
+- Cancel pending tasks
+- Re-run previous generations
+- Monitor progress in real-time
+
+**Queue Isolation:**
+
+- You will see your own queue items, as well as the items generated by other users, but the generation parameters (e.g. prompts) for other users' jobs are hidden for privacy reasons.
+- Administrators can view all queues for troubleshooting.
+- Your generations won't interfere with other users' tasks.
+
+---
+
+## Customizing Your Experience
+
+### Personal Preferences
+
+Your UI preferences are saved to your account and are restored when you log in:
+
+- **Hotkeys**: Customize keyboard shortcuts
+- **Canvas Settings**: Default zoom, grid visibility, etc.
+- **Generation Defaults**: Default values for width, height, steps, etc.
+
+These settings are stored per-user and won't affect other users.
+
+---
+
+## Troubleshooting
+
+### Cannot Log In
+
+**Issue:** Login fails with "Incorrect email or password"
+
+**Solutions:**
+
+- Verify you're entering the correct email address
+- Check that Caps Lock is off
+- Try typing the password slowly to avoid mistakes
+- Contact your administrator if you've forgotten your password
+
+**Issue:** Login fails with "Account is disabled"
+
+**Solution:** Contact your administrator to reactivate your account
+
+### Session Expired
+
+**Issue:** You're suddenly logged out and see "Session expired"
+
+**Explanation:** Sessions expire after 24 hours (or 7 days with "remember me")
+
+**Solution:** Simply log in again with your credentials
+
+### Cannot Access Features
+
+**Issue:** Features like Model Manager show "Admin privileges required"
+
+**Explanation:** Some features are restricted to administrators
+
+**Solution:**
+
+- For model viewing: You can view but not modify models
+- For user management: Contact an administrator
+- For system configuration: Contact an administrator
+
+### Missing Boards or Images
+
+**Issue:** Boards or images you created are not visible
+
+**Possible Causes:**
+
+
+1. **Filter Applied:** Check if a filter is hiding content
+2. **Wrong User:** Ensure you're logged in with the correct account
+3. **Archived Board:** Check the "Show Archived" option
+
+
+**Solution:**
+
+- Clear any active filters
+- Verify you're logged in as the right user
+- Check archived items
+
+### Slow Performance
+
+**Issue:** Generation or UI feels slower than expected
+
+**Possible Causes:**
+
+- Other users generating images simultaneously
+- Server resource limits
+- Network latency
+
+**Solutions:**
+
+- Check the queue to see if others are generating
+- Wait for current generations to complete
+- Contact administrator if persistent
+
+### Generation Stuck in Queue
+
+**Issue:** Your generation is queued but not starting
+
+**Possible Causes:**
+
+- Server is processing other users' generations
+- Server resources are fully utilized
+- Technical issue with the server
+
+**Solutions:**
+
+- Wait for your turn in the queue
+- Check if your generation is paused
+- Contact administrator if stuck for extended period
+
+---
+
+## Frequently Asked Questions
+
+### Can other users see my images?
+
+Not unless you change your board's visibility to "shared" or "public". All personal boards and images are private by default.
+
+### Can I share my workflows with others?
+
+Yes. You can mark any workflow as shared (public), which makes it visible to all users. Other users can view and use shared workflows, but only you or an administrator can modify or delete them.
+
+### How long do sessions last?
+
+- 24 hours by default
+- 7 days if you check "Remember me" during login
+
+### Can I use the API with multi-user mode?
+
+Yes, but you'll need to authenticate with a JWT token. See the [API Guide](./api-guide/) for details.
+
+### What happens if I forget my password?
+
+Contact your administrator. They can reset your password for you.
+
+### Can I have multiple sessions?
+
+Yes, you can log in from multiple devices or browsers simultaneously. All sessions will use the same account and see the same content.
+
+### Why can't I see the Model Manager "Add Models" tab?
+
+Regular users can see the Models tab but with read-only access. Check that you're logged in and try refreshing the page.
+
+### How do I know if I'm an administrator?
+
+Click the user icon near the bottom of the left-hand navigation bar to open the user menu. If you are an administrator, an "Admin" badge appears under your name in that menu and a "User Management" item is shown alongside the usual Profile and Logout actions.
+
+### Can I request admin privileges?
+
+Yes, ask your current administrator to grant you admin privileges. Admin privileges will give you the ability to see all other users' boards and images, as well as to add models and change various server-wide settings.
+
+## Getting Help
+
+### Support Channels
+
+- **Administrator:** Contact your system administrator for account issues
+- **Documentation:** Check the [FAQ](/troubleshooting/faq/) for common issues
+- **Community:** Join the [Discord](https://discord.gg/ZmtBAhwWhy) for help
+- **Bug Reports:** File issues on [GitHub](https://github.com/invoke-ai/InvokeAI/issues)
+
+### Reporting Issues
+
+When reporting an issue, include:
+
+- Your role (regular user or administrator)
+- What you were trying to do
+- What happened instead
+- Any error messages you saw
+- Your browser and operating system
+
+## Additional Resources
+
+- [Administrator Guide](./admin-guide/) — For administrators managing users and the system
+- [API Guide](./api-guide/) — For developers using the InvokeAI API
diff --git a/docs/src/content/docs/features/Workflows/adding-nodes.mdx b/docs/src/content/docs/features/Workflows/adding-nodes.mdx
new file mode 100644
index 00000000000..6210d739194
--- /dev/null
+++ b/docs/src/content/docs/features/Workflows/adding-nodes.mdx
@@ -0,0 +1,170 @@
+---
+title: Adding Nodes
+description: Learn how to add, connect, and configure nodes in InvokeAI's workflow editor.
+sidebar:
+ order: 3
+lastUpdated: 2026-03-16
+---
+
+import { Card, CardGrid, Steps, Tabs, TabItem } from '@astrojs/starlight/components';
+
+Nodes are the building blocks of workflows. Each node performs a specific operation — loading a model, generating noise, applying conditioning, denoising latents, and more. By adding nodes to the canvas and connecting them together, you create a complete image generation pipeline.
+
+## Opening the Node Picker
+
+The node picker is a searchable command palette that lists every available node. There are three ways to open it:
+
+
+
+ Press Shift + A or Space while the workflow editor is focused.
+
+
+ Click the **+** button in the top-left corner of the canvas.
+
+
+ Drag a connection from any input or output port and release it over empty canvas. The picker will open with results **filtered to compatible nodes only**.
+
+
+
+## Finding a Node
+
+When the node picker opens, you can immediately start typing to search. The search is fuzzy and matches against several properties of each node:
+
+- **Title** — the display name (e.g. "Denoise Latents")
+- **Type** — the internal identifier
+- **Description** — a short summary of what the node does
+- **Tags** — category keywords
+- **Node Pack** — the origin module (e.g. `invokeai` for built-in nodes, or a community pack name)
+
+Each entry in the picker shows:
+
+- A **classification badge** indicating stability — _Stable_, _Beta_ (yellow), _Prototype_ (red), or _Special_ (green)
+- The **node title** and **node pack** name
+- A brief **description**
+
+Click a node or press Enter to add it to the canvas. The node will be placed near the center of your current viewport, or at your cursor position if you opened the picker by dragging from a port.
+
+:::tip
+If you opened the picker by dragging from a port, the list is automatically filtered to show only nodes that have a compatible input or output for that connection. This is a fast way to discover which nodes work together.
+:::
+
+## Special Nodes
+
+In addition to invocation nodes (which perform image generation operations), the picker includes two special utility nodes:
+
+
+
+ A sticky-note text area for documenting your workflow. Useful for leaving yourself reminders or explaining sections of a complex graph to others.
+
+
+ Displays the current image being generated or the most recent output. Helpful for monitoring progress in long workflows.
+
+
+
+## Connecting Nodes
+
+Nodes have **input ports** on their left edge and **output ports** on their right edge. Ports are color-coded by data type so you can quickly identify compatible connections.
+
+
+1. **Drag from an output port** on one node toward the canvas.
+2. **Drop onto a compatible input port** on another node. Compatible ports will remain highlighted; incompatible ports will appear greyed out.
+3. A **bezier edge** is drawn between the two ports, representing the data flow.
+
+
+:::note
+You can also drop a connection onto a node without targeting a specific port. InvokeAI will automatically connect to the **first compatible port** it finds on that node.
+:::
+
+### Connection Rules
+
+- Connections must be between compatible data types (matching colors).
+- A node cannot connect to itself.
+- Each input port accepts only one connection (but an output can connect to many inputs).
+- Connections snap within a 30px radius of a port for easy targeting.
+
+### Reconnecting and Removing Edges
+
+- **Reconnect** an edge by dragging it from its current port to a new one.
+- **Remove** an edge by dragging it away from its port and releasing it over empty canvas.
+- **Delete** selected edges with Delete or Backspace.
+
+### Connectors
+
+Connectors are small editor-only nodes that exist purely to **reroute edges** for a cleaner-looking graph. They are saved with the workflow but are flattened out of the graph before execution, so the runtime never sees them — you cannot use them to add logic, only to tidy wiring.
+
+Ways to add a connector:
+
+- **Right-click empty canvas → Add Connector**, then drag connections to and from it.
+- **Double-click an existing edge** to insert a connector at that point, splicing it in.
+
+Other behaviors worth knowing:
+
+- **Target-first wiring works.** You can connect a connector's output to a downstream target field *before* hooking up its upstream source. The connector stays unresolved until a compatible source is connected; incompatible upstreams are rejected.
+- **Type compatibility is enforced** through the connector, exactly as for normal edges.
+- **Deleting a connector splices through** any edges that pass through it:
+ - `1 → 1`: the source is reconnected directly to the target.
+ - `1 → N`: the source is reconnected to every compatible downstream target.
+ - `1 → 0`: the connector is removed, no edges created.
+ - If a splice-through would produce an invalid graph, **Delete Connector** is disabled.
+- **Connectors persist** across workflow save / load.
+
+## Configuring Nodes
+
+Once a node is on the canvas, you can configure it by editing its input fields directly. Each node exposes a set of fields specific to its function — for example, a noise node has a **Seed** field, while a model loader has a **Model** selector.
+
+- **Inline editing** — Click on any input field to edit its value directly on the node.
+- **Renaming** — Right-click a node's title or any input label to rename it.
+- **Use Cache** — Toggle the caching option in the node footer to reuse previously computed values and speed up repeat runs.
+- **Collapse** — Click the collapse button on the node header to minimize it, keeping the canvas tidy.
+
+## Managing Nodes
+
+Use these shortcuts to work efficiently with nodes on the canvas:
+
+| Action | Shortcut |
+| :--- | :--- |
+| Add Node | Shift + A or Space |
+| Copy | Ctrl/Cmd + C |
+| Paste | Ctrl/Cmd + V |
+| Paste with Edges | Ctrl/Cmd + Shift + V |
+| Select All | Ctrl/Cmd + A |
+| Delete | Delete or Backspace |
+| Undo | Ctrl/Cmd + Z |
+| Redo | Ctrl/Cmd + Shift + Z |
+| Select Multiple | Shift + Click & Drag |
+
+:::tip
+All keyboard shortcuts are customizable. Open the Hotkeys modal with Shift + ? to view or change any binding.
+:::
+
+## Adding to Linear View
+
+Any input field on a node can be promoted to the **Linear View**, which provides a simplified UI for your workflow — perfect for sharing with others or for quick iteration.
+
+
+1. Right-click on an **input label** on any node.
+2. Select **"Add to Linear View"**.
+3. The input now appears in the Linear View panel, where you can adjust it without navigating the full graph.
+
+
+Custom names you set on input fields will carry over into the Linear View.
+
+## Installing Community Nodes
+
+InvokeAI's node system is extensible. Community-created nodes can add new capabilities to your workflows — from specialized image processing to LLM-powered prompt generation.
+
+The easiest way to install a community node pack is through the **[Custom Node Manager](/features/workflows/custom-node-manager/)**: paste a Git URL in the **Nodes** sidebar tab and the pack is cloned, loaded, and made available without a restart.
+
+If you prefer to install manually:
+
+
+1. Find a node pack from the [Community Nodes](/features/workflows/community-nodes/) list.
+2. Clone or download the node pack into the `nodes` folder inside your InvokeAI installation directory.
+3. In the Custom Node Manager, click **Reload** (or restart InvokeAI). The new nodes will appear in the node picker.
+
+
+:::note
+`git clone` is preferred over downloading a ZIP — it makes it easy to update node packs later with `git pull`.
+:::
+
+For more details and a full catalog of available community nodes, see the [Community Nodes](/features/workflows/community-nodes/) page.
diff --git a/docs/assets/nodes/groupsallscale.png b/docs/src/content/docs/features/Workflows/assets/groupsallscale.png
similarity index 100%
rename from docs/assets/nodes/groupsallscale.png
rename to docs/src/content/docs/features/Workflows/assets/groupsallscale.png
diff --git a/docs/assets/nodes/groupsconditioning.png b/docs/src/content/docs/features/Workflows/assets/groupsconditioning.png
similarity index 100%
rename from docs/assets/nodes/groupsconditioning.png
rename to docs/src/content/docs/features/Workflows/assets/groupsconditioning.png
diff --git a/docs/assets/nodes/groupscontrol.png b/docs/src/content/docs/features/Workflows/assets/groupscontrol.png
similarity index 100%
rename from docs/assets/nodes/groupscontrol.png
rename to docs/src/content/docs/features/Workflows/assets/groupscontrol.png
diff --git a/docs/assets/nodes/groupsimgvae.png b/docs/src/content/docs/features/Workflows/assets/groupsimgvae.png
similarity index 100%
rename from docs/assets/nodes/groupsimgvae.png
rename to docs/src/content/docs/features/Workflows/assets/groupsimgvae.png
diff --git a/docs/assets/nodes/groupsiterate.png b/docs/src/content/docs/features/Workflows/assets/groupsiterate.png
similarity index 100%
rename from docs/assets/nodes/groupsiterate.png
rename to docs/src/content/docs/features/Workflows/assets/groupsiterate.png
diff --git a/docs/assets/nodes/groupslora.png b/docs/src/content/docs/features/Workflows/assets/groupslora.png
similarity index 100%
rename from docs/assets/nodes/groupslora.png
rename to docs/src/content/docs/features/Workflows/assets/groupslora.png
diff --git a/docs/assets/nodes/groupsmultigenseeding.png b/docs/src/content/docs/features/Workflows/assets/groupsmultigenseeding.png
similarity index 100%
rename from docs/assets/nodes/groupsmultigenseeding.png
rename to docs/src/content/docs/features/Workflows/assets/groupsmultigenseeding.png
diff --git a/docs/assets/nodes/groupsnoise.png b/docs/src/content/docs/features/Workflows/assets/groupsnoise.png
similarity index 100%
rename from docs/assets/nodes/groupsnoise.png
rename to docs/src/content/docs/features/Workflows/assets/groupsnoise.png
diff --git a/docs/assets/nodes/linearview.png b/docs/src/content/docs/features/Workflows/assets/linearview.png
similarity index 100%
rename from docs/assets/nodes/linearview.png
rename to docs/src/content/docs/features/Workflows/assets/linearview.png
diff --git a/docs/assets/nodes/nodescontrol.png b/docs/src/content/docs/features/Workflows/assets/nodescontrol.png
similarity index 100%
rename from docs/assets/nodes/nodescontrol.png
rename to docs/src/content/docs/features/Workflows/assets/nodescontrol.png
diff --git a/docs/assets/nodes/nodesi2i.png b/docs/src/content/docs/features/Workflows/assets/nodesi2i.png
similarity index 100%
rename from docs/assets/nodes/nodesi2i.png
rename to docs/src/content/docs/features/Workflows/assets/nodesi2i.png
diff --git a/docs/assets/nodes/nodest2i.png b/docs/src/content/docs/features/Workflows/assets/nodest2i.png
similarity index 100%
rename from docs/assets/nodes/nodest2i.png
rename to docs/src/content/docs/features/Workflows/assets/nodest2i.png
diff --git a/docs/assets/nodes/workflow_library.png b/docs/src/content/docs/features/Workflows/assets/workflow_library.png
similarity index 100%
rename from docs/assets/nodes/workflow_library.png
rename to docs/src/content/docs/features/Workflows/assets/workflow_library.png
diff --git a/docs/src/content/docs/features/Workflows/comfyui-migration.mdx b/docs/src/content/docs/features/Workflows/comfyui-migration.mdx
new file mode 100644
index 00000000000..164a778925b
--- /dev/null
+++ b/docs/src/content/docs/features/Workflows/comfyui-migration.mdx
@@ -0,0 +1,119 @@
+---
+title: ComfyUI Migration
+lastUpdated: 2026-05-23
+---
+
+import { Card, CardGrid } from '@astrojs/starlight/components';
+
+If you're coming to InvokeAI from ComfyUI, welcome! You'll find things are similar but different - the good news is that you already know how things should work, and it's just a matter of wiring them up!
+
+
+ InvokeAI's nodes tend to be more granular than default nodes in Comfy. This means each node in Invoke will do a specific task, and you might need to use multiple nodes to achieve the same result. The added granularity improves the control you have over your workflows.
+
+
+ InvokeAI's backend and ComfyUI's backend are very different, which means Comfy workflows are not able to be imported directly into InvokeAI. However, we have created a [list of popular workflows](../community-nodes) for you to get started with Nodes in InvokeAI!
+
+
+## Node Equivalents
+
+Finding the right node is the hardest part of switching. Use the categories below to find the InvokeAI equivalents for the ComfyUI nodes you are used to.
+
+### Sampling
+
+| ComfyUI Node | Invoke Equivalent |
+| :--- | :--- |
+| KSampler | Denoise Latents |
+| Ksampler Advanced | Denoise Latents |
+
+### Loaders
+
+| ComfyUI Node | Invoke Equivalent |
+| :--- | :--- |
+| Load Checkpoint | Main Model Loader _or_ SDXL Main Model Loader |
+| Load VAE | VAE Loader |
+| Load Lora | LoRA Loader _or_ SDXL Lora Loader |
+| Load ControlNet Model | ControlNet |
+| Load ControlNet Model (diff) | ControlNet |
+| Load Style Model | Reference Only ControlNet will be coming in a future version of InvokeAI |
+| unCLIPCheckpointLoader | N/A |
+| GLIGENLoader | N/A |
+| Hypernetwork Loader | N/A |
+| Load Upscale Model | Occurs within "Upscale (RealESRGAN)" |
+
+### Conditioning
+
+| ComfyUI Node | Invoke Equivalent |
+| :--- | :--- |
+| CLIP Text Encode (Prompt) | Compel (Prompt) or SDXL Compel (Prompt) |
+| CLIP Set Last Layer | CLIP Skip |
+| Conditioning (Average) | Use the .blend() feature of prompts |
+| Conditioning (Combine) | N/A |
+| Conditioning (Concat) | See the Prompt Tools Community Node |
+| Conditioning (Set Area) | N/A |
+| Conditioning (Set Mask) | Mask Edge |
+| CLIP Vision Encode | N/A |
+| unCLIPConditioning | N/A |
+| Apply ControlNet | ControlNet |
+| Apply ControlNet (Advanced) | ControlNet |
+
+### Latent
+
+| ComfyUI Node | Invoke Equivalent |
+| :--- | :--- |
+| VAE Decode | Latents to Image |
+| VAE Encode | Image to Latents |
+| Empty Latent Image | Noise |
+| Upscale Latent | Resize Latents |
+| Upscale Latent By | Scale Latents |
+| Latent Composite | Blend Latents |
+| LatentCompositeMasked | N/A |
+
+### Image
+
+| ComfyUI Node | Invoke Equivalent |
+| :--- | :--- |
+| Save Image | Image |
+| Preview Image | Current |
+| Load Image | Image |
+| Empty Image | Blank Image |
+| Invert Image | Invert Lerp Image |
+| Batch Images | Link "Image" nodes into an "Image Collection" node |
+| Pad Image for Outpainting | Outpainting is easily accomplished in the Unified Canvas |
+| ImageCompositeMasked | Paste Image |
+| Upscale Image | Resize Image |
+| Upscale Image By | Upscale Image |
+| Upscale Image (using Model) | Upscale Image |
+| ImageBlur | Blur Image |
+| ImageQuantize | N/A |
+| ImageSharpen | N/A |
+| Canny | Canny Processor |
+
+### Mask
+
+| ComfyUI Node | Invoke Equivalent |
+| :--- | :--- |
+| Load Image (as Mask) | Image |
+| Convert Mask to Image | Image |
+| Convert Image to Mask | Image |
+| SolidMask | N/A |
+| InvertMask | Invert Lerp Image |
+| CropMask | Crop Image |
+| MaskComposite | Combine Mask |
+| FeatherMask | Blur Image |
+
+### Advanced
+
+| ComfyUI Node | Invoke Equivalent |
+| :--- | :--- |
+| Load CLIP | Main Model Loader _or_ SDXL Main Model Loader |
+| UNETLoader | Main Model Loader _or_ SDXL Main Model Loader |
+| DualCLIPLoader | Main Model Loader _or_ SDXL Main Model Loader |
+| Load Checkpoint | Main Model Loader _or_ SDXL Main Model Loader |
+| ConditioningZeroOut | N/A |
+| ConditioningSetTimestepRange | N/A |
+| CLIPTextEncodeSDXLRefiner | Compel (Prompt) or SDXL Compel (Prompt) |
+| CLIPTextEncodeSDXL | Compel (Prompt) or SDXL Compel (Prompt) |
+| ModelMergeSimple | Model Merging is available in the Model Manager |
+| ModelMergeBlocks | Model Merging is available in the Model Manager |
+| CheckpointSave | Model saving is available in the Model Manager |
+| CLIPMergeSimple | N/A |
diff --git a/docs/src/content/docs/features/Workflows/community-nodes.mdx b/docs/src/content/docs/features/Workflows/community-nodes.mdx
new file mode 100644
index 00000000000..66ca6bbdf64
--- /dev/null
+++ b/docs/src/content/docs/features/Workflows/community-nodes.mdx
@@ -0,0 +1,731 @@
+---
+title: Community Nodes
+---
+
+These are nodes that have been developed by the community, for the community. If you're not sure what a node is, you can learn more about nodes [here](/concepts/nodes-workflows/).
+
+If you'd like to submit a node for the community, please refer to the [node creation overview](/development/guides/creating-nodes/).
+
+To use a node, add the node to the `nodes` folder found in your InvokeAI install location.
+
+The suggested method is to use `git clone` to clone the repository the node is found in. This allows for easy updates of the node in the future.
+
+If you'd prefer, you can also just download the whole node folder from the linked repository and add it to the `nodes` folder.
+
+To use a community workflow, download the `.json` node graph file and load it into Invoke AI via the **Load Workflow** button in the Workflow Editor.
+
+---
+
+### Anamorphic Tools
+
+**Description:** A set of nodes to perform anamorphic modifications to images, like lens blur, streaks, spherical distortion, and vignetting.
+
+**Node Link:** https://github.com/JPPhoto/anamorphic-tools
+
+---
+
+### Adapters Linked Nodes
+
+**Description:** A set of nodes for linked adapters (ControlNet, IP-Adaptor & T2I-Adapter). This allows multiple adapters to be chained together without using a `collect` node which means it can be used inside an `iterate` node without any collecting on every iteration issues.
+
+- `ControlNet-Linked` - Collects ControlNet info to pass to other nodes.
+- `IP-Adapter-Linked` - Collects IP-Adapter info to pass to other nodes.
+- `T2I-Adapter-Linked` - Collects T2I-Adapter info to pass to other nodes.
+
+Note: These are inherited from the core nodes so any update to the core nodes should be reflected in these.
+
+**Node Link:** https://github.com/skunkworxdark/adapters-linked-nodes
+
+---
+
+### Autostereogram Nodes
+
+**Description:** Generate autostereogram images from a depth map. This is not a very practically useful node but more a 90s nostalgic indulgence as I used to love these images as a kid.
+
+**Node Link:** https://github.com/skunkworxdark/autostereogram_nodes
+
+**Example Usage:**
+
+ -> ->
+
+---
+
+### Average Images
+
+**Description:** This node takes in a collection of images of the same size and averages them as output. It converts everything to RGB mode first.
+
+**Node Link:** https://github.com/JPPhoto/average-images-node
+
+---
+
+### BiRefNet Background Removal
+
+**Description:** Remove image backgrounds using BiRefNet (Bilateral Reference Network), a high-quality segmentation model. Supports multiple model variants including standard, high-resolution, matting, portrait, and specialized models for different use cases.
+
+**Node Link:** https://github.com/veeliks/invoke_birefnet
+
+**Output Examples**
+
+
+
+
+
+
+---
+
+### Clean Image Artifacts After Cut
+
+Description: Removes residual artifacts after an image is separated from its background.
+
+Node Link: https://github.com/VeyDlin/clean-artifact-after-cut-node
+
+View:
+
+
+
+---
+
+### Close Color Mask
+
+Description: Generates a mask for images based on a closely matching color, useful for color-based selections.
+
+Node Link: https://github.com/VeyDlin/close-color-mask-node
+
+View:
+
+
+
+---
+
+### Clothing Mask
+
+Description: Employs a U2NET neural network trained for the segmentation of clothing items in images.
+
+Node Link: https://github.com/VeyDlin/clothing-mask-node
+
+View:
+
+
+
+---
+
+### Contrast Limited Adaptive Histogram Equalization
+
+Description: Enhances local image contrast using adaptive histogram equalization with contrast limiting.
+
+Node Link: https://github.com/VeyDlin/clahe-node
+
+View:
+
+
+
+---
+
+### Curves
+
+**Description:** Adjust an image's curve based on a user-defined string.
+
+**Node Link:** https://github.com/JPPhoto/curves-node
+
+---
+
+### Depth Map from Wavefront OBJ
+
+**Description:** Render depth maps from Wavefront .obj files (triangulated) using this simple 3D renderer utilizing numpy and matplotlib to compute and color the scene. There are simple parameters to change the FOV, camera position, and model orientation.
+
+To be imported, an .obj must use triangulated meshes, so make sure to enable that option if exporting from a 3D modeling program. This renderer makes each triangle a solid color based on its average depth, so it will cause anomalies if your .obj has large triangles. In Blender, the Remesh modifier can be helpful to subdivide a mesh into small pieces that work well given these limitations.
+
+**Node Link:** https://github.com/dwringer/depth-from-obj-node
+
+**Example Usage:**
+
+
+
+---
+
+### Enhance Detail
+
+**Description:** A single node that can enhance the detail in an image. Increase or decrease details in an image using a guided filter (as opposed to the typical Gaussian blur used by most sharpening filters.) Based on the `Enhance Detail` ComfyUI node from https://github.com/spacepxl/ComfyUI-Image-Filters
+
+**Node Link:** https://github.com/skunkworxdark/enhance-detail-node
+
+**Example Usage:**
+
+
+
+---
+
+### Film Grain
+
+**Description:** This node adds a film grain effect to the input image based on the weights, seeds, and blur radii parameters. It works with RGB input images only.
+
+**Node Link:** https://github.com/JPPhoto/film-grain-node
+
+---
+
+### Flip Pose
+
+**Description:** This node will flip an openpose image horizontally, recoloring it to make sure that it isn't facing the wrong direction. Note that it does not work with openpose hands.
+
+**Node Link:** https://github.com/JPPhoto/flip-pose-node
+
+---
+
+### Flux Ideal Size
+
+**Description:** This node returns an ideal size to use for the first stage of a Flux image generation pipeline. Generating at the right size helps limit duplication and odd subject placement.
+
+**Node Link:** https://github.com/JPPhoto/flux-ideal-size
+
+---
+
+### Generative Grammar-Based Prompt Nodes
+
+**Description:** This set of 3 nodes generates prompts from simple user-defined grammar rules (loaded from custom files - examples provided below). The prompts are made by recursively expanding a special template string, replacing nonterminal "parts-of-speech" until no nonterminal terms remain in the string.
+
+This includes 3 Nodes:
+- *Lookup Table from File* - loads a YAML file "prompt" section (or of a whole folder of YAML's) into a JSON-ified dictionary (Lookups output)
+- *Lookups Entry from Prompt* - places a single entry in a new Lookups output under the specified heading
+- *Prompt from Lookup Table* - uses a Collection of Lookups as grammar rules from which to randomly generate prompts.
+
+**Node Link:** https://github.com/dwringer/generative-grammar-prompt-nodes
+
+**Example Usage:**
+
+
+
+---
+
+### GPT2RandomPromptMaker
+
+**Description:** A node for InvokeAI utilizes the GPT-2 language model to generate random prompts based on a provided seed and context.
+
+**Node Link:** https://github.com/mickr777/GPT2RandomPromptMaker
+
+**Output Examples**
+
+Generated Prompt: An enchanted weapon will be usable by any character regardless of their alignment.
+
+
+
+---
+
+### Grid to Gif
+
+**Description:** One node that turns a grid image into an image collection, one node that turns an image collection into a gif.
+
+**Node Link:** https://github.com/mildmisery/invokeai-GridToGifNode/blob/main/GridToGif.py
+
+**Example Node Graph:** https://github.com/mildmisery/invokeai-GridToGifNode/blob/main/Grid%20to%20Gif%20Example%20Workflow.json
+
+**Output Examples**
+
+
+
+
+---
+
+### Halftone
+
+**Description**: Halftone converts the source image to grayscale and then performs halftoning. CMYK Halftone converts the image to CMYK and applies a per-channel halftoning to make the source image look like a magazine or newspaper. For both nodes, you can specify angles and halftone dot spacing.
+
+**Node Link:** https://github.com/JPPhoto/halftone-node
+
+**Example**
+
+Input:
+
+
+
+Halftone Output:
+
+
+
+CMYK Halftone Output:
+
+
+
+---
+
+### Hand Refiner with MeshGraphormer
+
+**Description**: Hand Refiner takes in your image and automatically generates a fixed depth map for the hands along with a mask of the hands region that will conveniently allow you to use them along with ControlNet to fix the wonky hands generated by Stable Diffusion
+
+**Node Link:** https://github.com/blessedcoolant/invoke_meshgraphormer
+
+**View**
+
+
+---
+
+### Image and Mask Composition Pack
+
+**Description:** This is a pack of nodes for composing masks and images, including a simple text mask creator and both image and latent offset nodes. The offsets wrap around, so these can be used in conjunction with the Seamless node to progressively generate centered on different parts of the seamless tiling.
+
+This includes 15 Nodes:
+
+- *Adjust Image Hue Plus* - Rotate the hue of an image in one of several different color spaces.
+- *Blend Latents/Noise (Masked)* - Use a mask to blend part of one latents tensor [including Noise outputs] into another. Can be used to "renoise" sections during a multi-stage [masked] denoising process.
+- *Enhance Image* - Boost or reduce color saturation, contrast, brightness, sharpness, or invert colors of any image at any stage with this simple wrapper for pillow [PIL]'s ImageEnhance module.
+- *Equivalent Achromatic Lightness* - Calculates image lightness accounting for Helmholtz-Kohlrausch effect based on a method described by High, Green, and Nussbaum (2023).
+- *Text to Mask (Clipseg)* - Input a prompt and an image to generate a mask representing areas of the image matched by the prompt.
+- *Text to Mask Advanced (Clipseg)* - Output up to four prompt masks combined with logical "and", logical "or", or as separate channels of an RGBA image.
+- *Image Layer Blend* - Perform a layered blend of two images using alpha compositing. Opacity of top layer is selectable, with optional mask and several different blend modes/color spaces.
+- *Image Compositor* - Take a subject from an image with a flat backdrop and layer it on another image using a chroma key or flood select background removal.
+- *Image Dilate or Erode* - Dilate or expand a mask (or any image!). This is equivalent to an expand/contract operation.
+- *Image Value Thresholds* - Clip an image to pure black/white beyond specified thresholds.
+- *Offset Latents* - Offset a latents tensor in the vertical and/or horizontal dimensions, wrapping it around.
+- *Offset Image* - Offset an image in the vertical and/or horizontal dimensions, wrapping it around.
+- *Rotate/Flip Image* - Rotate an image in degrees clockwise/counterclockwise about its center, optionally resizing the image boundaries to fit, or flipping it about the vertical and/or horizontal axes.
+- *Shadows/Highlights/Midtones* - Extract three masks (with adjustable hard or soft thresholds) representing shadows, midtones, and highlights regions of an image.
+- *Text Mask (simple 2D)* - create and position a white on black (or black on white) line of text using any font locally available to Invoke.
+
+**Node Link:** https://github.com/dwringer/composition-nodes
+
+
+
+---
+
+### Image Dominant Color
+
+Description: Identifies and extracts the dominant color from an image using k-means clustering.
+
+Node Link: https://github.com/VeyDlin/image-dominant-color-node
+
+View:
+
+
+
+---
+
+### Image Export
+
+**Description:** Export images in multiple formats (AVIF, JPEG, PNG, TIFF, WebP) with format-specific compression and quality options.
+
+**Node Link:** https://github.com/veeliks/invoke_image_export
+
+**Nodes:**
+
+
+
+
+
+
+
+
+
+---
+
+### Image to Character Art Image Nodes
+
+**Description:** Group of nodes to convert an input image into ascii/unicode art Image
+
+**Node Link:** https://github.com/mickr777/imagetoasciiimage
+
+**Output Examples**
+
+
+
+
+
+
+
+
+
+---
+
+### Image Picker
+
+**Description:** This InvokeAI node takes in a collection of images and randomly chooses one. This can be useful when you have a number of poses to choose from for a ControlNet node, or a number of input images for another purpose.
+
+**Node Link:** https://github.com/JPPhoto/image-picker-node
+
+---
+
+### Image Resize Plus
+
+Description: Provides various image resizing options such as fill, stretch, fit, center, and crop.
+
+Node Link: https://github.com/VeyDlin/image-resize-plus-node
+
+View:
+
+
+
+---
+
+### Latent Upscale
+
+**Description:** This node uses a small (~2.4mb) model to upscale the latents used in a Stable Diffusion 1.5 or Stable Diffusion XL image generation, rather than the typical interpolation method, avoiding the traditional downsides of the latent upscale technique.
+
+**Node Link:** [https://github.com/gogurtenjoyer/latent-upscale](https://github.com/gogurtenjoyer/latent-upscale)
+
+---
+
+### Load Video Frame
+
+**Description:** This is a video frame image provider + indexer/video creation nodes for hooking up to iterators and ranges and ControlNets and such for invokeAI node experimentation. Think animation + ControlNet outputs.
+
+**Node Link:** https://github.com/helix4u/load_video_frame
+
+**Output Example:**
+
+
+
+---
+### Make 3D
+
+**Description:** Create compelling 3D stereo images from 2D originals.
+
+**Node Link:** [https://gitlab.com/srcrr/shift3d/-/raw/main/make3d.py](https://gitlab.com/srcrr/shift3d)
+
+**Example Node Graph:** https://gitlab.com/srcrr/shift3d/-/raw/main/example-workflow.json?ref_type=heads&inline=false
+
+**Output Examples**
+
+
+
+
+---
+
+### Mask Operations
+
+Description: Offers logical operations (OR, SUB, AND) for combining and manipulating image masks.
+
+Node Link: https://github.com/VeyDlin/mask-operations-node
+
+View:
+
+
+
+---
+
+### Match Histogram
+
+**Description:** An InvokeAI node to match a histogram from one image to another. This is a bit like the `color correct` node in the main InvokeAI but this works in the YCbCr colourspace and can handle images of different sizes. Also does not require a mask input.
+- Option to only transfer luminance channel.
+- Option to save output as grayscale
+
+A good use case for this node is to normalize the colors of an image that has been through the tiled scaling workflow of my XYGrid Nodes.
+
+See full docs here: https://github.com/skunkworxdark/Prompt-tools-nodes/edit/main/README.md
+
+**Node Link:** https://github.com/skunkworxdark/match_histogram
+
+**Output Examples**
+
+
+
+---
+
+### Metadata Linked Nodes
+
+**Description:** A set of nodes for Metadata. Collect Metadata from within an `iterate` node & extract metadata from an image.
+
+- `Metadata Item Linked` - Allows collecting of metadata while within an iterate node with no need for a collect node or conversion to metadata node
+- `Metadata From Image` - Provides Metadata from an image
+- `Metadata To String` - Extracts a String value of a label from metadata
+- `Metadata To Integer` - Extracts an Integer value of a label from metadata
+- `Metadata To Float` - Extracts a Float value of a label from metadata
+- `Metadata To Scheduler` - Extracts a Scheduler value of a label from metadata
+- `Metadata To Bool` - Extracts Bool types from metadata
+- `Metadata To Model` - Extracts model types from metadata
+- `Metadata To SDXL Model` - Extracts SDXL model types from metadata
+- `Metadata To LoRAs` - Extracts Loras from metadata.
+- `Metadata To SDXL LoRAs` - Extracts SDXL Loras from metadata
+- `Metadata To ControlNets` - Extracts ControNets from metadata
+- `Metadata To IP-Adapters` - Extracts IP-Adapters from metadata
+- `Metadata To T2I-Adapters` - Extracts T2I-Adapters from metadata
+- `Denoise Latents + Metadata` - This is an inherited version of the existing `Denoise Latents` node but with a metadata input and output.
+
+**Node Link:** https://github.com/skunkworxdark/metadata-linked-nodes
+
+---
+
+### Negative Image
+
+Description: Creates a negative version of an image, effective for visual effects and mask inversion.
+
+Node Link: https://github.com/VeyDlin/negative-image-node
+
+View:
+
+
+
+---
+
+### Nightmare Promptgen
+
+**Description:** Nightmare Prompt Generator - Uses a local text generation model to create unique imaginative (but usually nightmarish) prompts for InvokeAI. By default, it allows you to choose from some gpt-neo models I finetuned on over 2500 of my own InvokeAI prompts in Compel format, but you're able to add your own, as well. Offers support for replacing any troublesome words with a random choice from list you can also define.
+
+**Node Link:** [https://github.com/gogurtenjoyer/nightmare-promptgen](https://github.com/gogurtenjoyer/nightmare-promptgen)
+
+---
+
+### Ollama Node
+
+**Description:** Uses Ollama API to expand text prompts for text-to-image generation using local LLMs. Works great for expanding basic prompts into detailed natural language prompts for Flux. Also provides a toggle to unload the LLM model immediately after expanding, to free up VRAM for Invoke to continue the image generation workflow.
+
+**Node Link:** https://github.com/Jonseed/Ollama-Node
+
+**Example Node Graph:** https://github.com/Jonseed/Ollama-Node/blob/main/Ollama-Node-Flux-example.json
+
+**View:**
+
+
+
+---
+
+### One Button Prompt
+
+
+
+**Description:** an extensive suite of auto prompt generation and prompt helper nodes based on extensive logic. Get creative with the best prompt generator in the world.
+
+The main node generates interesting prompts based on a set of parameters. There are also some additional nodes such as Auto Negative Prompt, One Button Artify, Create Prompt Variant and other cool prompt toys to play around with.
+
+**Node Link:** [https://github.com/AIrjen/OneButtonPrompt_X_InvokeAI](https://github.com/AIrjen/OneButtonPrompt_X_InvokeAI)
+
+**Nodes:**
+
+
+
+---
+
+### Oobabooga
+
+**Description:** asks a local LLM running in Oobabooga's Text-Generation-Webui to write a prompt based on the user input.
+
+**Link:** https://github.com/sammyf/oobabooga-node
+
+**Example:**
+
+"describe a new mystical creature in its natural environment"
+
+*can return*
+
+"The mystical creature I am describing to you is called the "Glimmerwing". It is a majestic, iridescent being that inhabits the depths of the most enchanted forests and glimmering lakes. Its body is covered in shimmering scales that reflect every color of the rainbow, and it has delicate, translucent wings that sparkle like diamonds in the sunlight. The Glimmerwing's home is a crystal-clear lake, surrounded by towering trees with leaves that shimmer like jewels. In this serene environment, the Glimmerwing spends its days swimming gracefully through the water, chasing schools of glittering fish and playing with the gentle ripples of the lake's surface.
+As the sun sets, the Glimmerwing perches on a branch of one of the trees, spreading its wings to catch the last rays of light. The creature's scales glow softly, casting a rainbow of colors across the forest floor. The Glimmerwing sings a haunting melody, its voice echoing through the stillness of the night air. Its song is said to have the power to heal the sick and bring peace to troubled souls. Those who are lucky enough to hear the Glimmerwing's song are forever changed by its beauty and grace."
+
+
+
+**Requirement**
+
+a Text-Generation-Webui instance (might work remotely too, but I never tried it) and obviously InvokeAI 3.x
+
+**Note**
+
+This node works best with SDXL models, especially as the style can be described independently of the LLM's output.
+
+---
+
+### Prompt Tools
+
+**Description:** A set of InvokeAI nodes that add general prompt (string) manipulation tools. Designed to accompany the `Prompts From File` node and other prompt generation nodes.
+
+1. `Prompt To File` - saves a prompt or collection of prompts to a file. one per line. There is an append/overwrite option.
+2. `PTFields Collect` - Converts image generation fields into a Json format string that can be passed to Prompt to file.
+3. `PTFields Expand` - Takes Json string and converts it to individual generation parameters. This can be fed from the Prompts to file node.
+4. `Prompt Strength` - Formats prompt with strength like the weighted format of compel
+5. `Prompt Strength Combine` - Combines weighted prompts for .and()/.blend()
+6. `CSV To Index String` - Gets a string from a CSV by index. Includes a Random index option
+
+The following Nodes are now included in v3.2 of Invoke and are no longer in this set of tools.
+
+- `Prompt Join` -> `String Join`
+- `Prompt Join Three` -> `String Join Three`
+- `Prompt Replace` -> `String Replace`
+- `Prompt Split Neg` -> `String Split Neg`
+
+
+See full docs here: https://github.com/skunkworxdark/Prompt-tools-nodes/edit/main/README.md
+
+**Node Link:** https://github.com/skunkworxdark/Prompt-tools-nodes
+
+**Workflow Examples**
+
+
+
+---
+
+### Remote Image
+
+**Description:** This is a pack of nodes to interoperate with other services, be they public websites or bespoke local servers. The pack consists of these nodes:
+
+- *Load Remote Image* - Lets you load remote images such as a realtime webcam image, an image of the day, or dynamically created images.
+- *Post Image to Remote Server* - Lets you upload an image to a remote server using an HTTP POST request, eg for storage, display or further processing.
+
+**Node Link:** https://github.com/fieldOfView/InvokeAI-remote_image
+
+---
+
+### BriaAI Remove Background
+
+**Description**: Implements one click background removal with BriaAI's new version 1.4 model which seems to be producing better results than any other previous background removal tool.
+
+**Node Link:** https://github.com/blessedcoolant/invoke_bria_rmbg
+
+**View**
+
+
+---
+
+### Remove Background
+
+Description: An integration of the rembg package to remove backgrounds from images using multiple U2NET models.
+
+Node Link: https://github.com/VeyDlin/remove-background-node
+
+View:
+
+
+
+---
+
+### Retroize
+
+**Description:** Retroize is a collection of nodes for InvokeAI to "Retroize" images. Any image can be given a fresh coat of retro paint with these nodes, either from your gallery or from within the graph itself. It includes nodes to pixelize, quantize, palettize, and ditherize images; as well as to retrieve palettes from existing images.
+
+**Node Link:** https://github.com/Ar7ific1al/invokeai-retroizeinode/
+
+**Retroize Output Examples**
+
+
+
+---
+
+### Stereogram Nodes
+
+**Description:** A set of custom nodes for InvokeAI to create cross-view or parallel-view stereograms. Stereograms are 2D images that, when viewed properly, reveal a 3D scene. Check out [r/crossview](https://www.reddit.com/r/CrossView/) for tutorials.
+
+**Node Link:** https://github.com/simonfuhrmann/invokeai-stereo
+
+**Example Workflow and Output**
+
+
+
+---
+
+### Simple Skin Detection
+
+Description: Detects skin in images based on predefined color thresholds.
+
+Node Link: https://github.com/VeyDlin/simple-skin-detection-node
+
+View:
+
+
+
+---
+
+### Size Stepper Nodes
+
+**Description:** This is a set of nodes for calculating the necessary size increments for doing upscaling workflows. Use the *Final Size & Orientation* node to enter your full size dimensions and orientation (portrait/landscape/random), then plug that and your initial generation dimensions into the *Ideal Size Stepper* and get 1, 2, or 3 intermediate pairs of dimensions for upscaling. Note this does not output the initial size or full size dimensions: the 1, 2, or 3 outputs of this node are only the intermediate sizes.
+
+A third node is included, *Random Switch (Integers)*, which is just a generic version of Final Size with no orientation selection.
+
+**Node Link:** https://github.com/dwringer/size-stepper-nodes
+
+**Example Usage:**
+
+
+
+---
+
+### Text font to Image
+
+**Description:** text font to text image node for InvokeAI, download a font to use (or if in font cache uses it from there), the text is always resized to the image size, but can control that with padding, optional 2nd line
+
+**Node Link:** https://github.com/mickr777/textfontimage
+
+**Output Examples**
+
+
+
+Results after using the depth controlnet
+
+
+
+
+
+---
+
+### Thresholding
+
+**Description:** This node generates masks for highlights, midtones, and shadows given an input image. You can optionally specify a blur for the lookup table used in making those masks from the source image.
+
+**Node Link:** https://github.com/JPPhoto/thresholding-node
+
+**Examples**
+
+Input:
+
+
+
+Highlights/Midtones/Shadows:
+
+
+
+
+
+Highlights/Midtones/Shadows (with LUT blur enabled):
+
+
+
+
+
+---
+
+### Unsharp Mask
+
+**Description:** Applies an unsharp mask filter to an image, preserving its alpha channel in the process.
+
+**Node Link:** https://github.com/JPPhoto/unsharp-mask-node
+
+---
+
+### XY Image to Grid and Images to Grids nodes
+
+**Description:** These nodes add the following to InvokeAI:
+- Generate grids of images from multiple input images
+- Create XY grid images with labels from parameters
+- Split images into overlapping tiles for processing (for super-resolution workflows)
+- Recombine image tiles into a single output image blending the seams
+
+The nodes include:
+1. `Images To Grids` - Combine multiple images into a grid of images
+2. `XYImage To Grid` - Take X & Y params and creates a labeled image grid.
+3. `XYImage Tiles` - Super-resolution (embiggen) style tiled resizing
+4. `Image Tot XYImages` - Takes an image and cuts it up into a number of columns and rows.
+5. Multiple supporting nodes - Helper nodes for data wrangling and building `XYImage` collections
+
+See full docs here: https://github.com/skunkworxdark/XYGrid_nodes/edit/main/README.md
+
+**Node Link:** https://github.com/skunkworxdark/XYGrid_nodes
+
+**Output Examples**
+
+
+
+---
+
+### Example Node Template
+
+**Description:** This node allows you to do super cool things with InvokeAI.
+
+**Node Link:** https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/app/invocations/prompt.py
+
+**Example Workflow:** https://github.com/invoke-ai/InvokeAI/blob/docs/main/docs/workflows/Prompt_from_File.json
+
+**Output Examples**
+
+
+
+
+## Disclaimer
+
+The nodes linked have been developed and contributed by members of the Invoke AI community. While we strive to ensure the quality and safety of these contributions, we do not guarantee the reliability or security of the nodes. If you have issues or concerns with any of the nodes below, please raise it on GitHub or in the Discord.
+
+
+## Help
+If you run into any issues with a node, please post in the [InvokeAI Discord](https://discord.gg/ZmtBAhwWhy).
diff --git a/docs/src/content/docs/features/Workflows/custom-node-manager.mdx b/docs/src/content/docs/features/Workflows/custom-node-manager.mdx
new file mode 100644
index 00000000000..ab42b73e5a6
--- /dev/null
+++ b/docs/src/content/docs/features/Workflows/custom-node-manager.mdx
@@ -0,0 +1,76 @@
+---
+title: Custom Node Manager
+sidebar:
+ order: 5
+---
+
+import { Steps } from '@astrojs/starlight/components';
+
+The Custom Node Manager installs, updates, and removes community node packs directly from the InvokeAI UI — no manual file copying, no restart required.
+
+## Opening the Custom Node Manager
+
+Click the **Nodes** tab (circuit icon) in the left sidebar, between **Models** and **Queue**.
+
+The page is split into two panels:
+
+- **Left:** the list of installed node packs, with each pack's node count, type badges, and on-disk path.
+- **Right:** the install UI, with tabs for **Git Repository URL** and **Scan Folder**, plus an install log at the bottom.
+
+## Installing a node pack
+
+
+1. On the right panel, choose the **Git Repository URL** tab.
+2. Paste the Git URL of the pack, e.g. `https://github.com/user/my-node-pack.git`.
+3. Click **Install**.
+
+
+What happens during install:
+
+- The repo is cloned into your `nodes` directory.
+- The nodes are loaded into the running InvokeAI process immediately — **no restart needed**.
+- Any workflow `.json` files found in the repo are imported into your workflow library and tagged with `node-pack:` so you can filter for them.
+- The install log at the bottom of the panel shows the result for each step.
+
+:::caution[Security]
+Custom nodes execute arbitrary Python on your machine. **Only install node packs from authors you trust.** A malicious pack could harm your system or exfiltrate data.
+:::
+
+### Python dependencies
+
+The Custom Node Manager **does not** automatically run `pip install` for a pack's `requirements.txt` or `pyproject.toml`. Auto-installing into the running InvokeAI environment risks pulling in incompatible package versions and breaking the application.
+
+If a pack ships extra dependencies, you'll see a warning toast after installation. Install them yourself — typically `pip install -r requirements.txt` from inside an activated InvokeAI environment, but check the pack's README first. After installing, click **Reload** so the new dependencies take effect.
+
+## Managing installed packs
+
+Each entry in the left panel has actions for managing the pack:
+
+- **Reload** — re-scans the `nodes` directory. Use this after manually adding a pack via `git clone`, or after installing extra Python dependencies.
+- **Uninstall** — removes the pack from disk, unregisters its nodes from the running process, and removes any workflows that were imported from the pack. No restart needed.
+
+## Scan Folder tab
+
+The **Scan Folder** tab shows the path of your `nodes` directory. Anything placed there manually (for example, by `git clone`-ing a pack directly) is detected automatically at startup. Use **Reload** to pick up packs added at runtime.
+
+## Troubleshooting
+
+### Install fails
+
+- Confirm the Git URL is correct and reachable.
+- The repo must contain an `__init__.py` at its root.
+- Read the install log — it surfaces the underlying error.
+
+### Nodes don't appear after install
+
+- Click **Reload**.
+- Check that the pack's `__init__.py` imports the node classes.
+- Check the server console for import errors.
+
+### Workflows show errors after uninstalling
+
+User-created workflows that reference nodes from an uninstalled pack will show errors for the missing node types. Either reinstall the pack or remove the affected nodes from the workflow.
+
+## Authoring a node pack
+
+If you want to publish your own pack so it can be installed by URL, see the [Creating a Node Pack](/development/guides/creating-nodes/) developer guide for the required repository layout, `__init__.py` requirements, and conventions for shipping workflows alongside your nodes.
diff --git a/docs/src/content/docs/features/Workflows/editor-interface.mdx b/docs/src/content/docs/features/Workflows/editor-interface.mdx
new file mode 100644
index 00000000000..bce33485ad6
--- /dev/null
+++ b/docs/src/content/docs/features/Workflows/editor-interface.mdx
@@ -0,0 +1,141 @@
+---
+title: Editor Interface
+description: Learn how to use the Workflow Editor in InvokeAI.
+sidebar:
+ order: 2
+lastUpdated: 2026-02-20
+---
+
+import { Card, CardGrid, Steps, Tabs, TabItem } from '@astrojs/starlight/components';
+
+The workflow editor is a blank canvas allowing for the use of individual functions and image transformations to control the image generation workflow. Nodes take in inputs on the left side of the node, and return an output on the right side of the node.
+
+A node graph is composed of multiple nodes that are connected together to create a workflow. Nodes' inputs and outputs are connected by dragging connectors from node to node. Inputs and outputs are color-coded for ease of use.
+
+:::tip[New to Diffusion?]
+If you're not familiar with Diffusion, take a look at our [Diffusion Overview](../../concepts/diffusion). Understanding how diffusion works will enable you to more easily use the Workflow Editor and build workflows to suit your needs.
+:::
+
+## Features
+
+
+ Save workflows to the Invoke database, allowing you to easily create, modify, and share workflows as needed. A curated set of default workflows is provided to help explain important node usage.
+
+ 
+
+ The library has two views:
+
+ - **Browse Workflows** lists curated default workflows, filterable by a fixed set of category tags.
+ - **Your Workflows** lists workflows you have saved. The tag filter here is **dynamic** — it shows every unique tag found across your own workflows, with a count per tag.
+
+ Add comma-separated tags to a workflow (e.g. `portrait, SDXL, upscaling`) when saving it. The tags appear at the bottom of each workflow tile in the library and become selectable filters in the sidebar. Click one or more tags to narrow the list; click **Your Workflows** to clear the filter and show everything again. Tag counts update automatically when you create, edit, or delete a workflow.
+
+
+ Create a custom UI for your workflow, making it easier to iterate on your generations. The Linear UI View is saved alongside the workflow, allowing you to share workflows and enable others to use them.
+
+
+ 1. Right-click on any **input label** on a node.
+ 2. Select **"Add to Linear View"**.
+ 3. The input will now appear in your Linear View panel!
+
+
+ 
+
+
+ Any node or input field can be renamed in the workflow editor. If the input field you have renamed has been added to the Linear View, the changed name will be reflected in both places.
+
+
+ Nodes have a **"Use Cache"** option in their footer. This allows for performance improvements by reusing previously cached values during workflow processing.
+
+
+### Managing Nodes
+
+Use these quick keyboard shortcuts to navigate and manage your workflow efficiently:
+
+
+
+ Ctrl + C (or Cmd + C)
+
+
+ Ctrl + V (or Cmd + V)
+
+
+ Shift + Click & Drag
+
+
+ Backspace / Delete
+
+
+
+## Important Nodes & Concepts
+
+There are several node grouping concepts that can be examined with a narrow focus. These (and other) groupings can be pieced together to make up functional graph setups, and are important to understanding how groups of nodes work together as part of a whole.
+
+:::note
+The screenshots below aren't examples of complete functioning node graphs, but rather snippets demonstrating specific concepts.
+:::
+
+
+
+ ### Create Latent Noise
+ An initial noise tensor is necessary for the latent diffusion process. As a result, the Denoising node requires a noise node input.
+
+ The standard **Create Latent Noise** node now includes a **Noise Type** selector for architecture-specific latent
+ shapes. Leave it at **SD** for classic 4-channel Stable Diffusion workflows, or switch it to the architecture that
+ matches the downstream denoiser when working with models like FLUX, FLUX.2, SD3, CogView4, Z-Image, or Anima.
+
+ 
+
+ ### Text Prompt Conditioning
+ Conditioning is necessary for the latent diffusion process, whether empty or not. As a result, the Denoising node requires positive and negative conditioning inputs. Conditioning is reliant on a CLIP text encoder provided by the Model Loader node.
+
+ 
+
+
+
+ ### Image to Latents & VAE
+ The **ImageToLatents** node takes in a pixel image and a VAE and outputs latents. The **LatentsToImage** node does the opposite, taking in latents and a VAE and outputs a pixel image.
+
+ 
+
+ ### Scaling
+ Use the **ImageScale**, **ScaleLatents**, and **Upscale** nodes to upscale images and/or latent images. Upscaling is the process of enlarging an image and adding more detail.
+
+ The chosen method differs across contexts. However, be aware that latents are already noisy and compressed at their original resolution; scaling an image could produce more detailed results.
+
+ 
+
+
+
+ ### ControlNet
+ The **ControlNet** node outputs a Control, which can be provided as input to a Denoise Latents node. Depending on the type of ControlNet desired, ControlNet nodes usually require an image processor node, such as a Canny Processor or Depth Processor, which prepares an input image for use with ControlNet.
+
+ 
+
+ ### LoRA
+ The **Lora Loader** node lets you load a LoRA and pass it as output. A LoRA provides fine-tunes to the UNet and text encoder weights that augment the base model’s image and text vocabularies.
+
+ 
+
+
+
+ ### Defined & Random Seeds
+ It is common to want to use both the same seed (for continuity) and random seeds (for variety). To define a seed, simply enter it into the **'Seed'** field on a noise node. Conversely, the **RandomInt** node generates a random integer between 'Low' and 'High', and can be used as input to the 'Seed' edge point on a noise node to randomize your seed.
+
+ 
+
+ ### Iteration + Multiple Images as Input
+ Iteration is a common concept in any processing, and means to repeat a process with given input. In nodes, you're able to use the **Iterate** node to iterate through collections usually gathered by the **Collect** node.
+
+ The Iterate node has many potential uses, from processing a collection of images one after another, to varying seeds across multiple image generations and more. This screenshot demonstrates how to collect several images and use them in an image generation workflow.
+
+ 
+
+ ### Batch / Multiple Image Generation
+ Batch or multiple image generation in the workflow editor is done using the **RandomRange** node. In this case, the 'Size' field represents the number of images to generate, meaning this example will generate 4 images.
+
+ As RandomRange produces a collection of integers, we need to add the Iterate node to iterate through the collection. This noise can then be fed to the Denoise Latents node for it to iterate through the denoising process with the different seeds provided.
+
+ 
+
+
diff --git a/docs/src/content/docs/features/Workflows/face-tools.mdx b/docs/src/content/docs/features/Workflows/face-tools.mdx
new file mode 100644
index 00000000000..95959d158fd
--- /dev/null
+++ b/docs/src/content/docs/features/Workflows/face-tools.mdx
@@ -0,0 +1,94 @@
+---
+title: Face Tools Nodes
+---
+
+The Face Tools nodes detect faces with MediaPipe and provide utilities for identifying, masking, and extracting faces in workflows. The current nodes are in the `segmentation` category and use version `1.2.2`.
+
+## FaceIdentifier
+
+**FaceIdentifier** outputs a copy of the input image with detected face IDs printed on each face. Use it first when you need to target a specific face with FaceMask or FaceOff.
+
+Face IDs are numbered from `0`. Detection order can change if the image changes, so run FaceIdentifier again after editing an image.
+
+### Inputs
+
+| Input | Description |
+| --- | --- |
+| Image | Image to face detect. |
+| Minimum Confidence | Minimum confidence for face detection. Lower this if detection is failing. |
+| Chunk | Bypass full-image face detection and use chunking. Chunking is also used automatically if no faces are found in the full image. |
+
+### Outputs
+
+| Output | Description |
+| --- | --- |
+| Image | The input image with face ID numbers drawn on detected faces. |
+| Width | Output image width in pixels. |
+| Height | Output image height in pixels. |
+
+## FaceMask
+
+**FaceMask** creates a mask for detected faces on the input image.
+
+Leave **Face IDs** empty to mask all detected faces, or provide a comma-separated list such as `0,2,7` to target specific faces. Use FaceIdentifier to find the IDs.
+
+The mask can be adjusted with X and Y offsets if detection is slightly too large or small. Enable **Invert Mask** to affect everything except the detected faces.
+
+### Inputs
+
+| Input | Description |
+| --- | --- |
+| Image | Image to face detect. |
+| Face IDs | Comma-separated list of face IDs to mask. Leave empty to mask all detected faces. |
+| Minimum Confidence | Minimum confidence for face detection. Lower this if detection is failing. |
+| X Offset | Offset for the X-axis of the face mask. |
+| Y Offset | Offset for the Y-axis of the face mask. |
+| Chunk | Bypass full-image face detection and use chunking. Chunking is also used automatically if no faces are found in the full image. |
+| Invert Mask | Toggle to invert the mask. |
+
+### Outputs
+
+| Output | Description |
+| --- | --- |
+| Image | The original image, converted to RGBA. |
+| Width | Output image width in pixels. |
+| Height | Output image height in pixels. |
+| Mask | The generated face mask. |
+
+## FaceOff
+
+**FaceOff** extracts a single detected face into a bounded image and returns a matching mask plus paste coordinates. Use FaceIdentifier to find the face ID before targeting a specific face.
+
+Padding expands the bounding box around the detected face. This gives downstream processing more context and increases the bounded image size while keeping the face in place within the crop.
+
+### Inputs
+
+| Input | Description |
+| --- | --- |
+| Image | Image for face detection. |
+| Face ID | The face ID to process, numbered from `0`. Multiple faces are not supported. |
+| Minimum Confidence | Minimum confidence for face detection. Lower this if detection is failing. |
+| X Offset | X-axis offset of the mask. |
+| Y Offset | Y-axis offset of the mask. |
+| Padding | All-axis padding around the mask in pixels. |
+| Chunk | Bypass full-image face detection and use chunking. Chunking is also used automatically if no faces are found in the full image. |
+
+### Outputs
+
+| Output | Description |
+| --- | --- |
+| Image | The bounded face image. If no face is found, the original image passes through. |
+| Width | Output image width in pixels. |
+| Height | Output image height in pixels. |
+| Mask | Mask matching the bounded image. |
+| X | X coordinate of the bounding box's left side. |
+| Y | Y coordinate of the bounding box's top side. |
+
+## Tips
+
+- Use the same **Minimum Confidence** value in FaceIdentifier and the FaceMask or FaceOff node that consumes the IDs.
+- Enable **Chunk** if not all target faces are detected. Full-image detection and chunked detection can produce different results.
+- Lower **Minimum Confidence** when detection fails, but watch for false positives.
+- Adjust X and Y offsets if the mask is too large, too small, or shifted.
+- Add FaceOff padding when the extracted face needs more surrounding context.
+- Face detection can fail on heavy face paint, hair covering the face, extreme angles, or other obstructions.
diff --git a/docs/src/content/docs/features/Workflows/index.mdx b/docs/src/content/docs/features/Workflows/index.mdx
new file mode 100644
index 00000000000..0ce8b49de82
--- /dev/null
+++ b/docs/src/content/docs/features/Workflows/index.mdx
@@ -0,0 +1,31 @@
+---
+title: Using Workflows
+sidebar:
+ order: 1
+---
+
+import { LinkCard, CardGrid } from '@astrojs/starlight/components';
+
+Workflows allow you to link multiple **Nodes** together to create custom, repeatable image generation processes. By connecting the outputs of some nodes to the inputs of others, you can build complex functionality tailored to your specific needs.
+
+## The Node Editor
+
+With nodes, you can easily extend the image generation capabilities of InvokeAI. All InvokeAI features are added through nodes.
+
+You can read more about nodes and how to use the node editor by checking out the detailed node documentation:
+
+
+
+## Downloading New Nodes
+
+To download a new node and enhance your workflows with new features, visit our list of Community Nodes. These are nodes that have been created by the community, for the community.
+
+
diff --git a/docs/assets/gallery/board_settings.png b/docs/src/content/docs/features/assets/board_settings.png
similarity index 100%
rename from docs/assets/gallery/board_settings.png
rename to docs/src/content/docs/features/assets/board_settings.png
diff --git a/docs/assets/gallery/board_tabs.png b/docs/src/content/docs/features/assets/board_tabs.png
similarity index 100%
rename from docs/assets/gallery/board_tabs.png
rename to docs/src/content/docs/features/assets/board_tabs.png
diff --git a/docs/assets/gallery/board_thumbnails.png b/docs/src/content/docs/features/assets/board_thumbnails.png
similarity index 100%
rename from docs/assets/gallery/board_thumbnails.png
rename to docs/src/content/docs/features/assets/board_thumbnails.png
diff --git a/docs/assets/gallery/gallery.png b/docs/src/content/docs/features/assets/gallery.png
similarity index 100%
rename from docs/assets/gallery/gallery.png
rename to docs/src/content/docs/features/assets/gallery.png
diff --git a/docs/assets/gallery/image_menu.png b/docs/src/content/docs/features/assets/image_menu.png
similarity index 100%
rename from docs/assets/gallery/image_menu.png
rename to docs/src/content/docs/features/assets/image_menu.png
diff --git a/docs/assets/gallery/info_button.png b/docs/src/content/docs/features/assets/info_button.png
similarity index 100%
rename from docs/assets/gallery/info_button.png
rename to docs/src/content/docs/features/assets/info_button.png
diff --git a/docs/assets/gallery/thumbnail_menu.png b/docs/src/content/docs/features/assets/thumbnail_menu.png
similarity index 100%
rename from docs/assets/gallery/thumbnail_menu.png
rename to docs/src/content/docs/features/assets/thumbnail_menu.png
diff --git a/docs/assets/gallery/top_controls.png b/docs/src/content/docs/features/assets/top_controls.png
similarity index 100%
rename from docs/assets/gallery/top_controls.png
rename to docs/src/content/docs/features/assets/top_controls.png
diff --git a/docs/src/content/docs/features/custom-node-manager.mdx b/docs/src/content/docs/features/custom-node-manager.mdx
new file mode 100644
index 00000000000..d91f4d82641
--- /dev/null
+++ b/docs/src/content/docs/features/custom-node-manager.mdx
@@ -0,0 +1,91 @@
+---
+title: Custom Node Manager
+lastUpdated: 2026-05-23
+sidebar:
+ order: 4
+---
+
+import { Steps } from '@astrojs/starlight/components'
+
+The Custom Node Manager allows you to install, manage, and remove community node packs directly from the InvokeAI UI — no manual file copying required.
+
+## Accessing the Node Manager
+
+Click the **Nodes** tab (circuit icon) in the left sidebar, between Models and Queue.
+
+## Installing a Node Pack
+
+
+ 1. Navigate to the **Nodes** tab
+ 2. On the right panel, select the **Git Repository URL** tab
+ 3. Paste the Git URL of the node pack (e.g. `https://github.com/user/my-node-pack.git`)
+ 4. Click **Install**
+
+
+The installer will:
+
+- Clone the repository into your `nodes` directory
+- Load the nodes immediately — no restart needed
+- Import any workflow `.json` files found in the repository into your workflow library (tagged with `node-pack:` for easy filtering)
+
+The install progress and results are shown in the **Install Log** at the bottom of the panel.
+
+### Installing Python Dependencies
+
+The installer does **not** automatically run `pip install` for `requirements.txt` or `pyproject.toml`. Auto-installing dependencies into the running InvokeAI environment can pull in incompatible package versions and break the application.
+
+If a node pack ships a `requirements.txt` or `pyproject.toml`, you'll see a warning toast after installation. Install the dependencies yourself by following the instructions in the node pack's documentation (typically `pip install -r requirements.txt` from inside an activated InvokeAI environment, but check the pack's README first). After installing, click the **Reload** button so the new dependencies take effect.
+
+### Security Warning
+
+Custom nodes execute arbitrary Python code on your system. **Only install node packs from authors you trust.** Malicious nodes could harm your system or compromise your data.
+
+## Managing Installed Nodes
+
+The left panel shows all installed node packs with:
+
+- **Pack name**
+- **Number of nodes** provided
+- **Individual node types** as badges
+- **File path** on disk
+
+### Reloading Nodes
+
+Click the **Reload** button to re-scan the nodes directory. This picks up any node packs that were manually added to the directory without using the installer.
+
+### Uninstalling a Node Pack
+
+Click the **Uninstall** button on any node pack. This will:
+
+- Remove the node pack directory
+- Unregister the nodes from the system immediately
+- Remove any workflows that were imported from the pack
+- Update the workflow editor so the nodes are no longer available
+
+No restart is required.
+
+## Scan Folder Tab
+
+The **Scan Folder** tab shows the location of your nodes directory. Node packs placed there manually (e.g. via `git clone`) are automatically detected at startup. Use the **Reload** button to detect newly added packs without restarting.
+
+## Troubleshooting
+
+### Node pack fails to install
+
+
+ 1. Verify the Git URL is correct and accessible
+ 2. Check that the repository contains an `__init__.py` file at the top level
+ 3. Review the Install Log for error details
+
+
+### Nodes don't appear after install
+
+
+ 1. Click the **Reload** button
+ 2. Check that the node pack's `__init__.py` imports its node classes
+ 3. Check the server console for error messages
+
+
+### Workflows show errors after uninstalling
+
+If you have user-created workflows that reference nodes from an uninstalled pack, those workflows will show errors for the missing node types. Reinstall the pack or remove the affected nodes from the workflow.
diff --git a/docs/src/content/docs/features/gallery.mdx b/docs/src/content/docs/features/gallery.mdx
new file mode 100644
index 00000000000..b48f3c19176
--- /dev/null
+++ b/docs/src/content/docs/features/gallery.mdx
@@ -0,0 +1,139 @@
+---
+title: Gallery Panel
+description: Learn how to manage, organize, and use your generated images and assets with the Gallery Panel in InvokeAI.
+lastUpdated: 2026-02-19
+sidebar:
+ order: 1
+---
+
+import { Card, CardGrid, Steps } from '@astrojs/starlight/components';
+
+The Gallery Panel is a fast way to review, find, and make use of images you've generated and loaded. The Gallery is divided into **Boards**. The *Uncategorized* board is always present, but you can create your own for better organization.
+
+
+
+---
+
+## Board Display and Settings
+
+At the very top of the Gallery Panel, you will find the board disclosure and settings buttons.
+
+
+
+The **disclosure button** shows the name of the currently selected board and allows you to toggle the visibility of the board thumbnails.
+
+
+
+The **settings button** opens a list of customization options:
+
+
+
+- **Image Size:** A slider that lets you control the size of the image previews in the gallery.
+- **Auto-Switch to New Images:** When enabled, newly generated images will automatically load into the current image panel (on the Text to Image tab) or the result panel (on the Image to Image tab). This happens invisibly even if you are on a different tab during generation.
+- **Auto-Assign Board on Click:** Whenever an image is generated or saved, it is placed into a board. The destination board is marked with an `AUTO` badge.
+ - *When enabled:* The board selected at the moment you click **Invoke** becomes the destination. This allows you to queue multiple generations into different boards without waiting for them to finish.
+ - *When disabled:* An **Auto-Add Board** dropdown appears, allowing you to set one specific board as the permanent destination for all new images.
+- **Always Show Image Size Badge:** Toggles whether the resolution (e.g., 512x512) is displayed on each image preview thumbnail.
+
+Below these buttons is the **Search Boards** text entry area, allowing you to quickly find specific boards by name. Next to it is the **Add Board (+)** button for creating new boards.
+
+:::tip
+You can rename any board by simply clicking on its name under the thumbnail and typing the new name.
+:::
+
+---
+
+## Board Management
+
+Each board has a context menu accessible via right-click (or Ctrl+click).
+
+
+
+- **Auto-add to this Board:** If *Auto-Assign Board on Click* is disabled in settings, use this option to quickly set the selected board as the default destination for new images.
+- **Download Board:** Packages all images within the board into a `.zip` file. A notification link will be provided when the download is ready.
+- **Delete Board:** Permanently removes the board and all of its contents.
+
+:::danger
+Deleting a board will **permanently delete all images** contained within it. Proceed with caution!
+:::
+
+### Board Contents
+
+Every board is organized into two distinct tabs:
+
+
+
+1. **Images:** Images generated directly within InvokeAI.
+2. **Assets:** External images you have uploaded to use as an [Image Prompt](https://support.invoke.ai/support/solutions/articles/151000159340-using-the-image-prompt-adapter-ip-adapter-) or within the Image to Image tab.
+
+---
+
+## Virtual Boards
+
+Virtual boards are read-only board groupings that Invoke computes on-the-fly from your image metadata rather than storing in the database. The first available type groups images **By Date**, creating one sub-board per day on which you generated images.
+
+Virtual boards are **off by default**. To enable them:
+
+1. Open the **board settings** (gear icon at the top of the Gallery).
+2. Toggle **Virtual Boards** on.
+3. A collapsible **By Date** section appears in the board list, with a sub-board for each day that has images. Each sub-board shows the date, image / asset counts, and a cover thumbnail.
+
+Selecting a date sub-board filters the gallery to just the images from that day. The collapse state of the By Date section persists across reloads.
+
+### Limits
+
+Because virtual boards are derived, not stored:
+
+- They are **read-only**: no drag-and-drop, no context menu, no auto-add destination.
+- You cannot rename or delete them.
+- Generating a new image updates the counts immediately, but the image is still saved to your regular auto-add board — virtual boards are a *view*, not a destination.
+- Disabling the **Virtual Boards** toggle hides the section and resets the selection to *Uncategorized* if you were viewing a virtual sub-board.
+
+---
+
+## Image Interaction
+
+Every image generated by InvokeAI stores its generation metadata (prompt, seed, models, etc.) directly inside the file. You can read this data by selecting the image and clicking the **Info button**  in any result panel.
+
+Additionally, each image has a context menu (right-click or Ctrl+click) with powerful workflow actions:
+
+
+
+*Options marked with an asterisk (\*) require the image to have generation metadata.*
+
+
+
+ - **Open in New Tab:** Opens the image in a separate browser tab.
+ - **Download Image:** Saves the image to your local device.
+ - **Star Image:** Pins the image to the top of the gallery. *(Also available by clicking the star icon on hover).*
+
+
+ - **Load Workflow*:** Loads the saved workflow settings into the Workflow tab and opens it.
+ - **Remix Image*:** Loads all generation settings (**excluding** the Seed) into the control panel.
+ - **Use Prompt*:** Loads only the text prompts.
+ - **Use Seed*:** Loads only the Seed.
+ - **Use All*:** Loads all generation settings into the control panel.
+
+
+ - **Send to Image to Image:** Moves the image to the left-hand panel of the Image to Image tab.
+ - **Send to Unified Canvas:** **Replaces** the current Unified Canvas contents with this image.
+
+
+ - **Change Board:** Opens a prompt to move the image. *(You can also drag and drop images onto board thumbnails).*
+ - **Delete Image:** Permanently deletes the image from InvokeAI.
+
+
+
+:::caution
+ Selecting **Delete Image** will remove the image entirely from your InvokeAI installation. This action cannot be undone.
+:::
+
+---
+
+## Summary
+
+This walkthrough covers the Gallery interface and Boards. For guidance on prompting and generation workflows, please refer to the [Prompting Guide](/concepts/prompting-guide/) and [AI Image Generation](/concepts/image-generation/).
+
+## Acknowledgements
+
+A huge shout-out to the core team working to make the Web GUI a reality, including [psychedelicious](https://github.com/psychedelicious), [Kyle0654](https://github.com/Kyle0654), and [blessedcoolant](https://github.com/blessedcoolant). [hipsterusername](https://github.com/hipsterusername) was the team's unofficial cheerleader and added tooltips/docs.
diff --git a/docs/src/content/docs/features/hotkeys.mdx b/docs/src/content/docs/features/hotkeys.mdx
new file mode 100644
index 00000000000..a4b99fca16d
--- /dev/null
+++ b/docs/src/content/docs/features/hotkeys.mdx
@@ -0,0 +1,202 @@
+---
+title: Hotkeys
+description: Learn how to use and customize hotkeys in InvokeAI, and how developers can interact with the hotkey system.
+lastUpdated: 2026-02-19
+sidebar:
+ order: 2
+---
+
+import { Tabs, TabItem, Steps, Card, CardGrid, Icon } from '@astrojs/starlight/components';
+
+InvokeAI allows you to customize all keyboard shortcuts (hotkeys) to match your workflow preferences. This guide covers how to use and customize hotkeys as a user, as well as providing technical documentation for developers.
+
+## User Guide
+
+
+
+ See all available keyboard shortcuts organized by category in one place.
+
+
+ Change any shortcut to your preference, or assign multiple key combinations to the same action.
+
+
+ Built-in validation prevents invalid combinations.
+
+
+ Your custom hotkeys are safely stored and restored across sessions.
+
+
+
+### Opening the Hotkeys Modal
+
+Press Shift + ? or click the **keyboard icon** in the application to open the Hotkeys Modal.
+
+### Managing Hotkeys
+
+
+
+ - Browse all available hotkeys organized by category (App, Canvas, Gallery, Workflows, etc.).
+ - Search for specific hotkeys using the search bar.
+ - See the current key combination for each action.
+
+
+
+ 1. Click the **pencil** button by the hotkey you want to change, or click the **plus** button to add a new one.
+ 2. Enter your new hotkey combination in the editor.
+ - Use modifier buttons for quick-insert (Mod, Ctrl, Shift, Alt).
+ - Check the live preview to see how your hotkey will look.
+ 3. Click the **checkmark** or press Enter to save.
+
+
+
+ - **Reset a single hotkey:** Click the counter-clockwise arrow icon next to customized hotkeys.
+ - **Reset all hotkeys:** In Edit Mode, click the **Reset All to Default** button at the bottom.
+
+
+
+### Hotkey Format Reference
+
+When customizing hotkeys, use the following formats:
+
+- **Valid Modifiers:** `mod` (Ctrl on Windows/Linux, Cmd on Mac), `ctrl`, `shift`, `alt`
+- **Valid Keys:** Letters (`a-z`), Numbers (`0-9`), Function keys (`f1-f12`), Special keys (`enter`, `space`, `tab`, `backspace`, `delete`, `escape`), Arrow keys (`up`, `down`, `left`, `right`)
+- **Multiple alternatives:** Separate with commas (e.g., `mod+enter, ctrl+enter`)
+
+:::tip
+ **Valid Hotkeys:** `mod+s`, `ctrl+shift+p`, `f5, mod+r`
+ **Invalid Hotkeys:** `mod+` (no key after modifier), `shift+ctrl+` (ends with modifier)
+:::
+
+---
+
+## Developer Guide
+
+The hotkeys system allows developers to centrally define, manage, and validate hotkeys throughout the application. It is built on top of `react-hotkeys-hook`.
+
+### Architecture
+
+The customizable hotkeys feature comprises the following components:
+
+
+
+ **Hotkeys State Slice (`hotkeysSlice.ts`)**
+ - Stores custom hotkey mappings in Redux state.
+ - Persisted to IndexedDB using `redux-remember`.
+ - Provides actions to change, reset individual, or reset all hotkeys.
+
+
+ **`useHotkeyData` Hook (`useHotkeyData.ts`)**
+ - Defines all default hotkeys and merges them with custom hotkeys from the store.
+ - Returns the effective hotkeys to be used.
+ - Provides platform-specific key translations.
+
+
+ - **`HotkeyEditor.tsx`**: Inline editor with live preview, validation, and modifier insertion.
+ - **`HotkeysModal.tsx`**: The modal interface supporting View/Edit modes, searching, and categories.
+
+
+
+### Adding New Hotkeys
+
+To add a new hotkey to the system, follow these steps:
+
+
+1. **Add Translation Strings**
+ In `invokeai/frontend/web/public/locales/en.json`:
+ ```json
+ {
+ "hotkeys": {
+ "app": {
+ "myAction": {
+ "title": "My Action",
+ "desc": "Description of what this hotkey does"
+ }
+ }
+ }
+ }
+ ```
+
+2. **Register the Hotkey**
+ In `invokeai/frontend/web/src/features/system/components/HotkeysModal/useHotkeyData.ts`:
+ ```typescript
+ // Inside the appropriate category builder function
+ addHotkey('app', 'myAction', ['mod+k']); // Default binding
+ ```
+
+3. **Use the Hotkey in Components**
+ ```tsx
+ import { useRegisteredHotkeys } from 'features/system/components/HotkeysModal/useHotkeyData';
+
+ const MyComponent = () => {
+ const handleAction = useCallback(() => {
+ // Your action here
+ }, []);
+
+ // Automatically uses custom hotkeys if configured
+ useRegisteredHotkeys({
+ id: 'myAction',
+ category: 'app', // 'app', 'canvas', 'viewer', 'gallery', 'workflows'
+ callback: handleAction,
+ options: { enabled: true, preventDefault: true },
+ dependencies: [handleAction]
+ });
+
+ // ...
+ };
+ ```
+
+
+### Common Patterns
+
+
+
+ Only enable hotkeys when certain conditions are met:
+ ```typescript
+ useRegisteredHotkeys({
+ id: 'save',
+ category: 'app',
+ callback: handleSave,
+ options: {
+ enabled: hasUnsavedChanges && !isLoading, // Only when valid
+ preventDefault: true
+ },
+ dependencies: [hasUnsavedChanges, isLoading, handleSave]
+ });
+ ```
+
+
+ Ensure hotkeys are only active when a specific region is focused:
+ ```tsx
+ import { useFocusRegion } from 'common/hooks/focus';
+
+ const MyComponent = () => {
+ const focusRegionRef = useFocusRegion('myRegion');
+
+ // Hotkey only works when this region has focus
+ useRegisteredHotkeys({
+ id: 'myAction',
+ category: 'app',
+ callback: handleAction,
+ options: { enabled: true }
+ });
+
+ return
...
;
+ };
+ ```
+
+
+ Provide multiple alternatives for the same action:
+ ```typescript
+ // In useHotkeyData.ts
+ addHotkey('canvas', 'redo', ['mod+shift+z', 'mod+y']); // Two alternatives
+ ```
+
+
+
+:::caution[Best Practices]
+- **Use `mod` instead of `ctrl`**: Automatically maps to Cmd on Mac, Ctrl elsewhere.
+- **Provide descriptive translations**: Help users understand what each hotkey does.
+- **Avoid conflicts**: Check existing hotkeys before adding new ones.
+- **Check enabled state**: Only activate hotkeys when the action is available.
+- **Use dependencies correctly**: Ensure callbacks are stable with `useCallback`.
+:::
diff --git a/docs/src/content/docs/features/prompt-tools.md b/docs/src/content/docs/features/prompt-tools.md
new file mode 100644
index 00000000000..45bfd96170a
--- /dev/null
+++ b/docs/src/content/docs/features/prompt-tools.md
@@ -0,0 +1,55 @@
+---
+title: LLM Prompt Tools
+sidebar:
+ order: 3
+lastUpdated: 2026-05-23
+---
+
+InvokeAI includes two built-in tools that use local language models to help you write better prompts. Both tools appear as small buttons in the top-right corner of the positive prompt area and are only visible when you have a compatible model installed.
+
+## Expand Prompt
+
+Takes your short prompt and expands it into a detailed, vivid description suitable for image generation.
+
+**How to use:**
+
+1. Type a brief prompt (e.g. "a cat in a garden")
+2. Click the sparkle button in the prompt area
+3. Select a Text LLM model from the dropdown
+4. Click **Expand**
+5. Your prompt is replaced with the expanded version
+
+**Compatible models:** Any HuggingFace model with a `ForCausalLM` architecture. Recommended options:
+
+| Model | Size | HuggingFace ID |
+|-------|------|----------------|
+| Qwen2.5 1.5B Instruct | ~3 GB | `Qwen/Qwen2.5-1.5B-Instruct` |
+| Phi-3 Mini Instruct | ~7.5 GB | `microsoft/Phi-3-mini-4k-instruct` |
+| TinyLlama Chat | ~2 GB | `TinyLlama/TinyLlama-1.1B-Chat-v1.0` |
+
+Install by pasting the HuggingFace ID into the Model Manager. The model is automatically detected as a **Text LLM** type.
+
+## Image to Prompt
+
+Upload an image and generate a descriptive prompt from it using a vision-language model.
+
+**How to use:**
+
+1. Click the image button in the prompt area
+2. Select a LLaVA OneVision model from the dropdown
+3. Click **Upload Image** and select an image
+4. Click **Generate Prompt**
+5. The generated description is set as your prompt
+
+**Compatible models:** LLaVA OneVision models (already supported by InvokeAI).
+
+## Undo
+
+Both tools overwrite your current prompt. You can undo this change:
+
+- Press **Ctrl+Z** (or **Cmd+Z** on macOS) in the prompt textarea within 30 seconds
+- The undo state is cleared when you start typing manually
+
+## Workflow Node
+
+A **Text LLM** node is also available in the workflow editor for use in automated pipelines. It accepts a prompt string and model selection as inputs and outputs the expanded text as a string.
diff --git a/docs/src/content/docs/index.mdx b/docs/src/content/docs/index.mdx
new file mode 100644
index 00000000000..52de38f6faf
--- /dev/null
+++ b/docs/src/content/docs/index.mdx
@@ -0,0 +1,127 @@
+---
+title: AI Image Generation for Creatives
+description: A leading creative engine built to empower professionals and enthusiasts alike.
+template: splash
+hero:
+ title: AI Image Generation for Creatives
+ tagline: Invoke is a free and open-source creative engine for AI-powered image generation. Built by creatives, for creatives. Self-hosted, fully customizable, and Apache 2.0 licensed.
+ actions:
+ - text: Get Started
+ link: start-here/installation
+ icon: right-arrow
+ variant: primary
+ - text: View on GitHub
+ link: https://github.com/invoke-ai/InvokeAI
+ icon: github
+ variant: minimal
+---
+
+import { Image } from 'astro:assets'
+import { Card, CardGrid, LinkButton } from '@astrojs/starlight/components';
+import DownloadOptions from '@components/DownloadOptions.astro';
+
+import splashImage from './assets/invoke-webui-canvas.png';
+
+
+
+
+
+## The Creative Engine
+
+Invoke provides the most feature-complete and professional toolkit for AI image generation, built with production workflows in mind.
+
+
+
+ Experience true **Layer-based Canvas Editing**. Invoke's powerful canvas allows you to draw, paint, sketch, and edit your creations with unhindered precision. Each layer can be independently manipulated—giving you the freedom to compose intricate scenes seamlessly without breaking a sweat.
+
+
+ Unlock limitless possibilities with **Advanced Node-based Workflows**. Build your own complex, reproducible pipelines via a completely visual graph backend. Expose custom UI parameters to share and update values easily without diving deep into the graph.
+
+
+ Stay on the cutting edge with out-of-the-box support for the latest foundational models, including **Flux, SDXL, SD 1.5**, and more. Manage checkpoints, LoRAs, Textual Inversions, and ControlNets with an intuitive Model Manager.
+
+
+ **Completely Local & Self-hosted**. Invoke runs locally on your own hardware. Your data, prompts, and creations belong entirely to you. Say goodbye to restrictive cloud services and privacy concerns—maintain absolute control over your art.
+
+
+
+---
+
+## Built for Production
+
+Invoke is designed to keep your creative flow moving. Unlike other tools that feel like engineering experiments, Invoke is a polished, professional-grade application.
+
+
+
+ A beautiful, clean interface that prioritizes your artwork. No cluttered menus—just the tools you need right where you expect them.
+
+
+ Extensive ControlNet implementation allows you to guide generations with depth maps, edges, poses, and more for exact composition control.
+
+
+ Rapidly iterate on concepts with batch generation, prompt wildcards, and high-resolution upscaling, all without leaving the app.
+
+
+ Actively developed by a passionate open-source community. Jump into the conversation, report bugs, or request features directly.
+
+
+
+---
+
+## Join the Ecosystem
+
+Whether you are looking to install the app, get support, train your own models, or contribute to the project, the Invoke community has you covered.
+
+
+
+ Ready to dive in? The [Invoke Launcher](/start-here/installation/) is the fastest way to get up and running on Windows, macOS, and Linux. For advanced setups, try [Docker](/configuration/docker/) or a [manual Python installation](/start-here/manual/).
+
+
+ Get Invoke
+
+
+
+
+ Want to train models on your own style? Invoke Training provides a dedicated UI for **Textual Inversion** and **LoRA training**.
+
+
+ Explore Invoke Training
+
+
+
+
+ Stuck? Check out our comprehensive [FAQ](/troubleshooting/faq/) for quick answers. If you still need a hand, our community is incredibly active and helpful.
+
+ Join our Discord
+
+
+
+ Invoke is open-source software made possible by [people across the world](/contributing/contributors/). We welcome code, documentation, and design contributions of any size! Read our [contributing guide](/contributing/) to start.
+
+
+ Read Contribution Guide
+
+
+
+
+---
+
+## Download Invoke
+
+Ready to unleash your creativity? Invoke is available for Windows, macOS, and Linux. Self-hosted, fully customizable, and Apache 2.0 licensed.
+
+
+
+---
+
+:::note[About the Hosted Version]
+The Invoke hosted platform has been shut down as the founding team joined Adobe. However, Invoke lives on as a thriving open-source project maintained by the community.
+
+The open-source version offers the same powerful features you may have used in the hosted service, with the added benefit of complete control and privacy through self-hosting.
+
+Stewardship of the project has been passed to Lincoln Stein (lstein) and Vic (Blessedcoolant), who have been core maintainers since the project's inception and continue to drive development forward with the community.
+:::
diff --git a/docs/src/content/docs/start-here/installation.mdx b/docs/src/content/docs/start-here/installation.mdx
new file mode 100644
index 00000000000..02e2680db66
--- /dev/null
+++ b/docs/src/content/docs/start-here/installation.mdx
@@ -0,0 +1,89 @@
+---
+title: Simple Installation
+lastUpdated: 2026-02-18
+---
+
+import { LinkCard, Tabs, TabItem, Steps } from '@astrojs/starlight/components'
+import SystemRequirementsLink from '@components/SystemRequirmentsLink.astro'
+
+export const alternateLaunchers = [
+ {
+ title: 'Stability Matrix',
+ description: 'Get the latest version of Stability Matrix for your platform.',
+ href: 'https://github.com/LykosAI/StabilityMatrix'
+ },
+ {
+ title: 'LynxHub',
+ description: 'Get the latest version of LynxHub for your platform.',
+ href: 'https://github.com/KindaBrazy/LynxHub'
+ },
+]
+
+
+
+## Invoke Launcher
+
+The Invoke launcher is the official launcher to install, update and manage your invoke installation.
+
+### Download and Set Up the Launcher
+
+The Launcher manages your Invoke install. Follow these instructions to download and set up the Launcher.
+
+
+
+
+ 1. [Download for Windows]
+ 2. Run the `EXE` to install the Launcher and start it.
+ 3. A desktop shortcut will be created; use this to run the Launcher in the future.
+ 4. You can delete the `EXE` file you downloaded.
+
+
+
+
+ 1. [Download for MacOS]
+ 2. Open the `DMG` and drag the app into `Applications`.
+ 3. Run the launcher from `Applications`.
+ 4. You can delete the `DMG` file you downloaded.
+
+
+
+
+ 1. [Download for Linux]
+ 2. You may need to edit the `AppImage` file properties and make it executable.
+ 3. Optionally move the file to a location that does not require admin privileges and add a desktop shortcut for it.
+ 4. Run the Launcher by double-clicking the `AppImage` or the shortcut you made.
+
+
+
+
+### Install Invoke
+
+Run the Launcher you just set up if you haven't already. Click **Install** and follow the instructions to install (or update) Invoke.
+
+If you have an existing Invoke installation, you can select it and let the launcher manage the install. You'll be able to update or launch the installation.
+
+### Updating
+
+The Launcher will check for updates for itself _and_ Invoke.
+
+When the Launcher detects an update is available for itself, you'll get a small popup window. Click through this and the Launcher will update itself.
+
+When the Launcher detects an update for Invoke, you'll see a small green alert in the Launcher. Click that and follow the instructions to update Invoke.
+
+## Alternative Launchers
+
+:::caution
+ Installations from alternate launchers are not managed by Invoke, so we cannot guarantee it will work correctly. If you want a more stable experience, we recommend using the [official Invoke Launcher](#invoke-launcher).
+:::
+
+{alternateLaunchers.map(({title, description, href}) => (
+
+))}
+
+[Download for Windows]: https://github.com/invoke-ai/launcher/releases/latest/download/Invoke.Community.Edition.Setup.latest.exe
+[Download for MacOS]: https://github.com/invoke-ai/launcher/releases/latest/download/Invoke.Community.Edition-latest-arm64.dmg
+[Download for Linux]: https://github.com/invoke-ai/launcher/releases/latest/download/Invoke.Community.Edition-latest.AppImage
diff --git a/docs/src/content/docs/start-here/manual.mdx b/docs/src/content/docs/start-here/manual.mdx
new file mode 100644
index 00000000000..cc7b45d5fe6
--- /dev/null
+++ b/docs/src/content/docs/start-here/manual.mdx
@@ -0,0 +1,193 @@
+---
+title: Manual Installation
+lastUpdated: 2026-02-18
+---
+
+import { LinkCard, Tabs, TabItem, Steps, LinkButton } from '@astrojs/starlight/components'
+import SystemRequirementsLink from '@components/SystemRequirmentsLink.astro'
+
+
+
+## Are you in the right place?
+
+
+
+
+
+## Walkthrough
+
+We'll use [`uv`](https://github.com/astral-sh/uv) to install python and create a virtual environment, then install the `invokeai` package. `uv` is a modern, very fast alternative to `pip`.
+
+The following commands vary depending on the version of Invoke being installed and the system onto which it is being installed.
+
+
+
+ 1. Install `uv` as described in its [docs](https://docs.astral.sh/uv/getting-started/installation/#standalone-installer). We suggest using the standalone installer method.
+
+ Run `uv --version` to confirm that `uv` is installed and working. After installation, you may need to restart your terminal to get access to `uv`.
+
+ 2. Create a directory for your installation, typically in your home directory (e.g. `~/invokeai` or `$Home/invokeai`):
+
+
+
+ ```ps
+ mkdir $Home/invokeai
+ cd $Home/invokeai
+ ```
+
+
+ ```bash
+ mkdir ~/invokeai
+ cd ~/invokeai
+ ```
+
+
+
+ 3. Create a virtual environment in that directory:
+
+ ```sh
+ uv venv --relocatable --prompt invoke --python 3.12 --python-preference only-managed .venv
+ ```
+
+ This command creates a portable virtual environment at `.venv` complete with a portable python 3.12. It doesn't matter if your system has no python installed, or has a different version - `uv` will handle everything.
+
+ 4. Activate the virtual environment:
+
+
+
+ ```ps
+ .venv\Scripts\activate
+ ```
+
+
+ ```bash
+ source .venv/bin/activate
+ ```
+
+
+
+ 5. Choose a version to install.
+
+
+ View Releases
+
+
+ 6. Determine the package specifier to use when installing. This is a performance optimization.
+
+ - If you have an Nvidia 20xx series GPU or older, use `invokeai[xformers]`.
+ - If you have an Nvidia 30xx series GPU or newer, or do not have an Nvidia GPU, use `invokeai`.
+
+ 7. Determine the torch backend to use for installation, if any. This is necessary to get the right version of torch installed. This is acheived by using [UV's built in torch support.](https://docs.astral.sh/uv/guides/integration/pytorch/#automatic-backend-selection)
+
+ :::note[Torch Backend Selection]
+ Pick a torch backend only when it applies to your system. In all other cases, do not use a torch backend.
+ :::
+
+
+
+
+
+ Use:
+ ```sh
+ --torch-backend=cu128
+ ```
+
+
+ Do not use a torch backend.
+
+
+
+
+
+
+
+ Use:
+ ```sh
+ --torch-backend=cu128
+ ```
+
+
+ Use:
+ ```sh
+ --torch-backend=cpu
+ ```
+
+
+ Use:
+ ```sh
+ --torch-backend=rocm7.1
+ ```
+
+
+ Do not use a torch backend.
+
+
+
+
+
+ 8. Install the `invokeai` package. Substitute the package specifier and version.
+
+
+
+ ```sh
+ uv pip install == --python 3.12 --python-preference only-managed --force-reinstall
+ ```
+
+
+ ```sh
+ uv pip install == --python 3.12 --python-preference only-managed --torch-backend= --force-reinstall
+ ```
+
+
+
+
+ 9. Deactivate and reactivate your venv so that the invokeai-specific commands become available in the environment:
+
+
+
+ ```ps
+ deactivate
+ .venv\Scripts\activate
+ ```
+
+
+ ```bash
+ deactivate && source .venv/bin/activate
+ ```
+
+
+
+ 10. Run the application, specifying the directory you created earlier as the root directory:
+
+
+
+ ```ps
+ invokeai-web --root ~/invokeai
+ ```
+
+
+ ```bash
+ invokeai-web --root $Home/invokeai
+ ```
+
+
+
+
+If you run Invoke on a headless server, you might want to install and run Invoke on the command line.
+
+We do not plan to maintain scripts to do this moving forward, instead focusing our dev resources on the GUI [launcher](../installation).
+
+You can create your own scripts for this by copying the handful of commands in this guide. `uv`'s [`pip` interface docs](https://docs.astral.sh/uv/reference/cli/#uv-pip-install) may be useful.
diff --git a/docs/src/content/docs/start-here/system-requirements.mdx b/docs/src/content/docs/start-here/system-requirements.mdx
new file mode 100644
index 00000000000..114698ce158
--- /dev/null
+++ b/docs/src/content/docs/start-here/system-requirements.mdx
@@ -0,0 +1,139 @@
+---
+title: Hardware Requirements
+sidebar:
+ order: 1
+lastUpdated: 2026-02-18
+---
+
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components'
+
+Invoke runs on Windows 10+, macOS 14+ and Linux (Ubuntu 20.04+ is well-tested).
+
+## Hardware
+
+Hardware requirements vary significantly depending on model and image output size.
+
+The requirements below are rough guidelines for best performance. GPUs with less VRAM typically still work, if a bit slower. Follow the [Low VRAM Guide] to optimize performance.
+
+- All Apple Silicon (M1, M2, etc) Macs work, but 16GB+ memory is recommended.
+- AMD GPUs are supported on Linux only. The VRAM requirements are the same as Nvidia GPUs.
+
+### Windows/Linux
+
+| Model Family | Best resolution | GPU (series) | VRAM (min) | RAM (min) | Notes |
+|---|---:|---|---:|---:|---|
+| SD1.5 | 512x512 | Nvidia 10xx+ | 4GB | 8GB | |
+| SDXL | 1024x1024 | Nvidia 20xx+ | 8GB | 16GB | |
+| FLUX.1 | 1024x1024 | Nvidia 20xx+ | 10GB | 32GB | |
+| FLUX.2 Klein 4B | 1024x1024 | Nvidia 30xx+ | 12GB | 16GB | FP8 works with 8GB+; Diffusers + encoder |
+| FLUX.2 Klein 9B | 1024x1024 | Nvidia 40xx | 24GB | 32GB | FP8 works with 12GB+; Diffusers + encoder |
+| Z-Image Turbo | 1024x1024 | Nvidia 20xx+ | 8GB | 16GB | Q4_K 8GB; Q8/BF16 16GB+ |
+
+:::tip[`tmpfs` on Linux]
+ If your temporary directory is mounted as a `tmpfs`, ensure it has sufficient space.
+:::
+
+## Python
+
+:::tip[The launcher installs python for you]
+ You don't need to do this if you are installing with the [Invoke Launcher](../installation).
+:::
+
+Invoke requires python `3.11` through `3.12`. If you don't already have one of these versions installed, we suggest installing `3.12`, as it will be supported for longer.
+
+Check that your system has an up-to-date Python installed by running `python3 --version` in the terminal (Linux, macOS) or cmd/powershell (Windows).
+
+:::tip[Installing Python]{icon="seti:python"}
+
+
+
+ 1. Install python with [an official installer].
+ 2. The installer includes an option to add python to your PATH. Be sure to enable this. If you missed it, re-run the installer, choose to modify an existing installation, and tick that checkbox.
+ 3. You may need to install [Microsoft Visual C++ Redistributable].
+
+
+
+
+ 1. Install python with [an official installer].
+ 2. If model installs fail with a certificate error, you may need to run this command (changing the python version to match what you have installed): `/Applications/Python\ 3.11/Install\ Certificates.command`
+ 3. If you haven't already, you will need to install the XCode CLI Tools by running `xcode-select --install` in a terminal.
+
+
+
+
+ 1. Installing python varies depending on your system. We recommend [using `uv` to manage your python installation].
+ 2. You'll need to install `libglib2.0-0` and `libgl1-mesa-glx` for OpenCV to work. For example, on a Debian system: `sudo apt update && sudo apt install -y libglib2.0-0 libgl1-mesa-glx`
+
+
+
+:::
+
+## Drivers
+
+If you have an Nvidia or AMD GPU, you may need to manually install drivers or other support packages for things to work well or at all.
+
+### Nvidia
+
+Run `nvidia-smi` on your system's command line to verify that drivers and CUDA are installed. If this command fails, or doesn't report versions, you will need to install drivers.
+
+Go to the [CUDA Toolkit Downloads] and carefully follow the instructions for your system to get everything installed.
+
+Confirm that `nvidia-smi` displays driver and CUDA versions after installation.
+
+#### Linux - via Nvidia Container Runtime
+
+An alternative to installing CUDA locally is to use the [Nvidia Container Runtime] to run the application in a container.
+
+#### Windows - Nvidia cuDNN DLLs
+
+An out-of-date cuDNN library can greatly hamper performance on 30-series and 40-series cards. Check with the community on discord to compare your `it/s` if you think you may need this fix.
+
+First, locate the destination for the DLL files and make a quick back up:
+
+1. Find your InvokeAI installation folder, e.g. `C:\Users\Username\InvokeAI\`.
+1. Open the `.venv` folder, e.g. `C:\Users\Username\InvokeAI\.venv` (you may need to show hidden files to see it).
+1. Navigate deeper to the `torch` package, e.g. `C:\Users\Username\InvokeAI\.venv\Lib\site-packages\torch`.
+1. Copy the `lib` folder inside `torch` and back it up somewhere.
+
+Next, download and copy the updated cuDNN DLLs:
+
+1. Go to the [Cuda Docs].
+1. Create an account if needed and log in.
+1. Choose the newest version of cuDNN that works with your GPU architecture. Consult the [cuDNN support matrix] to determine the correct version for your GPU.
+1. Download the latest version and extract it.
+1. Find the `bin` folder, e.g. `cudnn-windows-x86_64-SOME_VERSION\bin`.
+1. Copy and paste the `.dll` files into the `lib` folder you located earlier. Replace files when prompted.
+
+If, after restarting the app, this doesn't improve your performance, either restore your back up or re-run the installer to reset `torch` back to its original state.
+
+### AMD
+
+:::tip[Linux Only]{icon="linux"}
+ AMD GPUs are supported on Linux only, due to ROCm (the AMD equivalent of CUDA) support being Linux only.
+:::
+
+:::caution[Bumps Ahead]
+ While the application does run on AMD GPUs, there are occasional bumps related to spotty torch support.
+:::
+
+Run `rocm-smi` on your system's command line verify that drivers and ROCm are installed. If this command fails, or doesn't report versions, you will need to install them.
+
+Go to the [ROCm Documentation] and carefully follow the instructions for your system to get everything installed.
+
+Confirm that `rocm-smi` displays driver and CUDA versions after installation.
+
+#### Linux - via Docker Container
+
+An alternative to installing ROCm locally is to use a [ROCm docker container] to run the application in a container.
+
+[Low VRAM Guide]: ../../configuration/low-vram-mode
+[Nvidia Container Runtime]: https://developer.nvidia.com/container-runtime
+[an official installer]: https://www.python.org/downloads/
+[using `uv` to manage your python installation]: https://docs.astral.sh/uv/concepts/python-versions/#installing-a-python-version
+[Microsoft Visual C++ Redistributable]: https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170
+[Invoke Launcher]: ../installation
+[CUDA Toolkit Downloads]: https://developer.nvidia.com/cuda-downloads
+[Cuda Docs]: https://developer.nvidia.com/cudnn
+[cuDNN support matrix]: https://docs.nvidia.com/deeplearning/cudnn/support-matrix/index.html
+[ROCm Documentation]: https://rocmdocs.amd.com
+[ROCm docker container]: https://rocmdocs.amd.com/en/latest/Deep_learning/Deep_learning.html#docker-containers
diff --git a/docs/src/content/docs/troubleshooting/faq.mdx b/docs/src/content/docs/troubleshooting/faq.mdx
new file mode 100644
index 00000000000..3c33845f995
--- /dev/null
+++ b/docs/src/content/docs/troubleshooting/faq.mdx
@@ -0,0 +1,117 @@
+---
+title: FAQ
+lastUpdated: 2026-02-19
+---
+
+import { LinkCard } from '@astrojs/starlight/components';
+
+If the troubleshooting steps on this page don't get you up and running, please either [create an issue] or hop on [discord] for help.
+
+## How to Install
+
+
+
+## Downloading models and using existing models
+
+The Model Manager tab in the UI provides a few ways to install models, including using your already-downloaded models. You'll see a popup directing you there on first startup. For more information, see the [model install docs].
+
+## Missing models after updating from v3
+
+If you find some models are missing after updating from v3, it's likely they weren't correctly registered before the update and didn't get picked up in the migration.
+
+You can use the `Scan Folder` tab in the Model Manager UI to fix this. The models will either be in the old, now-unused `autoimport` folder, or your `models` folder.
+
+- Find and copy your install's old `autoimport` folder path, install the main install folder.
+- Go to the Model Manager and click `Scan Folder`.
+- Paste the path and scan.
+- IMPORTANT: Uncheck `Inplace install`.
+- Click `Install All` to install all found models, or just install the models you want.
+
+Next, find and copy your install's `models` folder path (this could be your custom models folder path, or the `models` folder inside the main install folder).
+
+Follow the same steps to scan and import the missing models.
+
+## Slow generation
+
+- Check the [system requirements] to ensure that your system is capable of generating images.
+- Follow the [Low VRAM mode guide] to optimize performance.
+- Check that your generations are happening on your GPU (if you have one). Invoke will log what is being used for generation upon startup. If your GPU isn't used, re-install to and ensure you select the appropriate GPU option.
+- If you are on Windows with an Nvidia GPU, you may have exceeded your GPU's VRAM capacity and are triggering Nvidia's "sysmem fallback". There's a guide to opt out of this behaviour in the [Low VRAM mode guide].
+
+## Triton error on startup
+
+This can be safely ignored. Invoke doesn't use Triton, but if you are on Linux and wish to dismiss the error, you can install Triton.
+
+## Unable to Copy on Firefox
+
+Firefox does not allow Invoke to directly access the clipboard by default. As a result, you may be unable to use certain copy functions. You can fix this by configuring Firefox to allow access to write to the clipboard:
+
+- Go to `about:config` and click the Accept button
+- Search for `dom.events.asyncClipboard.clipboardItem`
+- Set it to `true` by clicking the toggle button
+- Restart Firefox
+
+## Replicate image found online
+
+Most example images with prompts that you'll find on the internet have been generated using different software, so you can't expect to get identical results. In order to reproduce an image, you need to replicate the exact settings and processing steps, including (but not limited to) the model, the positive and negative prompts, the seed, the sampler, the exact image size, any upscaling steps, etc.
+
+## Invalid configuration file
+
+Everything seems to install ok, you get a `ValidationError` when starting up the app.
+
+This is caused by an invalid setting in the `invokeai.yaml` configuration file. The error message should tell you what is wrong.
+
+Check the [configuration docs] for more detail about the settings and how to specify them.
+
+## Out of Memory Errors
+
+The models are large, VRAM is expensive, and you may find yourself faced with Out of Memory errors when generating images. Follow our [Low VRAM mode guide] to configure Invoke to prevent these.
+
+## Memory Leak (Linux)
+
+If you notice a memory leak, it could be caused to memory fragmentation as models are loaded and/or moved from CPU to GPU.
+
+A workaround is to tune memory allocation with an environment variable:
+
+```bash
+# Force blocks >1MB to be allocated with `mmap` so that they are released to the system immediately when they are freed.
+MALLOC_MMAP_THRESHOLD_=1048576
+```
+
+:::caution[Speed vs Memory Tradeoff]
+ Your generations may be slower overall when setting this environment variable.
+:::
+
+:::note[Possibly dependent on `libc` implementation]
+ It's not known if this issue occurs with other `libc` implementations such as `musl`.
+
+ If you encounter this issue and your system uses a different implementation, please try this environment variable and let us know if it fixes the issue.
+:::
+
+
Detailed Discussion
+
+Python (and PyTorch) relies on the memory allocator from the C Standard Library (`libc`). On linux, with the GNU C Standard Library implementation (`glibc`), our memory access patterns have been observed to cause severe memory fragmentation.
+
+This fragmentation results in large amounts of memory that has been freed but can't be released back to the OS. Loading models from disk and moving them between CPU/CUDA seem to be the operations that contribute most to the fragmentation.
+
+This memory fragmentation issue can result in OOM crashes during frequent model switching, even if `ram` (the max RAM cache size) is set to a reasonable value (e.g. a OOM crash with `ram=16` on a system with 32GB of RAM).
+
+This problem may also exist on other OSes, and other `libc` implementations. But, at the time of writing, it has only been investigated on linux with `glibc`.
+
+To better understand how the `glibc` memory allocator works, see these references:
+
+- Basics: [The GNU Allocator](https://www.gnu.org/software/libc/manual/html_node/The-GNU-Allocator.html)
+- Details: [Malloc Internals](https://sourceware.org/glibc/wiki/MallocInternals)
+
+Note the differences between memory allocated as chunks in an arena vs. memory allocated with `mmap`. Under `glibc`'s default configuration, most model tensors get allocated as chunks in an arena making them vulnerable to the problem of fragmentation.
+
+[model install docs]: ../../concepts/models
+[system requirements]: ../../start-here/system-requirements
+[Low VRAM mode guide]: ../../configuration/low-vram-mode
+[create an issue]: https://github.com/invoke-ai/InvokeAI/issues
+[discord]: https://discord.gg/ZmtBAhwWhy
+[configuration docs]: ../../configuration/invokeai-yaml
diff --git a/docs/src/content/i18n/en.json b/docs/src/content/i18n/en.json
new file mode 100644
index 00000000000..69333e3a0b2
--- /dev/null
+++ b/docs/src/content/i18n/en.json
@@ -0,0 +1,45 @@
+{
+ "skipLink.label": "Skip to content",
+ "search.label": "Search",
+ "search.ctrlKey": "Ctrl",
+ "search.cancelLabel": "Cancel",
+ "search.devWarning": "Search is only available in production builds. \nTry building and previewing the site to test it out locally.",
+ "themeSelect.accessibleLabel": "Select theme",
+ "themeSelect.dark": "Dark",
+ "themeSelect.light": "Light",
+ "themeSelect.auto": "Auto",
+ "languageSelect.accessibleLabel": "Select language",
+ "menuButton.accessibleLabel": "Menu",
+ "sidebarNav.accessibleLabel": "Main",
+ "tableOfContents.onThisPage": "On this page",
+ "tableOfContents.overview": "Overview",
+ "i18n.untranslatedContent": "This content is not available in your language yet.",
+ "page.editLink": "Edit page",
+ "page.lastUpdated": "Last updated:",
+ "page.previousLink": "Previous",
+ "page.nextLink": "Next",
+ "page.draft": "This content is a draft and will not be included in production builds.",
+ "404.text": "Page not found. Check the URL or try using the search bar.",
+ "aside.note": "Note",
+ "aside.tip": "Tip",
+ "aside.caution": "Caution",
+ "aside.danger": "Danger",
+ "fileTree.directory": "Directory",
+ "builtWithStarlight.label": "Built with Starlight",
+ "heading.anchorLabel": "Section titled “{{title}}”",
+
+ "expressiveCode.copyButtonCopied": "Copied!",
+ "expressiveCode.copyButtonTooltip": "Copy to clipboard",
+ "expressiveCode.terminalWindowFallbackTitle": "Terminal window",
+
+ "pagefind.clear_search": "Clear",
+ "pagefind.load_more": "Load more results",
+ "pagefind.search_label": "Search this site",
+ "pagefind.filters_label": "Filters",
+ "pagefind.zero_results": "No results for [SEARCH_TERM]",
+ "pagefind.many_results": "[COUNT] results for [SEARCH_TERM]",
+ "pagefind.one_result": "[COUNT] result for [SEARCH_TERM]",
+ "pagefind.alt_search": "No results for [SEARCH_TERM]. Showing results for [DIFFERENT_TERM] instead",
+ "pagefind.search_suggestion": "No results for [SEARCH_TERM]. Try one of the following searches:",
+ "pagefind.searching": "Searching for [SEARCH_TERM]..."
+}
diff --git a/docs/src/generated/invocation-context.json b/docs/src/generated/invocation-context.json
new file mode 100644
index 00000000000..55116ec69dd
--- /dev/null
+++ b/docs/src/generated/invocation-context.json
@@ -0,0 +1,657 @@
+{
+ "description": "Provides access to various services and data for the current invocation.\n\nAttributes:\n images (ImagesInterface): Methods to save, get and update images and their metadata.\n tensors (TensorsInterface): Methods to save and get tensors, including image, noise, masks, and masked images.\n conditioning (ConditioningInterface): Methods to save and get conditioning data.\n models (ModelsInterface): Methods to check if a model exists, get a model, and get a model's info.\n logger (LoggerInterface): The app logger.\n config (ConfigInterface): The app config.\n util (UtilInterface): Utility methods, including a method to check if an invocation was canceled and step callbacks.\n boards (BoardsInterface): Methods to interact with boards.",
+ "interfaces": [
+ {
+ "description": "",
+ "methods": [
+ {
+ "description": "Gets an image as an ImageDTO object.",
+ "name": "get_dto",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The name of the image to get.",
+ "name": "image_name",
+ "type": "str"
+ }
+ ],
+ "return_type": "ImageDTO",
+ "returns": "The image as an ImageDTO object.",
+ "signature": "(image_name: str) -> ImageDTO"
+ },
+ {
+ "description": "Gets an image's metadata, if it has any.",
+ "name": "get_metadata",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The name of the image to get the metadata for.",
+ "name": "image_name",
+ "type": "str"
+ }
+ ],
+ "return_type": "Optional[MetadataField]",
+ "returns": "The image's metadata, if it has any.",
+ "signature": "(image_name: str) -> Optional[MetadataField]"
+ },
+ {
+ "description": "Gets the internal path to an image or thumbnail.",
+ "name": "get_path",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The name of the image to get the path of.",
+ "name": "image_name",
+ "type": "str"
+ },
+ {
+ "default": "False",
+ "description": "Get the path of the thumbnail instead of the full image",
+ "name": "thumbnail",
+ "type": "bool"
+ }
+ ],
+ "return_type": "Path",
+ "returns": "The local path of the image or thumbnail.",
+ "signature": "(image_name: str, thumbnail: bool = False) -> Path"
+ },
+ {
+ "description": "Gets an image as a PIL Image object. This method returns a copy of the image.",
+ "name": "get_pil",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The name of the image to get.",
+ "name": "image_name",
+ "type": "str"
+ },
+ {
+ "default": "None",
+ "description": "The color mode to convert the image to. If None, the original mode is used.",
+ "name": "mode",
+ "type": "Optional[Literal['L', 'RGB', 'RGBA', 'CMYK', 'YCbCr', 'LAB', 'HSV', 'I', 'F']]"
+ }
+ ],
+ "return_type": "Image",
+ "returns": "The image as a PIL Image object.",
+ "signature": "(image_name: str, mode: Optional[Literal['L', 'RGB', 'RGBA', 'CMYK', 'YCbCr', 'LAB', 'HSV', 'I', 'F']] = None) -> Image"
+ },
+ {
+ "description": "Saves an image, returning its DTO.\nIf the current queue item has a workflow or metadata, it is automatically saved with the image.",
+ "name": "save",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The image to save, as a PIL image.",
+ "name": "image",
+ "type": "Image"
+ },
+ {
+ "default": "None",
+ "description": "The board ID to add the image to, if it should be added. It the invocation inherits from `WithBoard`, that board will be used automatically. **Use this only if you want to override or provide a board manually!**",
+ "name": "board_id",
+ "type": "Optional[str]"
+ },
+ {
+ "default": "ImageCategory.GENERAL",
+ "description": "The category of the image. Only the GENERAL category is added to the gallery.",
+ "name": "image_category",
+ "type": "ImageCategory"
+ },
+ {
+ "default": "None",
+ "description": "The metadata to save with the image, if it should have any. If the invocation inherits from `WithMetadata`, that metadata will be used automatically. **Use this only if you want to override or provide metadata manually!**",
+ "name": "metadata",
+ "type": "Optional[MetadataField]"
+ }
+ ],
+ "return_type": "ImageDTO",
+ "returns": "The saved image DTO.",
+ "signature": "(image: Image, board_id: Optional[str] = None, image_category: ImageCategory = ImageCategory.GENERAL, metadata: Optional[MetadataField] = None) -> ImageDTO"
+ }
+ ],
+ "name": "ImagesInterface"
+ },
+ {
+ "description": "",
+ "methods": [
+ {
+ "description": "Loads a tensor by name. This method returns a copy of the tensor.",
+ "name": "load",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The name of the tensor to load.",
+ "name": "name",
+ "type": "str"
+ }
+ ],
+ "return_type": "Tensor",
+ "returns": "The tensor.",
+ "signature": "(name: str) -> Tensor"
+ },
+ {
+ "description": "Saves a tensor, returning its name.",
+ "name": "save",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The tensor to save.",
+ "name": "tensor",
+ "type": "Tensor"
+ }
+ ],
+ "return_type": "str",
+ "returns": "The name of the saved tensor.",
+ "signature": "(tensor: Tensor) -> str"
+ }
+ ],
+ "name": "TensorsInterface"
+ },
+ {
+ "description": "",
+ "methods": [
+ {
+ "description": "Loads conditioning data by name. This method returns a copy of the conditioning data.",
+ "name": "load",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The name of the conditioning data to load.",
+ "name": "name",
+ "type": "str"
+ }
+ ],
+ "return_type": "ConditioningFieldData",
+ "returns": "The conditioning data.",
+ "signature": "(name: str) -> ConditioningFieldData"
+ },
+ {
+ "description": "Saves a conditioning data object, returning its name.",
+ "name": "save",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The conditioning data to save.",
+ "name": "conditioning_data",
+ "type": "ConditioningFieldData"
+ }
+ ],
+ "return_type": "str",
+ "returns": "The name of the saved conditioning data.",
+ "signature": "(conditioning_data: ConditioningFieldData) -> str"
+ }
+ ],
+ "name": "ConditioningInterface"
+ },
+ {
+ "description": "Common API for loading, downloading and managing models.",
+ "methods": [
+ {
+ "description": "Download the model file located at source to the models cache and return its Path.\nThis can be used to single-file install models and other resources of arbitrary types\nwhich should not get registered with the database. If the model is already\ninstalled, the cached path will be returned. Otherwise it will be downloaded.",
+ "name": "download_and_cache_model",
+ "parameters": [
+ {
+ "default": "",
+ "description": "A URL that points to the model, or a huggingface repo_id.",
+ "name": "source",
+ "type": "str | AnyHttpUrl"
+ }
+ ],
+ "return_type": "Path",
+ "returns": "Path to the downloaded model",
+ "signature": "(source: str | AnyHttpUrl) -> Path"
+ },
+ {
+ "description": "Check if a model exists.",
+ "name": "exists",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The key or ModelField representing the model.",
+ "name": "identifier",
+ "type": "Union[str, ModelIdentifierField]"
+ }
+ ],
+ "return_type": "bool",
+ "returns": "True if the model exists, False if not.",
+ "signature": "(identifier: Union[str, ModelIdentifierField]) -> bool"
+ },
+ {
+ "description": "Gets the absolute path for a given model config or path.\nFor example, if the model's path is `flux/main/FLUX Dev.safetensors`, and the models path is\n`/home/username/InvokeAI/models`, this method will return\n`/home/username/InvokeAI/models/flux/main/FLUX Dev.safetensors`.",
+ "name": "get_absolute_path",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The model config or path.",
+ "name": "config_or_path",
+ "type": "Union[AnyModelConfig, Path, str]"
+ }
+ ],
+ "return_type": "Path",
+ "returns": "The absolute path to the model.",
+ "signature": "(config_or_path: Union[AnyModelConfig, Path, str]) -> Path"
+ },
+ {
+ "description": "Get a model's config.",
+ "name": "get_config",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The key or ModelField representing the model.",
+ "name": "identifier",
+ "type": "Union[str, ModelIdentifierField]"
+ }
+ ],
+ "return_type": "AnyModelConfig",
+ "returns": "The model's config.",
+ "signature": "(identifier: Union[str, ModelIdentifierField]) -> AnyModelConfig"
+ },
+ {
+ "description": "Load a model.",
+ "name": "load",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The key or ModelField representing the model.",
+ "name": "identifier",
+ "type": "Union[str, ModelIdentifierField]"
+ },
+ {
+ "default": "None",
+ "description": "The submodel of the model to get.",
+ "name": "submodel_type",
+ "type": "Optional[SubModelType]"
+ }
+ ],
+ "return_type": "LoadedModel",
+ "returns": "An object representing the loaded model.",
+ "signature": "(identifier: Union[str, ModelIdentifierField], submodel_type: Optional[SubModelType] = None) -> LoadedModel"
+ },
+ {
+ "description": "Load a model by its attributes.",
+ "name": "load_by_attrs",
+ "parameters": [
+ {
+ "default": "",
+ "description": "Name of the model.",
+ "name": "name",
+ "type": "str"
+ },
+ {
+ "default": "",
+ "description": "The models' base type, e.g. `BaseModelType.StableDiffusion1`, `BaseModelType.StableDiffusionXL`, etc.",
+ "name": "base",
+ "type": "BaseModelType"
+ },
+ {
+ "default": "",
+ "description": "Type of the model, e.g. `ModelType.Main`, `ModelType.Vae`, etc.",
+ "name": "type",
+ "type": "ModelType"
+ },
+ {
+ "default": "None",
+ "description": "The type of submodel to load, e.g. `SubModelType.UNet`, `SubModelType.TextEncoder`, etc. Only main models have submodels.",
+ "name": "submodel_type",
+ "type": "Optional[SubModelType]"
+ }
+ ],
+ "return_type": "LoadedModel",
+ "returns": "An object representing the loaded model.",
+ "signature": "(name: str, base: BaseModelType, type: ModelType, submodel_type: Optional[SubModelType] = None) -> LoadedModel"
+ },
+ {
+ "description": "Load the model file located at the indicated path\nIf a loader callable is provided, it will be invoked to load the model. Otherwise,\n`safetensors.torch.load_file()` or `torch.load()` will be called to load the model.\nBe aware that the LoadedModelWithoutConfig object has no `config` attribute",
+ "name": "load_local_model",
+ "parameters": [
+ {
+ "default": "",
+ "description": "",
+ "name": "model_path",
+ "type": "Path"
+ },
+ {
+ "default": "None",
+ "description": "A Callable that expects a Path and returns a dict[str|int, Any]",
+ "name": "loader",
+ "type": "Optional[Callable[[Path], AnyModel]]"
+ }
+ ],
+ "return_type": "LoadedModelWithoutConfig",
+ "returns": "A LoadedModelWithoutConfig object.",
+ "signature": "(model_path: Path, loader: Optional[Callable[[Path], AnyModel]] = None) -> LoadedModelWithoutConfig"
+ },
+ {
+ "description": "Download, cache, and load the model file located at the indicated URL or repo_id.\nIf the model is already downloaded, it will be loaded from the cache.\nIf the a loader callable is provided, it will be invoked to load the model. Otherwise,\n`safetensors.torch.load_file()` or `torch.load()` will be called to load the model.\nBe aware that the LoadedModelWithoutConfig object has no `config` attribute",
+ "name": "load_remote_model",
+ "parameters": [
+ {
+ "default": "",
+ "description": "A URL or huggingface repoid.",
+ "name": "source",
+ "type": "str | AnyHttpUrl"
+ },
+ {
+ "default": "None",
+ "description": "A Callable that expects a Path and returns a dict[str|int, Any]",
+ "name": "loader",
+ "type": "Optional[Callable[[Path], AnyModel]]"
+ }
+ ],
+ "return_type": "LoadedModelWithoutConfig",
+ "returns": "A LoadedModelWithoutConfig object.",
+ "signature": "(source: str | AnyHttpUrl, loader: Optional[Callable[[Path], AnyModel]] = None) -> LoadedModelWithoutConfig"
+ },
+ {
+ "description": "Search for models by attributes.",
+ "name": "search_by_attrs",
+ "parameters": [
+ {
+ "default": "None",
+ "description": "The name to search for (exact match).",
+ "name": "name",
+ "type": "Optional[str]"
+ },
+ {
+ "default": "None",
+ "description": "The base to search for, e.g. `BaseModelType.StableDiffusion1`, `BaseModelType.StableDiffusionXL`, etc.",
+ "name": "base",
+ "type": "Optional[BaseModelType]"
+ },
+ {
+ "default": "None",
+ "description": "Type type of model to search for, e.g. `ModelType.Main`, `ModelType.Vae`, etc.",
+ "name": "type",
+ "type": "Optional[ModelType]"
+ },
+ {
+ "default": "None",
+ "description": "The format of model to search for, e.g. `ModelFormat.Checkpoint`, `ModelFormat.Diffusers`, etc.",
+ "name": "format",
+ "type": "Optional[ModelFormat]"
+ }
+ ],
+ "return_type": "list[AnyModelConfig]",
+ "returns": "A list of models that match the attributes.",
+ "signature": "(name: Optional[str] = None, base: Optional[BaseModelType] = None, type: Optional[ModelType] = None, format: Optional[ModelFormat] = None) -> list[AnyModelConfig]"
+ },
+ {
+ "description": "Search for models by path.",
+ "name": "search_by_path",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The path to search for.",
+ "name": "path",
+ "type": "Path"
+ }
+ ],
+ "return_type": "list[AnyModelConfig]",
+ "returns": "A list of models that match the path.",
+ "signature": "(path: Path) -> list[AnyModelConfig]"
+ }
+ ],
+ "name": "ModelsInterface"
+ },
+ {
+ "description": "",
+ "methods": [
+ {
+ "description": "Logs a debug message.",
+ "name": "debug",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The message to log.",
+ "name": "message",
+ "type": "str"
+ }
+ ],
+ "return_type": "None",
+ "returns": "",
+ "signature": "(message: str) -> None"
+ },
+ {
+ "description": "Logs an error message.",
+ "name": "error",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The message to log.",
+ "name": "message",
+ "type": "str"
+ }
+ ],
+ "return_type": "None",
+ "returns": "",
+ "signature": "(message: str) -> None"
+ },
+ {
+ "description": "Logs an info message.",
+ "name": "info",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The message to log.",
+ "name": "message",
+ "type": "str"
+ }
+ ],
+ "return_type": "None",
+ "returns": "",
+ "signature": "(message: str) -> None"
+ },
+ {
+ "description": "Logs a warning message.",
+ "name": "warning",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The message to log.",
+ "name": "message",
+ "type": "str"
+ }
+ ],
+ "return_type": "None",
+ "returns": "",
+ "signature": "(message: str) -> None"
+ }
+ ],
+ "name": "LoggerInterface"
+ },
+ {
+ "description": "",
+ "methods": [
+ {
+ "description": "Gets the app's config.",
+ "name": "get",
+ "parameters": [],
+ "return_type": "InvokeAIAppConfig",
+ "returns": "The app's config.",
+ "signature": "() -> InvokeAIAppConfig"
+ }
+ ],
+ "name": "ConfigInterface"
+ },
+ {
+ "description": "",
+ "methods": [
+ {
+ "description": "The step callback for FLUX.2 Klein models (32-channel VAE).",
+ "name": "flux2_step_callback",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The intermediate state of the diffusion pipeline.",
+ "name": "intermediate_state",
+ "type": "PipelineIntermediateState"
+ }
+ ],
+ "return_type": "None",
+ "returns": "",
+ "signature": "(intermediate_state: PipelineIntermediateState) -> None"
+ },
+ {
+ "description": "The step callback emits a progress event with the current step, the total number of\nsteps, a preview image, and some other internal metadata.\nThis should be called after each denoising step.",
+ "name": "flux_step_callback",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The intermediate state of the diffusion pipeline.",
+ "name": "intermediate_state",
+ "type": "PipelineIntermediateState"
+ }
+ ],
+ "return_type": "None",
+ "returns": "",
+ "signature": "(intermediate_state: PipelineIntermediateState) -> None"
+ },
+ {
+ "description": "Checks if the current session has been canceled.",
+ "name": "is_canceled",
+ "parameters": [],
+ "return_type": "bool",
+ "returns": "True if the current session has been canceled, False if not.",
+ "signature": "() -> bool"
+ },
+ {
+ "description": "The step callback emits a progress event with the current step, the total number of\nsteps, a preview image, and some other internal metadata.\nThis should be called after each denoising step.",
+ "name": "sd_step_callback",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The intermediate state of the diffusion pipeline.",
+ "name": "intermediate_state",
+ "type": "PipelineIntermediateState"
+ },
+ {
+ "default": "",
+ "description": "The base model for the current denoising step.",
+ "name": "base_model",
+ "type": "BaseModelType"
+ }
+ ],
+ "return_type": "None",
+ "returns": "",
+ "signature": "(intermediate_state: PipelineIntermediateState, base_model: BaseModelType) -> None"
+ },
+ {
+ "description": "Signals the progress of some long-running invocation. The progress is displayed in the UI.\nIf a percentage is provided, the UI will display a progress bar and automatically append the percentage to the\nmessage. You should not include the percentage in the message.\nExample:\n```py\ntotal_steps = 10\nfor i in range(total_steps):\npercentage = i / (total_steps - 1)\ncontext.util.signal_progress(\"Doing something cool\", percentage)\n```\nIf an image is provided, the UI will display it. If your image should be displayed at a different size, provide\na tuple of `(width, height)` for the `image_size` parameter. The image will be displayed at the specified size\nin the UI.\nFor example, SD denoising progress images are 1/8 the size of the original image, so you'd do this to ensure the\nimage is displayed at the correct size:\n```py\n# Calculate the output size of the image (8x the progress image's size)\nwidth = progress_image.width * 8\nheight = progress_image.height * 8\n# Signal the progress with the image and output size\nsignal_progress(\"Denoising\", percentage, progress_image, (width, height))\n```\nIf your progress image is very large, consider downscaling it to reduce the payload size and provide the original\nsize to the `image_size` parameter. The PIL `thumbnail` method is useful for this, as it maintains the aspect\nratio of the image:\n```py\n# `thumbnail` modifies the image in-place, so we need to first make a copy\nthumbnail_image = progress_image.copy()\n# Resize the image to a maximum of 256x256 pixels, maintaining the aspect ratio\nthumbnail_image.thumbnail((256, 256))\n# Signal the progress with the thumbnail, passing the original size\nsignal_progress(\"Denoising\", percentage, thumbnail, progress_image.size)\n```",
+ "name": "signal_progress",
+ "parameters": [
+ {
+ "default": "",
+ "description": "A message describing the current status. Do not include the percentage in this message.",
+ "name": "message",
+ "type": "str"
+ },
+ {
+ "default": "None",
+ "description": "The current percentage completion for the process. Omit for indeterminate progress.",
+ "name": "percentage",
+ "type": "float | None"
+ },
+ {
+ "default": "None",
+ "description": "An optional image to display.",
+ "name": "image",
+ "type": "Image | None"
+ },
+ {
+ "default": "None",
+ "description": "The optional size of the image to display. If omitted, the image will be displayed at its original size.",
+ "name": "image_size",
+ "type": "tuple[int, int] | None"
+ }
+ ],
+ "return_type": "None",
+ "returns": "",
+ "signature": "(message: str, percentage: float | None = None, image: Image | None = None, image_size: tuple[int, int] | None = None) -> None"
+ }
+ ],
+ "name": "UtilInterface"
+ },
+ {
+ "description": "",
+ "methods": [
+ {
+ "description": "Adds an image to a board.",
+ "name": "add_image_to_board",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The ID of the board to add the image to.",
+ "name": "board_id",
+ "type": "str"
+ },
+ {
+ "default": "",
+ "description": "The name of the image to add to the board.",
+ "name": "image_name",
+ "type": "str"
+ }
+ ],
+ "return_type": "None",
+ "returns": "",
+ "signature": "(board_id: str, image_name: str) -> None"
+ },
+ {
+ "description": "Creates a board for the current user.",
+ "name": "create",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The name of the board to create.",
+ "name": "board_name",
+ "type": "str"
+ }
+ ],
+ "return_type": "BoardDTO",
+ "returns": "The created board DTO.",
+ "signature": "(board_name: str) -> BoardDTO"
+ },
+ {
+ "description": "Gets all boards accessible to the current user.",
+ "name": "get_all",
+ "parameters": [],
+ "return_type": "list[BoardDTO]",
+ "returns": "A list of all boards accessible to the current user.",
+ "signature": "() -> list[BoardDTO]"
+ },
+ {
+ "description": "Gets all image names for a board.",
+ "name": "get_all_image_names_for_board",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The ID of the board to get the image names for.",
+ "name": "board_id",
+ "type": "str"
+ }
+ ],
+ "return_type": "list[str]",
+ "returns": "A list of all image names for the board.",
+ "signature": "(board_id: str) -> list[str]"
+ },
+ {
+ "description": "Gets a board DTO.",
+ "name": "get_dto",
+ "parameters": [
+ {
+ "default": "",
+ "description": "The ID of the board to get.",
+ "name": "board_id",
+ "type": "str"
+ }
+ ],
+ "return_type": "BoardDTO",
+ "returns": "The board DTO.",
+ "signature": "(board_id: str) -> BoardDTO"
+ }
+ ],
+ "name": "BoardsInterface"
+ }
+ ],
+ "name": "InvocationContext"
+}
diff --git a/docs/src/generated/settings.json b/docs/src/generated/settings.json
new file mode 100644
index 00000000000..1987a90abce
--- /dev/null
+++ b/docs/src/generated/settings.json
@@ -0,0 +1,843 @@
+{
+ "settings": [
+ {
+ "category": "WEB",
+ "default": "127.0.0.1",
+ "description": "IP address to bind to. Use `0.0.0.0` to serve to your local network.",
+ "env_var": "INVOKEAI_HOST",
+ "literal_values": [],
+ "name": "host",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "WEB",
+ "default": 9090,
+ "description": "Port to bind to.",
+ "env_var": "INVOKEAI_PORT",
+ "literal_values": [],
+ "name": "port",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "WEB",
+ "default": [],
+ "description": "Allowed CORS origins.",
+ "env_var": "INVOKEAI_ALLOW_ORIGINS",
+ "literal_values": [],
+ "name": "allow_origins",
+ "required": false,
+ "type": "list[str]",
+ "validation": {}
+ },
+ {
+ "category": "WEB",
+ "default": true,
+ "description": "Allow CORS credentials.",
+ "env_var": "INVOKEAI_ALLOW_CREDENTIALS",
+ "literal_values": [],
+ "name": "allow_credentials",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "WEB",
+ "default": [
+ "*"
+ ],
+ "description": "Methods allowed for CORS.",
+ "env_var": "INVOKEAI_ALLOW_METHODS",
+ "literal_values": [],
+ "name": "allow_methods",
+ "required": false,
+ "type": "list[str]",
+ "validation": {}
+ },
+ {
+ "category": "WEB",
+ "default": [
+ "*"
+ ],
+ "description": "Headers allowed for CORS.",
+ "env_var": "INVOKEAI_ALLOW_HEADERS",
+ "literal_values": [],
+ "name": "allow_headers",
+ "required": false,
+ "type": "list[str]",
+ "validation": {}
+ },
+ {
+ "category": "WEB",
+ "default": null,
+ "description": "SSL certificate file for HTTPS. See https://www.uvicorn.dev/settings/#https.",
+ "env_var": "INVOKEAI_SSL_CERTFILE",
+ "literal_values": [],
+ "name": "ssl_certfile",
+ "required": false,
+ "type": "typing.Optional[pathlib.Path]",
+ "validation": {}
+ },
+ {
+ "category": "WEB",
+ "default": null,
+ "description": "SSL key file for HTTPS. See https://www.uvicorn.dev/settings/#https.",
+ "env_var": "INVOKEAI_SSL_KEYFILE",
+ "literal_values": [],
+ "name": "ssl_keyfile",
+ "required": false,
+ "type": "typing.Optional[pathlib.Path]",
+ "validation": {}
+ },
+ {
+ "category": "MISC FEATURES",
+ "default": false,
+ "description": "Enable logging of parsed prompt tokens.",
+ "env_var": "INVOKEAI_LOG_TOKENIZATION",
+ "literal_values": [],
+ "name": "log_tokenization",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "MISC FEATURES",
+ "default": true,
+ "description": "Enable patchmatch inpaint code.",
+ "env_var": "INVOKEAI_PATCHMATCH",
+ "literal_values": [],
+ "name": "patchmatch",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "models",
+ "description": "Path to the models directory.",
+ "env_var": "INVOKEAI_MODELS_DIR",
+ "literal_values": [],
+ "name": "models_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "models/.convert_cache",
+ "description": "Path to the converted models cache directory (DEPRECATED, but do not delete because it is needed for migration from previous versions).",
+ "env_var": "INVOKEAI_CONVERT_CACHE_DIR",
+ "literal_values": [],
+ "name": "convert_cache_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "models/.download_cache",
+ "description": "Path to the directory that contains dynamically downloaded models.",
+ "env_var": "INVOKEAI_DOWNLOAD_CACHE_DIR",
+ "literal_values": [],
+ "name": "download_cache_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "configs",
+ "description": "Path to directory of legacy checkpoint config files.",
+ "env_var": "INVOKEAI_LEGACY_CONF_DIR",
+ "literal_values": [],
+ "name": "legacy_conf_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "databases",
+ "description": "Path to InvokeAI databases directory.",
+ "env_var": "INVOKEAI_DB_DIR",
+ "literal_values": [],
+ "name": "db_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "outputs",
+ "description": "Path to directory for outputs.",
+ "env_var": "INVOKEAI_OUTPUTS_DIR",
+ "literal_values": [],
+ "name": "outputs_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "flat",
+ "description": "Strategy for organizing images into subfolders. 'flat' stores all images in a single folder. 'date' organizes by YYYY/MM/DD. 'type' organizes by image category. 'hash' uses first 2 characters of UUID for filesystem performance.",
+ "env_var": "INVOKEAI_IMAGE_SUBFOLDER_STRATEGY",
+ "literal_values": [
+ "flat",
+ "date",
+ "type",
+ "hash"
+ ],
+ "name": "image_subfolder_strategy",
+ "required": false,
+ "type": "typing.Literal['flat', 'date', 'type', 'hash']",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "nodes",
+ "description": "Path to directory for custom nodes.",
+ "env_var": "INVOKEAI_CUSTOM_NODES_DIR",
+ "literal_values": [],
+ "name": "custom_nodes_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "style_presets",
+ "description": "Path to directory for style presets.",
+ "env_var": "INVOKEAI_STYLE_PRESETS_DIR",
+ "literal_values": [],
+ "name": "style_presets_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "PATHS",
+ "default": "workflow_thumbnails",
+ "description": "Path to directory for workflow thumbnails.",
+ "env_var": "INVOKEAI_WORKFLOW_THUMBNAILS_DIR",
+ "literal_values": [],
+ "name": "workflow_thumbnails_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": [
+ "console"
+ ],
+ "description": "Log handler. Valid options are \"console\", \"file=\", \"syslog=path|address:host:port\", \"http=\".",
+ "env_var": "INVOKEAI_LOG_HANDLERS",
+ "literal_values": [],
+ "name": "log_handlers",
+ "required": false,
+ "type": "list[str]",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": "color",
+ "description": "Log format. Use \"plain\" for text-only, \"color\" for colorized output, \"legacy\" for 2.3-style logging and \"syslog\" for syslog-style.",
+ "env_var": "INVOKEAI_LOG_FORMAT",
+ "literal_values": [
+ "plain",
+ "color",
+ "syslog",
+ "legacy"
+ ],
+ "name": "log_format",
+ "required": false,
+ "type": "typing.Literal['plain', 'color', 'syslog', 'legacy']",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": "info",
+ "description": "Emit logging messages at this level or higher.",
+ "env_var": "INVOKEAI_LOG_LEVEL",
+ "literal_values": [
+ "debug",
+ "info",
+ "warning",
+ "error",
+ "critical"
+ ],
+ "name": "log_level",
+ "required": false,
+ "type": "typing.Literal['debug', 'info', 'warning', 'error', 'critical']",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": false,
+ "description": "Log SQL queries. `log_level` must be `debug` for this to do anything. Extremely verbose.",
+ "env_var": "INVOKEAI_LOG_SQL",
+ "literal_values": [],
+ "name": "log_sql",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": "warning",
+ "description": "Log level for network-related messages. 'info' and 'debug' are very verbose.",
+ "env_var": "INVOKEAI_LOG_LEVEL_NETWORK",
+ "literal_values": [
+ "debug",
+ "info",
+ "warning",
+ "error",
+ "critical"
+ ],
+ "name": "log_level_network",
+ "required": false,
+ "type": "typing.Literal['debug', 'info', 'warning', 'error', 'critical']",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": false,
+ "description": "Use in-memory database. Useful for development.",
+ "env_var": "INVOKEAI_USE_MEMORY_DB",
+ "literal_values": [],
+ "name": "use_memory_db",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": false,
+ "description": "Automatically reload when Python sources are changed. Does not reload node definitions.",
+ "env_var": "INVOKEAI_DEV_RELOAD",
+ "literal_values": [],
+ "name": "dev_reload",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": false,
+ "description": "Enable graph profiling using `cProfile`.",
+ "env_var": "INVOKEAI_PROFILE_GRAPHS",
+ "literal_values": [],
+ "name": "profile_graphs",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": null,
+ "description": "An optional prefix for profile output files.",
+ "env_var": "INVOKEAI_PROFILE_PREFIX",
+ "literal_values": [],
+ "name": "profile_prefix",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ },
+ {
+ "category": "LOGGING",
+ "default": "profiles",
+ "description": "Path to profiles output directory.",
+ "env_var": "INVOKEAI_PROFILES_DIR",
+ "literal_values": [],
+ "name": "profiles_dir",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": null,
+ "description": "The maximum amount of CPU RAM to use for model caching in GB. If unset, the limit will be configured based on the available RAM. In most cases, it is recommended to leave this unset.",
+ "env_var": "INVOKEAI_MAX_CACHE_RAM_GB",
+ "literal_values": [],
+ "name": "max_cache_ram_gb",
+ "required": false,
+ "type": "typing.Optional[float]",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": null,
+ "description": "The amount of VRAM to use for model caching in GB. If unset, the limit will be configured based on the available VRAM and the device_working_mem_gb. In most cases, it is recommended to leave this unset.",
+ "env_var": "INVOKEAI_MAX_CACHE_VRAM_GB",
+ "literal_values": [],
+ "name": "max_cache_vram_gb",
+ "required": false,
+ "type": "typing.Optional[float]",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": false,
+ "description": "If True, a memory snapshot will be captured before and after every model cache operation, and the result will be logged (at debug level). There is a time cost to capturing the memory snapshots, so it is recommended to only enable this feature if you are actively inspecting the model cache's behaviour.",
+ "env_var": "INVOKEAI_LOG_MEMORY_USAGE",
+ "literal_values": [],
+ "name": "log_memory_usage",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": 0,
+ "description": "How long to keep models in cache after last use, in minutes. A value of 0 (the default) means models are kept in cache indefinitely. If no model generations occur within the timeout period, the model cache is cleared using the same logic as the 'Clear Model Cache' button.",
+ "env_var": "INVOKEAI_MODEL_CACHE_KEEP_ALIVE_MIN",
+ "literal_values": [],
+ "name": "model_cache_keep_alive_min",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": 3,
+ "description": "The amount of working memory to keep available on the compute device (in GB). Has no effect if running on CPU. If you are experiencing OOM errors, try increasing this value.",
+ "env_var": "INVOKEAI_DEVICE_WORKING_MEM_GB",
+ "literal_values": [],
+ "name": "device_working_mem_gb",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": true,
+ "description": "Enable partial loading of models. This enables models to run with reduced VRAM requirements (at the cost of slower speed) by streaming the model from RAM to VRAM as its used. In some edge cases, partial loading can cause models to run more slowly if they were previously being fully loaded into VRAM.",
+ "env_var": "INVOKEAI_ENABLE_PARTIAL_LOADING",
+ "literal_values": [],
+ "name": "enable_partial_loading",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": true,
+ "description": "Whether to keep a full RAM copy of a model's weights when the model is loaded in VRAM. Keeping a RAM copy increases average RAM usage, but speeds up model switching and LoRA patching (assuming there is sufficient RAM). Set this to False if RAM pressure is consistently high.",
+ "env_var": "INVOKEAI_KEEP_RAM_COPY_OF_WEIGHTS",
+ "literal_values": [],
+ "name": "keep_ram_copy_of_weights",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": null,
+ "description": "DEPRECATED: This setting is no longer used. It has been replaced by `max_cache_ram_gb`, but most users will not need to use this config since automatic cache size limits should work well in most cases. This config setting will be removed once the new model cache behavior is stable.",
+ "env_var": "INVOKEAI_RAM",
+ "literal_values": [],
+ "name": "ram",
+ "required": false,
+ "type": "typing.Optional[float]",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": null,
+ "description": "DEPRECATED: This setting is no longer used. It has been replaced by `max_cache_vram_gb`, but most users will not need to use this config since automatic cache size limits should work well in most cases. This config setting will be removed once the new model cache behavior is stable.",
+ "env_var": "INVOKEAI_VRAM",
+ "literal_values": [],
+ "name": "vram",
+ "required": false,
+ "type": "typing.Optional[float]",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": true,
+ "description": "DEPRECATED: This setting is no longer used. Lazy-offloading is enabled by default. This config setting will be removed once the new model cache behavior is stable.",
+ "env_var": "INVOKEAI_LAZY_OFFLOAD",
+ "literal_values": [],
+ "name": "lazy_offload",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "CACHE",
+ "default": null,
+ "description": "Configure the Torch CUDA memory allocator. This will impact peak reserved VRAM usage and performance. Setting to \"backend:cudaMallocAsync\" works well on many systems. The optimal configuration is highly dependent on the system configuration (device type, VRAM, CUDA driver version, etc.), so must be tuned experimentally.",
+ "env_var": "INVOKEAI_PYTORCH_CUDA_ALLOC_CONF",
+ "literal_values": [],
+ "name": "pytorch_cuda_alloc_conf",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ },
+ {
+ "category": "DEVICE",
+ "default": "auto",
+ "description": "Preferred execution device. `auto` will choose the device depending on the hardware platform and the installed torch capabilities. Valid values: `auto`, `cpu`, `cuda`, `mps`, `cuda:N` (where N is a device number)",
+ "env_var": "INVOKEAI_DEVICE",
+ "literal_values": [],
+ "name": "device",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "DEVICE",
+ "default": "auto",
+ "description": "Devices to use for parallel generation. `auto` (the default) uses every available GPU, running one generation session per GPU concurrently and distributing jobs fairly across users. Provide an explicit list (e.g. `[cuda:0, cuda:1]`) to use specific devices, or a single-device list (e.g. `[cuda:0]`) to run serially. On systems without a GPU, `auto` resolves to the single `cpu`/`mps` device. Valid values: `auto`, or a list whose entries are each `cpu`, `cuda`, `mps`, or `cuda:N` (where N is a device number)",
+ "env_var": "INVOKEAI_GENERATION_DEVICES",
+ "literal_values": [],
+ "name": "generation_devices",
+ "required": false,
+ "type": "typing.Union[typing.Literal['auto'], list[str]]",
+ "validation": {}
+ },
+ {
+ "category": "DEVICE",
+ "default": "auto",
+ "description": "Floating point precision. `float16` will consume half the memory of `float32` but produce slightly lower-quality images. The `auto` setting will guess the proper precision based on your video card and operating system.",
+ "env_var": "INVOKEAI_PRECISION",
+ "literal_values": [
+ "auto",
+ "float16",
+ "bfloat16",
+ "float32"
+ ],
+ "name": "precision",
+ "required": false,
+ "type": "typing.Literal['auto', 'float16', 'bfloat16', 'float32']",
+ "validation": {}
+ },
+ {
+ "category": "GENERATION",
+ "default": false,
+ "description": "Whether to calculate guidance in serial instead of in parallel, lowering memory requirements.",
+ "env_var": "INVOKEAI_SEQUENTIAL_GUIDANCE",
+ "literal_values": [],
+ "name": "sequential_guidance",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "GENERATION",
+ "default": "auto",
+ "description": "Attention type.",
+ "env_var": "INVOKEAI_ATTENTION_TYPE",
+ "literal_values": [
+ "auto",
+ "normal",
+ "xformers",
+ "sliced",
+ "torch-sdp"
+ ],
+ "name": "attention_type",
+ "required": false,
+ "type": "typing.Literal['auto', 'normal', 'xformers', 'sliced', 'torch-sdp']",
+ "validation": {}
+ },
+ {
+ "category": "GENERATION",
+ "default": "auto",
+ "description": "Slice size, valid when attention_type==\"sliced\".",
+ "env_var": "INVOKEAI_ATTENTION_SLICE_SIZE",
+ "literal_values": [
+ "auto",
+ "balanced",
+ "max",
+ 1,
+ 2,
+ 3,
+ 4,
+ 5,
+ 6,
+ 7,
+ 8
+ ],
+ "name": "attention_slice_size",
+ "required": false,
+ "type": "typing.Literal['auto', 'balanced', 'max', 1, 2, 3, 4, 5, 6, 7, 8]",
+ "validation": {}
+ },
+ {
+ "category": "GENERATION",
+ "default": false,
+ "description": "Whether to enable tiled VAE decode (reduces memory consumption with some performance penalty).",
+ "env_var": "INVOKEAI_FORCE_TILED_DECODE",
+ "literal_values": [],
+ "name": "force_tiled_decode",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "GENERATION",
+ "default": 1,
+ "description": "The compress_level setting of PIL.Image.save(), used for PNG encoding. All settings are lossless. 0 = no compression, 1 = fastest with slightly larger filesize, 9 = slowest with smallest filesize. 1 is typically the best setting.",
+ "env_var": "INVOKEAI_PIL_COMPRESS_LEVEL",
+ "literal_values": [],
+ "name": "pil_compress_level",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "GENERATION",
+ "default": 10000,
+ "description": "Maximum number of items in the session queue.",
+ "env_var": "INVOKEAI_MAX_QUEUE_SIZE",
+ "literal_values": [],
+ "name": "max_queue_size",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "GENERATION",
+ "default": false,
+ "description": "Empties session queue on startup. If true, disables `max_queue_history`.",
+ "env_var": "INVOKEAI_CLEAR_QUEUE_ON_STARTUP",
+ "literal_values": [],
+ "name": "clear_queue_on_startup",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "GENERATION",
+ "default": null,
+ "description": "Keep the last N completed, failed, and canceled queue items. Older items are deleted on startup. Set to 0 to prune all terminal items. Ignored if `clear_queue_on_startup` is true.",
+ "env_var": "INVOKEAI_MAX_QUEUE_HISTORY",
+ "literal_values": [],
+ "name": "max_queue_history",
+ "required": false,
+ "type": "typing.Optional[int]",
+ "validation": {}
+ },
+ {
+ "category": "NODES",
+ "default": null,
+ "description": "List of nodes to allow. Omit to allow all.",
+ "env_var": "INVOKEAI_ALLOW_NODES",
+ "literal_values": [],
+ "name": "allow_nodes",
+ "required": false,
+ "type": "typing.Optional[list[str]]",
+ "validation": {}
+ },
+ {
+ "category": "NODES",
+ "default": null,
+ "description": "List of nodes to deny. Omit to deny none.",
+ "env_var": "INVOKEAI_DENY_NODES",
+ "literal_values": [],
+ "name": "deny_nodes",
+ "required": false,
+ "type": "typing.Optional[list[str]]",
+ "validation": {}
+ },
+ {
+ "category": "NODES",
+ "default": 512,
+ "description": "How many cached nodes to keep in memory.",
+ "env_var": "INVOKEAI_NODE_CACHE_SIZE",
+ "literal_values": [],
+ "name": "node_cache_size",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "MODEL INSTALL",
+ "default": "blake3_single",
+ "description": "Model hashing algorthim for model installs. 'blake3_multi' is best for SSDs. 'blake3_single' is best for spinning disk HDDs. 'random' disables hashing, instead assigning a UUID to models. Useful when using a memory db to reduce model installation time, or if you don't care about storing stable hashes for models. Alternatively, any other hashlib algorithm is accepted, though these are not nearly as performant as blake3.",
+ "env_var": "INVOKEAI_HASHING_ALGORITHM",
+ "literal_values": [
+ "blake3_multi",
+ "blake3_single",
+ "random",
+ "md5",
+ "sha1",
+ "sha224",
+ "sha256",
+ "sha384",
+ "sha512",
+ "blake2b",
+ "blake2s",
+ "sha3_224",
+ "sha3_256",
+ "sha3_384",
+ "sha3_512",
+ "shake_128",
+ "shake_256"
+ ],
+ "name": "hashing_algorithm",
+ "required": false,
+ "type": "typing.Literal['blake3_multi', 'blake3_single', 'random', 'md5', 'sha1', 'sha224', 'sha256', 'sha384', 'sha512', 'blake2b', 'blake2s', 'sha3_224', 'sha3_256', 'sha3_384', 'sha3_512', 'shake_128', 'shake_256']",
+ "validation": {}
+ },
+ {
+ "category": "MODEL INSTALL",
+ "default": null,
+ "description": "List of regular expression and token pairs used when downloading models from URLs. The download URL is tested against the regex, and if it matches, the token is provided in as a Bearer token.",
+ "env_var": "INVOKEAI_REMOTE_API_TOKENS",
+ "literal_values": [],
+ "name": "remote_api_tokens",
+ "required": false,
+ "type": "typing.Optional[list[invokeai.app.services.config.config_default.URLRegexTokenPair]]",
+ "validation": {}
+ },
+ {
+ "category": "MODEL INSTALL",
+ "default": false,
+ "description": "Scan the models directory on startup, registering orphaned models. This is typically only used in conjunction with `use_memory_db` for testing purposes.",
+ "env_var": "INVOKEAI_SCAN_MODELS_ON_STARTUP",
+ "literal_values": [],
+ "name": "scan_models_on_startup",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "MODEL INSTALL",
+ "default": false,
+ "description": "UNSAFE. Disable the picklescan security check during model installation. Recommended only for development and testing purposes. This will allow arbitrary code execution during model installation, so should never be used in production.",
+ "env_var": "INVOKEAI_UNSAFE_DISABLE_PICKLESCAN",
+ "literal_values": [],
+ "name": "unsafe_disable_picklescan",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "MODEL INSTALL",
+ "default": true,
+ "description": "Allow installation of models that we are unable to identify. If enabled, models will be marked as `unknown` in the database, and will not have any metadata associated with them. If disabled, unknown models will be rejected during installation.",
+ "env_var": "INVOKEAI_ALLOW_UNKNOWN_MODELS",
+ "literal_values": [],
+ "name": "allow_unknown_models",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "MULTIUSER",
+ "default": false,
+ "description": "Enable multiuser support. When disabled, the application runs in single-user mode using a default system account with administrator privileges. When enabled, requires user authentication and authorization.",
+ "env_var": "INVOKEAI_MULTIUSER",
+ "literal_values": [],
+ "name": "multiuser",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "MULTIUSER",
+ "default": false,
+ "description": "Enforce strict password requirements. When True, passwords must contain uppercase, lowercase, and numbers. When False (default), any password is accepted but its strength (weak/moderate/strong) is reported to the user.",
+ "env_var": "INVOKEAI_STRICT_PASSWORD_CHECKING",
+ "literal_values": [],
+ "name": "strict_password_checking",
+ "required": false,
+ "type": "",
+ "validation": {}
+ },
+ {
+ "category": "EXTERNAL PROVIDERS",
+ "default": null,
+ "description": "API key for Alibaba Cloud DashScope image generation.",
+ "env_var": "INVOKEAI_EXTERNAL_ALIBABACLOUD_API_KEY",
+ "literal_values": [],
+ "name": "external_alibabacloud_api_key",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ },
+ {
+ "category": "EXTERNAL PROVIDERS",
+ "default": null,
+ "description": "Base URL override for Alibaba Cloud DashScope image generation.",
+ "env_var": "INVOKEAI_EXTERNAL_ALIBABACLOUD_BASE_URL",
+ "literal_values": [],
+ "name": "external_alibabacloud_base_url",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ },
+ {
+ "category": "EXTERNAL PROVIDERS",
+ "default": null,
+ "description": "API key for Gemini image generation.",
+ "env_var": "INVOKEAI_EXTERNAL_GEMINI_API_KEY",
+ "literal_values": [],
+ "name": "external_gemini_api_key",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ },
+ {
+ "category": "EXTERNAL PROVIDERS",
+ "default": null,
+ "description": "API key for OpenAI image generation.",
+ "env_var": "INVOKEAI_EXTERNAL_OPENAI_API_KEY",
+ "literal_values": [],
+ "name": "external_openai_api_key",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ },
+ {
+ "category": "EXTERNAL PROVIDERS",
+ "default": null,
+ "description": "Base URL override for Gemini image generation.",
+ "env_var": "INVOKEAI_EXTERNAL_GEMINI_BASE_URL",
+ "literal_values": [],
+ "name": "external_gemini_base_url",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ },
+ {
+ "category": "EXTERNAL PROVIDERS",
+ "default": null,
+ "description": "Base URL override for OpenAI image generation.",
+ "env_var": "INVOKEAI_EXTERNAL_OPENAI_BASE_URL",
+ "literal_values": [],
+ "name": "external_openai_base_url",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ },
+ {
+ "category": "EXTERNAL PROVIDERS",
+ "default": null,
+ "description": "API key for Seedream image generation.",
+ "env_var": "INVOKEAI_EXTERNAL_SEEDREAM_API_KEY",
+ "literal_values": [],
+ "name": "external_seedream_api_key",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ },
+ {
+ "category": "EXTERNAL PROVIDERS",
+ "default": null,
+ "description": "Base URL override for Seedream image generation.",
+ "env_var": "INVOKEAI_EXTERNAL_SEEDREAM_BASE_URL",
+ "literal_values": [],
+ "name": "external_seedream_base_url",
+ "required": false,
+ "type": "typing.Optional[str]",
+ "validation": {}
+ }
+ ]
+}
diff --git a/docs/src/layouts/PageFrameExtended.astro b/docs/src/layouts/PageFrameExtended.astro
new file mode 100644
index 00000000000..9287376a4b9
--- /dev/null
+++ b/docs/src/layouts/PageFrameExtended.astro
@@ -0,0 +1,9 @@
+---
+import PageFrame from '@astrojs/starlight/components/PageFrame.astro';
+---
+
+
+
+
+
+
diff --git a/docs/src/lib/base-path.ts b/docs/src/lib/base-path.ts
new file mode 100644
index 00000000000..23042d899a5
--- /dev/null
+++ b/docs/src/lib/base-path.ts
@@ -0,0 +1,6 @@
+export const withBase = (path: string, baseUrl: string) => {
+ const normalizedBase = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+ const normalizedPath = path.replace(/^\//, '');
+
+ return `${normalizedBase}${normalizedPath}`;
+};
diff --git a/docs/src/lib/components/DownloadOptions.astro b/docs/src/lib/components/DownloadOptions.astro
new file mode 100644
index 00000000000..dfae32a4915
--- /dev/null
+++ b/docs/src/lib/components/DownloadOptions.astro
@@ -0,0 +1,197 @@
+---
+import { LinkCard, Icon, LinkButton } from '@astrojs/starlight/components';
+import { type StarlightIcon } from '@astrojs/starlight/types';
+import { withBase } from '../base-path';
+
+type LauncherDownloadOption = {
+ icon: StarlightIcon;
+ headline: string;
+ note: string;
+ launcherDownloadLink: string;
+ launcherDownloadLabel?: string;
+};
+const launcherDownloadOptions: Record = {
+ windows: {
+ icon: 'seti:windows',
+ headline: 'Download for Windows',
+ note: 'Requires Windows 10 or later, and NVIDIA or AMD GPU.',
+ launcherDownloadLink:
+ 'https://github.com/invoke-ai/launcher/releases/latest/download/Invoke.Community.Edition.Setup.latest.exe',
+ launcherDownloadLabel: 'Download EXE',
+ },
+ macos: {
+ icon: 'apple',
+ headline: 'Download for MacOS',
+ note: 'Requires Apple Silicon (M-Series). Not compatible with Intel.',
+ launcherDownloadLink:
+ 'https://github.com/invoke-ai/launcher/releases/latest/download/Invoke.Community.Edition-latest-arm64.dmg',
+ launcherDownloadLabel: 'Download DMG',
+ },
+ linux: {
+ icon: 'linux',
+ headline: 'Download for Linux',
+ note: 'Requires NVIDIA or AMD GPU. Compatible with most distributions.',
+ launcherDownloadLink:
+ 'https://github.com/invoke-ai/launcher/releases/latest/download/Invoke.Community.Edition-latest.AppImage',
+ launcherDownloadLabel: 'Download AppImage',
+ },
+};
+
+const manualDownloadOptions = {
+ github: {
+ headline: 'Download from GitHub',
+ description: 'For advanced users who want to set up Invoke manually or contribute to the project.',
+ href: 'https://github.com/invoke-ai/InvokeAI/releases',
+ },
+ docker: {
+ headline: 'Run with Docker',
+ description: 'For users who want to run Invoke without installing dependencies directly on their system.',
+ href: withBase('/configuration/docker/', import.meta.env.BASE_URL),
+ },
+};
+---
+
+
-> 
-> 
-
---------------------------------
-### Average Images
-
-**Description:** This node takes in a collection of images of the same size and averages them as output. It converts everything to RGB mode first.
-
-**Node Link:** https://github.com/JPPhoto/average-images-node
-
---------------------------------
-### Clean Image Artifacts After Cut
-
-Description: Removes residual artifacts after an image is separated from its background.
-
-Node Link: https://github.com/VeyDlin/clean-artifact-after-cut-node
-
-View:
-
-
---------------------------------
-### Close Color Mask
-
-Description: Generates a mask for images based on a closely matching color, useful for color-based selections.
-
-Node Link: https://github.com/VeyDlin/close-color-mask-node
-
-View:
-
-
---------------------------------
-### Clothing Mask
-
-Description: Employs a U2NET neural network trained for the segmentation of clothing items in images.
-
-Node Link: https://github.com/VeyDlin/clothing-mask-node
-
-View:
-
-
---------------------------------
-### Contrast Limited Adaptive Histogram Equalization
-
-Description: Enhances local image contrast using adaptive histogram equalization with contrast limiting.
-
-Node Link: https://github.com/VeyDlin/clahe-node
-
-View:
-
-
---------------------------------
-### Depth Map from Wavefront OBJ
-
-**Description:** Render depth maps from Wavefront .obj files (triangulated) using this simple 3D renderer utilizing numpy and matplotlib to compute and color the scene. There are simple parameters to change the FOV, camera position, and model orientation.
-
-To be imported, an .obj must use triangulated meshes, so make sure to enable that option if exporting from a 3D modeling program. This renderer makes each triangle a solid color based on its average depth, so it will cause anomalies if your .obj has large triangles. In Blender, the Remesh modifier can be helpful to subdivide a mesh into small pieces that work well given these limitations.
-
-**Node Link:** https://github.com/dwringer/depth-from-obj-node
-
-**Example Usage:**
-
-
---------------------------------
-### Film Grain
-
-**Description:** This node adds a film grain effect to the input image based on the weights, seeds, and blur radii parameters. It works with RGB input images only.
-
-**Node Link:** https://github.com/JPPhoto/film-grain-node
-
---------------------------------
-### Generative Grammar-Based Prompt Nodes
-
-**Description:** This set of 3 nodes generates prompts from simple user-defined grammar rules (loaded from custom files - examples provided below). The prompts are made by recursively expanding a special template string, replacing nonterminal "parts-of-speech" until no nonterminal terms remain in the string.
-
-This includes 3 Nodes:
-- *Lookup Table from File* - loads a YAML file "prompt" section (or of a whole folder of YAML's) into a JSON-ified dictionary (Lookups output)
-- *Lookups Entry from Prompt* - places a single entry in a new Lookups output under the specified heading
-- *Prompt from Lookup Table* - uses a Collection of Lookups as grammar rules from which to randomly generate prompts.
-
-**Node Link:** https://github.com/dwringer/generative-grammar-prompt-nodes
-
-**Example Usage:**
-
-
---------------------------------
-### GPT2RandomPromptMaker
-
-**Description:** A node for InvokeAI utilizes the GPT-2 language model to generate random prompts based on a provided seed and context.
-
-**Node Link:** https://github.com/mickr777/GPT2RandomPromptMaker
-
-**Output Examples**
-
-Generated Prompt: An enchanted weapon will be usable by any character regardless of their alignment.
-
-
-
-
---------------------------------
-### Halftone
-
-**Description**: Halftone converts the source image to grayscale and then performs halftoning. CMYK Halftone converts the image to CMYK and applies a per-channel halftoning to make the source image look like a magazine or newspaper. For both nodes, you can specify angles and halftone dot spacing.
-
-**Node Link:** https://github.com/JPPhoto/halftone-node
-
-**Example**
-
-Input:
-
-
-
---------------------------------
-
-### Image and Mask Composition Pack
-
-**Description:** This is a pack of nodes for composing masks and images, including a simple text mask creator and both image and latent offset nodes. The offsets wrap around, so these can be used in conjunction with the Seamless node to progressively generate centered on different parts of the seamless tiling.
-
-This includes 15 Nodes:
-
-- *Adjust Image Hue Plus* - Rotate the hue of an image in one of several different color spaces.
-- *Blend Latents/Noise (Masked)* - Use a mask to blend part of one latents tensor [including Noise outputs] into another. Can be used to "renoise" sections during a multi-stage [masked] denoising process.
-- *Enhance Image* - Boost or reduce color saturation, contrast, brightness, sharpness, or invert colors of any image at any stage with this simple wrapper for pillow [PIL]'s ImageEnhance module.
-- *Equivalent Achromatic Lightness* - Calculates image lightness accounting for Helmholtz-Kohlrausch effect based on a method described by High, Green, and Nussbaum (2023).
-- *Text to Mask (Clipseg)* - Input a prompt and an image to generate a mask representing areas of the image matched by the prompt.
-- *Text to Mask Advanced (Clipseg)* - Output up to four prompt masks combined with logical "and", logical "or", or as separate channels of an RGBA image.
-- *Image Layer Blend* - Perform a layered blend of two images using alpha compositing. Opacity of top layer is selectable, with optional mask and several different blend modes/color spaces.
-- *Image Compositor* - Take a subject from an image with a flat backdrop and layer it on another image using a chroma key or flood select background removal.
-- *Image Dilate or Erode* - Dilate or expand a mask (or any image!). This is equivalent to an expand/contract operation.
-- *Image Value Thresholds* - Clip an image to pure black/white beyond specified thresholds.
-- *Offset Latents* - Offset a latents tensor in the vertical and/or horizontal dimensions, wrapping it around.
-- *Offset Image* - Offset an image in the vertical and/or horizontal dimensions, wrapping it around.
-- *Rotate/Flip Image* - Rotate an image in degrees clockwise/counterclockwise about its center, optionally resizing the image boundaries to fit, or flipping it about the vertical and/or horizontal axes.
-- *Shadows/Highlights/Midtones* - Extract three masks (with adjustable hard or soft thresholds) representing shadows, midtones, and highlights regions of an image.
-- *Text Mask (simple 2D)* - create and position a white on black (or black on white) line of text using any font locally available to Invoke.
-
-**Node Link:** https://github.com/dwringer/composition-nodes
-
-
-
---------------------------------
-### Image Dominant Color
-
-Description: Identifies and extracts the dominant color from an image using k-means clustering.
-
-Node Link: https://github.com/VeyDlin/image-dominant-color-node
-
-View:
-
-
---------------------------------
-### Image to Character Art Image Nodes
-
-**Description:** Group of nodes to convert an input image into ascii/unicode art Image
-
-**Node Link:** https://github.com/mickr777/imagetoasciiimage
-
-**Output Examples**
-
-
-
-
---------------------------------
-### Latent Upscale
-
-**Description:** This node uses a small (~2.4mb) model to upscale the latents used in a Stable Diffusion 1.5 or Stable Diffusion XL image generation, rather than the typical interpolation method, avoiding the traditional downsides of the latent upscale technique.
-
-**Node Link:** [https://github.com/gogurtenjoyer/latent-upscale](https://github.com/gogurtenjoyer/latent-upscale)
-
---------------------------------
-### Load Video Frame
-
-**Description:** This is a video frame image provider + indexer/video creation nodes for hooking up to iterators and ranges and ControlNets and such for invokeAI node experimentation. Think animation + ControlNet outputs.
-
-**Node Link:** https://github.com/helix4u/load_video_frame
-
-**Output Example:**
-
-
---------------------------------
-### Make 3D
-
-**Description:** Create compelling 3D stereo images from 2D originals.
-
-**Node Link:** [https://gitlab.com/srcrr/shift3d/-/raw/main/make3d.py](https://gitlab.com/srcrr/shift3d)
-
-**Example Node Graph:** https://gitlab.com/srcrr/shift3d/-/raw/main/example-workflow.json?ref_type=heads&inline=false
-
-**Output Examples**
-
-
-
-
---------------------------------
-### Mask Operations
-
-Description: Offers logical operations (OR, SUB, AND) for combining and manipulating image masks.
-
-Node Link: https://github.com/VeyDlin/mask-operations-node
-
-View:
-
-
---------------------------------
-### Match Histogram
-
-**Description:** An InvokeAI node to match a histogram from one image to another. This is a bit like the `color correct` node in the main InvokeAI but this works in the YCbCr colourspace and can handle images of different sizes. Also does not require a mask input.
-- Option to only transfer luminance channel.
-- Option to save output as grayscale
-
-A good use case for this node is to normalize the colors of an image that has been through the tiled scaling workflow of my XYGrid Nodes.
-
-See full docs here: https://github.com/skunkworxdark/Prompt-tools-nodes/edit/main/README.md
-
-**Node Link:** https://github.com/skunkworxdark/match_histogram
-
-**Output Examples**
-
-
-
---------------------------------
-### Nightmare Promptgen
-
-**Description:** Nightmare Prompt Generator - Uses a local text generation model to create unique imaginative (but usually nightmarish) prompts for InvokeAI. By default, it allows you to choose from some gpt-neo models I finetuned on over 2500 of my own InvokeAI prompts in Compel format, but you're able to add your own, as well. Offers support for replacing any troublesome words with a random choice from list you can also define.
-
-**Node Link:** [https://github.com/gogurtenjoyer/nightmare-promptgen](https://github.com/gogurtenjoyer/nightmare-promptgen)
-
---------------------------------
-### Oobabooga
-
-**Description:** asks a local LLM running in Oobabooga's Text-Generation-Webui to write a prompt based on the user input.
-
-**Link:** https://github.com/sammyf/oobabooga-node
-
-**Example:**
-
-"describe a new mystical creature in its natural environment"
-
-*can return*
-
-"The mystical creature I am describing to you is called the "Glimmerwing". It is a majestic, iridescent being that inhabits the depths of the most enchanted forests and glimmering lakes. Its body is covered in shimmering scales that reflect every color of the rainbow, and it has delicate, translucent wings that sparkle like diamonds in the sunlight. The Glimmerwing's home is a crystal-clear lake, surrounded by towering trees with leaves that shimmer like jewels. In this serene environment, the Glimmerwing spends its days swimming gracefully through the water, chasing schools of glittering fish and playing with the gentle ripples of the lake's surface.
-As the sun sets, the Glimmerwing perches on a branch of one of the trees, spreading its wings to catch the last rays of light. The creature's scales glow softly, casting a rainbow of colors across the forest floor. The Glimmerwing sings a haunting melody, its voice echoing through the stillness of the night air. Its song is said to have the power to heal the sick and bring peace to troubled souls. Those who are lucky enough to hear the Glimmerwing's song are forever changed by its beauty and grace."
-
-
-
---------------------------------
-### Remote Image
-
-**Description:** This is a pack of nodes to interoperate with other services, be they public websites or bespoke local servers. The pack consists of these nodes:
-
-- *Load Remote Image* - Lets you load remote images such as a realtime webcam image, an image of the day, or dynamically created images.
-- *Post Image to Remote Server* - Lets you upload an image to a remote server using an HTTP POST request, eg for storage, display or further processing.
-
-**Node Link:** https://github.com/fieldOfView/InvokeAI-remote_image
-
---------------------------------
-
-### BriaAI Remove Background
-
-**Description**: Implements one click background removal with BriaAI's new version 1.4 model which seems to be be producing better results than any other previous background removal tool.
-
-**Node Link:** https://github.com/blessedcoolant/invoke_bria_rmbg
-
-**View**
-
-
---------------------------------
-### Remove Background
-
-Description: An integration of the rembg package to remove backgrounds from images using multiple U2NET models.
-
-Node Link: https://github.com/VeyDlin/remove-background-node
-
-View:
-
-
---------------------------------
-### Retroize
-
-**Description:** Retroize is a collection of nodes for InvokeAI to "Retroize" images. Any image can be given a fresh coat of retro paint with these nodes, either from your gallery or from within the graph itself. It includes nodes to pixelize, quantize, palettize, and ditherize images; as well as to retrieve palettes from existing images.
-
-**Node Link:** https://github.com/Ar7ific1al/invokeai-retroizeinode/
-
-**Retroize Output Examples**
-
-
-
-
---------------------------------
-### Size Stepper Nodes
-
-**Description:** This is a set of nodes for calculating the necessary size increments for doing upscaling workflows. Use the *Final Size & Orientation* node to enter your full size dimensions and orientation (portrait/landscape/random), then plug that and your initial generation dimensions into the *Ideal Size Stepper* and get 1, 2, or 3 intermediate pairs of dimensions for upscaling. Note this does not output the initial size or full size dimensions: the 1, 2, or 3 outputs of this node are only the intermediate sizes.
-
-A third node is included, *Random Switch (Integers)*, which is just a generic version of Final Size with no orientation selection.
-
-**Node Link:** https://github.com/dwringer/size-stepper-nodes
-
-**Example Usage:**
-
-
---------------------------------
-### Text font to Image
-
-**Description:** text font to text image node for InvokeAI, download a font to use (or if in font cache uses it from there), the text is always resized to the image size, but can control that with padding, optional 2nd line
-
-**Node Link:** https://github.com/mickr777/textfontimage
-
-**Output Examples**
-
-
-
-
---------------------------------
-### Example Node Template
-
-**Description:** This node allows you to do super cool things with InvokeAI.
-
-**Node Link:** https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/app/invocations/prompt.py
-
-**Example Workflow:** https://github.com/invoke-ai/InvokeAI/blob/docs/main/docs/workflows/Prompt_from_File.json
-
-**Output Examples**
-
-
-
-
-## Disclaimer
-
-The nodes linked have been developed and contributed by members of the Invoke AI community. While we strive to ensure the quality and safety of these contributions, we do not guarantee the reliability or security of the nodes. If you have issues or concerns with any of the nodes below, please raise it on GitHub or in the Discord.
-
-
-## Help
-If you run into any issues with a node, please post in the [InvokeAI Discord](https://discord.gg/ZmtBAhwWhy).
-
diff --git a/docs/nodes/contributingNodes.md b/docs/nodes/contributingNodes.md
deleted file mode 100644
index 7a30c8aeb0f..00000000000
--- a/docs/nodes/contributingNodes.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# Contributing Nodes
-
-To learn about the specifics of creating a new node, please visit our [Node creation documentation](../contributing/INVOCATIONS.md).
-
-Once you’ve created a node and confirmed that it behaves as expected locally, follow these steps:
-
-- Make sure the node is contained in a new Python (.py) file. Preferably, the node is in a repo with a README detailing the nodes usage & examples to help others more easily use your node. Including the tag "invokeai-node" in your repository's README can also help other users find it more easily.
-- Submit a pull request with a link to your node(s) repo in GitHub against the `main` branch to add the node to the [Community Nodes](communityNodes.md) list
- - Make sure you are following the template below and have provided all relevant details about the node and what it does. Example output images and workflows are very helpful for other users looking to use your node.
-- A maintainer will review the pull request and node. If the node is aligned with the direction of the project, you may be asked for permission to include it in the core project.
-
-### Community Node Template
-
-```markdown
---------------------------------
-### Super Cool Node Template
-
-**Description:** This node allows you to do super cool things with InvokeAI.
-
-**Node Link:** https://github.com/invoke-ai/InvokeAI/fake_node.py
-
-**Example Node Graph:** https://github.com/invoke-ai/InvokeAI/fake_node_graph.json
-
-**Output Examples**
-
-
-```
diff --git a/docs/nodes/defaultNodes.md b/docs/nodes/defaultNodes.md
deleted file mode 100644
index b78c9af9010..00000000000
--- a/docs/nodes/defaultNodes.md
+++ /dev/null
@@ -1,109 +0,0 @@
-# List of Default Nodes
-
-The table below contains a list of the default nodes shipped with InvokeAI and
-their descriptions.
-
-| Node 
-> 
-> 
+
+---
+
+### Average Images
+
+**Description:** This node takes in a collection of images of the same size and averages them as output. It converts everything to RGB mode first.
+
+**Node Link:** https://github.com/JPPhoto/average-images-node
+
+---
+
+### BiRefNet Background Removal
+
+**Description:** Remove image backgrounds using BiRefNet (Bilateral Reference Network), a high-quality segmentation model. Supports multiple model variants including standard, high-resolution, matting, portrait, and specialized models for different use cases.
+
+**Node Link:** https://github.com/veeliks/invoke_birefnet
+
+**Output Examples**
+
+
+ 
+
+
+---
+
+### Film Grain
+
+**Description:** This node adds a film grain effect to the input image based on the weights, seeds, and blur radii parameters. It works with RGB input images only.
+
+**Node Link:** https://github.com/JPPhoto/film-grain-node
+
+---
+
+### Flip Pose
+
+**Description:** This node will flip an openpose image horizontally, recoloring it to make sure that it isn't facing the wrong direction. Note that it does not work with openpose hands.
+
+**Node Link:** https://github.com/JPPhoto/flip-pose-node
+
+---
+
+### Flux Ideal Size
+
+**Description:** This node returns an ideal size to use for the first stage of a Flux image generation pipeline. Generating at the right size helps limit duplication and odd subject placement.
+
+**Node Link:** https://github.com/JPPhoto/flux-ideal-size
+
+---
+
+### Generative Grammar-Based Prompt Nodes
+
+**Description:** This set of 3 nodes generates prompts from simple user-defined grammar rules (loaded from custom files - examples provided below). The prompts are made by recursively expanding a special template string, replacing nonterminal "parts-of-speech" until no nonterminal terms remain in the string.
+
+This includes 3 Nodes:
+- *Lookup Table from File* - loads a YAML file "prompt" section (or of a whole folder of YAML's) into a JSON-ified dictionary (Lookups output)
+- *Lookups Entry from Prompt* - places a single entry in a new Lookups output under the specified heading
+- *Prompt from Lookup Table* - uses a Collection of Lookups as grammar rules from which to randomly generate prompts.
+
+**Node Link:** https://github.com/dwringer/generative-grammar-prompt-nodes
+
+**Example Usage:**
+
+
+ 
+ 
+ 
+ 
+
+
+---
+### Make 3D
+
+**Description:** Create compelling 3D stereo images from 2D originals.
+
+**Node Link:** [https://gitlab.com/srcrr/shift3d/-/raw/main/make3d.py](https://gitlab.com/srcrr/shift3d)
+
+**Example Node Graph:** https://gitlab.com/srcrr/shift3d/-/raw/main/example-workflow.json?ref_type=heads&inline=false
+
+**Output Examples**
+
+
+
+**Description:** an extensive suite of auto prompt generation and prompt helper nodes based on extensive logic. Get creative with the best prompt generator in the world.
+
+The main node generates interesting prompts based on a set of parameters. There are also some additional nodes such as Auto Negative Prompt, One Button Artify, Create Prompt Variant and other cool prompt toys to play around with.
+
+**Node Link:** [https://github.com/AIrjen/OneButtonPrompt_X_InvokeAI](https://github.com/AIrjen/OneButtonPrompt_X_InvokeAI)
+
+**Nodes:**
+
+
+
+---
+
+### Oobabooga
+
+**Description:** asks a local LLM running in Oobabooga's Text-Generation-Webui to write a prompt based on the user input.
+
+**Link:** https://github.com/sammyf/oobabooga-node
+
+**Example:**
+
+"describe a new mystical creature in its natural environment"
+
+*can return*
+
+"The mystical creature I am describing to you is called the "Glimmerwing". It is a majestic, iridescent being that inhabits the depths of the most enchanted forests and glimmering lakes. Its body is covered in shimmering scales that reflect every color of the rainbow, and it has delicate, translucent wings that sparkle like diamonds in the sunlight. The Glimmerwing's home is a crystal-clear lake, surrounded by towering trees with leaves that shimmer like jewels. In this serene environment, the Glimmerwing spends its days swimming gracefully through the water, chasing schools of glittering fish and playing with the gentle ripples of the lake's surface.
+As the sun sets, the Glimmerwing perches on a branch of one of the trees, spreading its wings to catch the last rays of light. The creature's scales glow softly, casting a rainbow of colors across the forest floor. The Glimmerwing sings a haunting melody, its voice echoing through the stillness of the night air. Its song is said to have the power to heal the sick and bring peace to troubled souls. Those who are lucky enough to hear the Glimmerwing's song are forever changed by its beauty and grace."
+
+
+
+---
+
+### Remote Image
+
+**Description:** This is a pack of nodes to interoperate with other services, be they public websites or bespoke local servers. The pack consists of these nodes:
+
+- *Load Remote Image* - Lets you load remote images such as a realtime webcam image, an image of the day, or dynamically created images.
+- *Post Image to Remote Server* - Lets you upload an image to a remote server using an HTTP POST request, eg for storage, display or further processing.
+
+**Node Link:** https://github.com/fieldOfView/InvokeAI-remote_image
+
+---
+
+### BriaAI Remove Background
+
+**Description**: Implements one click background removal with BriaAI's new version 1.4 model which seems to be producing better results than any other previous background removal tool.
+
+**Node Link:** https://github.com/blessedcoolant/invoke_bria_rmbg
+
+**View**
+
+
+---
+
+### Simple Skin Detection
+
+Description: Detects skin in images based on predefined color thresholds.
+
+Node Link: https://github.com/VeyDlin/simple-skin-detection-node
+
+View:
+
+
+
+---
+
+### Example Node Template
+
+**Description:** This node allows you to do super cool things with InvokeAI.
+
+**Node Link:** https://github.com/invoke-ai/InvokeAI/blob/main/invokeai/app/invocations/prompt.py
+
+**Example Workflow:** https://github.com/invoke-ai/InvokeAI/blob/docs/main/docs/workflows/Prompt_from_File.json
+
+**Output Examples**
+
+