====== OpenCode install on Linux Mint ======

===== Software installation =====
==== install npm installer ====

The best result is acchieved with an install through npm. install npm:
<code>
sudo apt update
apt install npm
</code>

==== install opencode ====

<code>
npm install -g opencode-ai
</code>

reload your shell (or login again) ''exec zsh''

verify with:
<code>
opencode --version
</code>



===== run the opencode application =====

==== start opencode manually ====

''%%/home/abel/.opencode/bin/opencode --port 4096 --hostname 0.0.0.0%%''

==== Auto-Start at Boot time ====

Create a systemd Service File
''sudo vi /etc/systemd/system/opencode.service''\\
add:
<code>
[Unit]
Description=OpenCode AI Assistant
After=network.target

[Service]
Type=simple
User=abel
ProtectHome=false
WorkingDirectory=/home/abel/opencode/projects
ExecStart=/home/abel/.opencode/bin/opencode web --port 4096 --hostname 0.0.0.0
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
</code>

''User=abel'' seems unsafe but that is how it works, and seeing as it is on the personal workstation any sequrity risk is minimal.


Start and enable opencode by:
<code>
sudo systemctl enable opencode --now
</code>

===== configuration =====
This systemd unit started a web interface on http://localhost:4096/

==== connection to an AI ====

edit the configuration file:  ''vi ~/.config/opencode/opencode.json''

and fill it with:
<code>
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://10.100.10.50:11434/v1"
      },
      "models": {
        "gurubot/GLM-4.6V-Flash-GGUF:Q4_K_M": {
          "name": "GLM-4.6V Flash"
        }
      }
    }
  }
}

</code>
===== Connect tools =====

there is also a VSCodium plugin. how to set this up you can find [[werkinstructies:vscodium_opencode|here]].