Skip to content

[FEATURE]: Add option to disable models.dev fetch for corporate proxy environments #4959

Closed
Closed
[FEATURE]: Add option to disable models.dev fetch for corporate proxy environments#4959
Assignees
thdxr
Labels
discussionUsed for feature requests, proposals, ideas, etc. Open discussion

Description

@emvnuel
emvnuel
opened on Dec 1, 2025

Feature hasn't been suggested before.

  • I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

Problem

Users behind corporate proxies experience issues with OpenCode 1.x.x versions due to a network call made on startup to https://models.dev/api.json. This call happens unconditionally and does not respect HTTP_PROXY/HTTPS_PROXY environment variables since Bun's native fetch() doesn't automatically handle proxy configuration.

Version 0.15.31 worked fine because this fetch behavior was either not present or handled differently.

Current Behavior

In packages/opencode/src/provider/models.ts, the get() function always calls refresh() which makes a network request:

export async function get() {
  refresh()  // Always calls fetch to models.dev
  const file = Bun.file(filepath)
  const result = await file.json().catch(() => {})
  if (result) return result as Record<string, Provider>
  const json = await data()
  return JSON.parse(json) as Record<string, Provider>
}

The code does have fallback mechanisms (local cache + bundled data), but the fetch is attempted regardless.

Proposed Solution

Add a configuration option to disable network calls, e.g.:

{
  "offline": true
}

Or more granularly:

{
  "experimental": {
    "disable_models_fetch": true
  }
}

When enabled, OpenCode would skip the models.dev fetch and rely on:

  1. Cached data at ~/.cache/opencode/models.json
  2. Bundled model data (compiled via macro)

Workaround

Currently, users can whitelist models.dev in their corporate proxy, but this isn't always possible in restricted environments.

Environment

  • OpenCode version: 1.x.x (works in 0.15.31)
  • Issue: Corporate proxy blocking/timing out on models.dev fetch

Activity

  1. emvnuel
    added
    discussionUsed for feature requests, proposals, ideas, etc. Open discussion
    on Dec 1, 2025

  2. github-actions commented on Dec 1, 2025

    @github-actions
    github-actionsBot
    on Dec 1, 2025 – with GitHub Actions
    Contributor

    This issue might be a duplicate of existing issues. Please check:

    Feel free to ignore if none of these address your specific case.

  3. thdxr commented on Dec 2, 2025

    @thdxr
    thdxr
    on Dec 2, 2025
    Member

    yep this is a good idea i was toying around with it

  4. rekram1-node
    assigned
    thdxr
    on Dec 2, 2025

  5. ariane-emory commented on Dec 2, 2025

    @ariane-emory
    ariane-emory
    on Dec 2, 2025
    Contributor

    I think experimental.skip_models_fetch would be a better name. After all, we're not trying to disable the ability to fetch updated model lists (opencode models --refresh should keep working), we're just trying to skip the automatic fetching of the updated list.

  6. ariane-emory commented on Dec 4, 2025

    @ariane-emory
    ariane-emory
    on Dec 4, 2025
    Contributor

    We might be able to achieve this simply by not enabling the 60 minute model refresh timer when experimental.skip_models_fetch == true? Need to look into how viable that is, but it sounds like it could work.

  7. BAMSHK commented on Jan 16, 2026

    @BAMSHK
    BAMSHK
    on Jan 16, 2026
    Image 在有网的机器访问https://[models.dev/api.json](https://models.dev/api.json)网站下载json 存放到上述目录下文件中之后 可以正常启动opencode了

  8. b3nw commented on Jan 17, 2026

    @b3nw
    b3nw
    on Jan 17, 2026
    Contributor

    I looked into this and found out why OPENCODE_DISABLE_MODELS_FETCH doesn't work - I think it's basically broken by design?

    The problem

    In models.ts, the get() function does this:

    export async function get() {
  refresh()  // flag stops this from fetching
  const result = await file.json().catch(() => {})
  if (result) return result  // but it still reads the cache...
  if (typeof data === "function") {
    return JSON.parse(await data())  // ...or falls back to baked-in data
  }
  // last resort: fetch
}

    So even if you:

    1. Set the flag
    2. Delete the cache file
      ...it still loads models from a Bun macro that embeds models.dev at build time. The data is literally compiled into the binary. There's no escaping it.

    Proposed fixes

    Option A: Make the env var actually work (easy fix)
    Just return empty when the flag is set:

    export async function get() {
  if (Flag.OPENCODE_DISABLE_MODELS_FETCH) return {}
  // ... rest unchanged
}

    Should I submit a PR to fix this? or is this intentional and a different solution should be added?

  9. junmediatek commented on Jan 18, 2026

    @junmediatek
    junmediatek
    on Jan 18, 2026
    Contributor

    @thdxr @rekram1-node

    Could you help to check this issue?
    shuv1337#307

  10. OneOfLzx commented on Jan 22, 2026

    @OneOfLzx
    OneOfLzx
    on Jan 22, 2026

    You might consider trying the OpenCode Sentinel project—it cuts all network access except to your LLM, so it works flawlessly in network-restricted environments👍👍.

    Repo: https://github.com/oneoflzx/opencode-sentinel

  11. haplo commented on Feb 3, 2026

    @haplo
    haplo
    on Feb 3, 2026

    I stumbled upon this issue with my own use case: I'm trying to sandbox opencode restricting it to only localhost Ollama for projects with personal data, but it fails because of the mandatory models.dev download. It would be nice to make it optional, or to skip it if the user provides a specific model to use.

  12. jaepang commented on Feb 24, 2026

    @jaepang
    jaepang
    on Feb 24, 2026

    Checking for solution details

  13. emvnuel commented on Mar 25, 2026

    @emvnuel
    emvnuel
    on Mar 25, 2026
    Author

    OPENCODE_DISABLE_MODELS_FETCH flag solves this issue

  14. emvnuel
    closed this as completedon Mar 25, 2026
  15. haplo
    added a commit that references this issue on Mar 26, 2026

    fish: disable models.dev fetch in opencode-ollama

    4e45ec7
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

discussionUsed for feature requests, proposals, ideas, etc. Open discussion

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions