Local LLM Support on MAC with LM Studio - Without an API Provider Setup

If you don't setup an API Provider, the global config for local providers doesn't seem to be called.

I loaded this file into ~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "lmstudio/google/gemma-3n-e4b",
  "provider": {
    "lmstudio": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LM Studio (local)",
      "options": {
        "baseURL": "http://127.0.0.1:1234/v1"
      },
      "models": {
        "google/gemma-3n-e4b": {
          "name": "Gemma 3n-e4b (local)"
        }
      }
    }
  }
}

But when I try to run opencode from my project directory I just get the add credential providers screen.

When I copy the same opencode.json file to my project directory and run opencode it launches correctly and connects to LM Studio.

are you on latest?

Yes, just brew upgrade 'ed and retested.

I can confirm this issue, using the latest version and not able to use lm-studio as provider.

I got it working on my mac with lm studio

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lmstudio": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LM Studio (local)",
      "options": {
        "baseURL": "http://localhost:1234/v1"
      },
      "models": {
        "qwen/qwen3-4b": {
          "name": "qwen/qwen3-4b"
        },
        "qwen3-8b": {
          "name": "qwen3-8b"
        }
      }
    }
  }
}

I got it working on my mac with lm studio

Did it work if you don't have that opencode.json file in your project directory, as in the opencode.json only loaded into ~/.config/opencode/opencode.json & with no API provider configured?

I got it working by copying this file to the local project directory but based on the documentation ~/.config/opencode/opencode.json should be the global setting.

I put it in .config/opencode

omg thanks, I was faffing around for 20 minutes trying to get it to connect to my local ik_llama.cpp llama-server with no idea what was happening...

turns out i had to put the opencode.json in the same directory where i was calling opencode binary. I does not work putting opencode.json into ~/.local/share/opencode/ which is where it was putting the auth.json file on my arch linux box.

Installed with yay -Sy opencode-bin.

I was having the same issue, and the problem is that I was putting the configs on auth.json based on this link:

https://opencode.ai/docs/providers/#credentials

It's clear now that auth.json is for API keys, so I think it's a good idea to add an extra section mentioning the opencode.json file.

To stay organized issues are automatically closed after 90 days of no activity. If the issue is still relevant please open a new one.

security: harden release workflows against secret leakage (anomalyco#…

Revert "security: harden release workflows against secret leakage (an…

Navigation Menu

Repository navigation

Local LLM Support on MAC with LM Studio - Without an API Provider Setup #1480

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Local LLM Support on MAC with LM Studio - Without an API Provider Setup #1480

Description

Activity

thdxr commented on Aug 1, 2025

EvolvingSoftware commented on Aug 1, 2025

Divkix commented on Aug 2, 2025

unluckyjori commented on Aug 2, 2025

EvolvingSoftware commented on Aug 2, 2025

unluckyjori commented on Aug 2, 2025

ubergarm commented on Sep 8, 2025

rubnogueira commented on Oct 1, 2025

thdxr commented on Mar 25, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions