[Crash] ImportError: Using SOCKS proxy, but the 'socksio' package is not installed. Make sure to install httpx using `pip install httpx[socks]`.

[Winggggg]

Description

This crash was auto-reported by Omnigent's crash handler.

Exception: ImportError: Using SOCKS proxy, but the 'socksio' package is not installed. Make sure to install httpx using pip install httpx[socks].

Command:

/Users/hwy/.local/bin/omnigent cursor

Traceback:

Traceback (most recent call last):
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/omnigent/cli.py", line 1836, in main
    cli(args=argv, standalone_mode=False)
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/click/core.py", line 1569, in __call__
    return self.main(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/click/core.py", line 1490, in main
    rv = self.invoke(ctx)
         ^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/click/core.py", line 1970, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/click/core.py", line 1353, in invoke
    return ctx.invoke(self.callback, **ctx.params)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/click/core.py", line 907, in invoke
    return callback(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/omnigent/cli_native.py", line 665, in cursor
    server = _ensure_backend(server)
             ^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/omnigent/cli_native.py", line 47, in proxy
    return getter()(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/omnigent/cli.py", line 2961, in _ensure_backend
    config_changed = _ensure_host_daemon(None)
                     ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/omnigent/cli.py", line 2750, in _ensure_host_daemon
    decision = _reuse_existing_daemon_record(target)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/omnigent/cli.py", line 2523, in _reuse_existing_daemon_record
    if age_s >= _DAEMON_REUSE_MIN_AGE_S and not _daemon_tunnel_recovers(existing):
                                                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/omnigent/cli.py", line 2393, in _daemon_tunnel_recovers
    if _daemon_host_online(record):
       ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/omnigent/cli.py", line 2142, in _daemon_host_online
    result = _host_http_json(
             ^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/omnigent/cli.py", line 7484, in _host_http_json
    with httpx.Client(
         ^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/httpx/_client.py", line 700, in __init__
    else self._init_proxy_transport(
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/httpx/_client.py", line 750, in _init_proxy_transport
    return HTTPTransport(
           ^^^^^^^^^^^^^^
  File "/Users/hwy/.local/share/uv/tools/omnigent/lib/python3.12/site-packages/httpx/_transports/default.py", line 191, in __init__
    raise ImportError(
ImportError: Using SOCKS proxy, but the 'socksio' package is not installed. Make sure to install httpx using `pip install httpx[socks]`.

Steps to reproduce

omnigent cursor

Version

0.8.2

OS

macOS-26.4

Harness

No response

Harness mode

No response

Platform or device

No response

Observed impact

No response

Authentication type

No response

[github-actions]

Thanks for reporting this. #1977 may be related — could you take a look in case it already covers this?

If it turns out to be the same problem, please close this one and add your details there. Otherwise leave a note and we'll pick it up here.

[PattaraS]

Correcting my earlier comment — it was wrong on two counts, and I've since looked at this properly.

Please don't close this issue. #1977 was already closed as fixed (shipped in v0.6.0, 2026-07-21), so asking you to move your report there would have sent it somewhere nobody is reading. That was a bug in the triage bot's wording, now fixed in #4313.

More importantly, this doesn't look like a duplicate of #1977 at all. That fix (#2433) added trust_env=False to the loopback health probes. Your traceback dies somewhere it didn't reach:

_daemon_host_online → _host_http_json → httpx.Client(...) → ImportError

_host_http_json in omnigent/cli.py still constructs its client without trust_env=False, so it picks up your system SOCKS proxy and fails on the missing socksio extra. Same root cause as #1977, different call site — a missed spot in that fix rather than the same bug.

Two things that look actionable here, for whoever picks this up:

1. _host_http_json should bypass proxies for loopback targets, the same way fix(host): bypass proxies for loopback health checks #2433 did for the health checks.
2. The except (httpx.HTTPError, OSError) around it doesn't catch ImportError, which is why this surfaces as a crash rather than a failed probe.

Thanks for the report — it's a real gap, and it's staying open.