[Bug]: [ERROR] Codex SEO runtime bootstrap failed (Windows)

[Juansecu]

What happened?

I ran both install.ps1 and install.sh scripts in my Windows computer, and I got the following outputs:

• install.ps1

  # When running command irm https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.ps1 | iex
  # and clonning the repository and running command powershell -ExecutionPolicy Bypass .\install.ps1
  ========================================
    Codex SEO - Installer
    Codex Skill Suite
  ========================================
  
  [OK] Python 3.14 detected
  [INFO] Downloading Codex SEO (v1.9.6-codex.5)...
  [INFO] Resetting existing Codex SEO install...
  [INFO] Installing skill files...
  [INFO] Installing agent profiles...
  [INFO] Bootstrapping Python runtime...
  Codex SEO runtime bootstrap failed.
  At line:328 char:9
  +         throw "Codex SEO runtime bootstrap failed."
  +         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      + CategoryInfo          : OperationStopped: (Codex SEO runtime bootstrap failed.:String) [], RuntimeException
      + FullyQualifiedErrorId : Codex SEO runtime bootstrap failed.

• install.sh

  # When running command curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.sh | bash
  # and cloning the repository and running command bash install.sh
  # using Git Bash
  ========================================
    Codex SEO - Installer
    Codex Skill Suite
  ========================================
  
  [OK] Python 3.14 detected
  [INFO] Downloading Codex SEO (v1.9.6-codex.5)...
  [INFO] Resetting existing Codex SEO install...
  [INFO] Installing skill files...
  [INFO] Installing agent profiles...
  [INFO] Bootstrapping Python runtime...
  [ERROR] Codex SEO runtime bootstrap failed.
  Traceback (most recent call last):
    File "<string>", line 10, in <module>
      notes = payload.get("verification", {}).get("notes", [])
              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  AttributeError: 'NoneType' object has no attribute 'get'

Steps to Reproduce

1. Run any irm https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.ps1 | iex (Powershell) or curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.sh | bash (Git Bash) command in a Windows 11 computer
2. You will get the outputs previously mentioned

Environment

Windows 11, Python 3.14.6

Logs / Screenshots

- `install.ps1`
  
  # When running command irm https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.ps1 | iex
  # and clonning the repository and running command powershell -ExecutionPolicy Bypass .\install.ps1
  ========================================
    Codex SEO - Installer
    Codex Skill Suite
  ========================================

  [OK] Python 3.14 detected
  [INFO] Downloading Codex SEO (v1.9.6-codex.5)...
  [INFO] Resetting existing Codex SEO install...
  [INFO] Installing skill files...
  [INFO] Installing agent profiles...
  [INFO] Bootstrapping Python runtime...
  Codex SEO runtime bootstrap failed.
  At line:328 char:9
  +         throw "Codex SEO runtime bootstrap failed."
  +         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      + CategoryInfo          : OperationStopped: (Codex SEO runtime bootstrap failed.:String) [], RuntimeException
      + FullyQualifiedErrorId : Codex SEO runtime bootstrap failed.
  
- `install.sh`
  
  # When running command curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.sh | bash
  # and cloning the repository and running command bash install.sh
  # using Git Bash
  ========================================
    Codex SEO - Installer
    Codex Skill Suite
  ========================================

  [OK] Python 3.14 detected
  [INFO] Downloading Codex SEO (v1.9.6-codex.5)...
  [INFO] Resetting existing Codex SEO install...
  [INFO] Installing skill files...
  [INFO] Installing agent profiles...
  [INFO] Bootstrapping Python runtime...
  [ERROR] Codex SEO runtime bootstrap failed.
  Traceback (most recent call last):
    File "<string>", line 10, in <module>
      notes = payload.get("verification", {}).get("notes", [])
              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  AttributeError: 'NoneType' object has no attribute 'get'

[MasterCardinal]

I have exactly the same problem on Windows 10.

[DarkWingMcQuack]

i have the same problem on NixOS

[infinuts]

root cause: install.ps1 fails on Windows if WeasyPrint can't load its GTK3 native libraries — even though this only affects PDF report generation, not core functionality. In my case, Windows was picking up libgobject-2.0-0.dll from C:\Program Files\Tesseract-OCR (which ships its own incompatible copy for internal use) instead of a proper GTK3 runtime, causing:

cannot load library 'C:\Program Files\Tesseract-OCR\libgobject-2.0-0.dll': error 0x7e
and later:
python.exe - Point d'entrée introuvable Le point d'entrée de procédure g_bookmark_file_copy est introuvable...

Two separate problems:

bug in install.ps1: the bootstrap failure block only prints verification.notes if present, and swallows the actual error/output otherwise — so users just see "Codex SEO runtime bootstrap failed." with zero indication of why. It should always dump bootstrapPayload.error and raw stdout/stderr on failure.
bug in severity handling: the installer hard-fails the entire install if full_ready is false, even when all required groups (core/visual/google) succeeded and only the optional premium_report (WeasyPrint/PDF) group is degraded. This should be a warning, not a fatal error — someone who doesn't need PDF export shouldn't be blocked from installing at all.

fix for anyone hitting this specific DLL error (Windows + Tesseract-OCR installed):

install the GTK3 runtime: https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases
Set WEASYPRINT_DLL_DIRECTORIES to force WeasyPrint to use the correct GTK3 folder instead of Tesseract's bundled copy:
cmd
setx WEASYPRINT_DLL_DIRECTORIES "C:\Program Files\GTK3-Runtime Win64\bin"
Open a new terminal, verify with scripts\verify_environment.py --json (should show weasyprint.ok: true)
re-run install.ps1, completes successfully, if the owners lazy, i'll be adding a pr fixing it soon