opencode_gesis/README.md

GESIS OpenCode Desktop Installer

This folder contains a Windows GUI installer for OpenCode Desktop that configures the GESIS AI Server provider.

The installer:

• downloads the latest Windows x64 OpenCode Desktop release from anomalyco/opencode
• starts the official OpenCode Desktop installer
• asks each user for their personal GESIS AI Server API key
• checks the key against the GESIS AI Server before installing
• shows all models available to that key in a checkbox grid with every model selected by default
• writes only the selected models into the OpenCode config
• writes the OpenCode config to %USERPROFILE%\.config\opencode\opencode.json
• restricts OpenCode to the GESIS provider with enabled_providers
• explicitly disables known Zen/OpenCode default provider IDs
• backs up an existing config before replacing it

Install

For normal users, distribute and run:

GESIS-OpenCode-Installer.exe

They paste their personal GESIS API key, click Check API key, choose which available models they want to use in OpenCode from the checkbox grid, and click Install selected models.

The installer starts compact for API-key entry, then maximizes automatically after models are found so the model grid is visible. The main action buttons stay fixed at the bottom of the window, and only the content area scrolls as a fallback for high Windows text scaling or very large model sets.

Rebuild the EXE

Open PowerShell in this folder and run:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\Build-GuiInstaller.ps1

The older PowerShell installer is kept as an administrator fallback:

.\Install-OpenCode-GESIS.ps1

Files

• GESIS-OpenCode-Installer.exe is the GUI installer for distribution.
• GesisOpenCodeInstaller.cs is the GUI installer source.
• Build-GuiInstaller.ps1 rebuilds the GUI installer.
• app.manifest keeps the installer DPI-aware on Windows.
• GESIS Logo Blau EN.jpg and GESIS Signet Blau_transp.png are embedded into the EXE when it is rebuilt.
• Install-OpenCode-GESIS.ps1 is the PowerShell fallback installer.
• opencode.gesis.template.json is a safe template with no personal API key.
• opencode.json mirrors the template and no longer contains a real API key.