HKUDS/nanobot · error · TuiUnavailableError

NANOBOT_TUI_BIN does not exist: {executable}

Error message

NANOBOT_TUI_BIN does not exist: {executable}

What it means

Error "NANOBOT_TUI_BIN does not exist: {executable}" thrown in HKUDS/nanobot.

Source

Thrown at nanobot/cli/tui_launcher.py:160

            except subprocess.TimeoutExpired:
                process.kill()
                process.wait()
        raise
    finally:
        lease = getattr(gateway, "lease", None) if gateway is not None else None
        if lease is not None:
            # Returning to the shell must not wait for process termination. The
            # gateway's client monitor observes the released last lease and owns
            # the orderly on-demand shutdown.
            lease.release(wait_for_stop=False)


def _resolve_tui_command() -> list[str]:
    override = os.environ.get("NANOBOT_TUI_BIN", "").strip()
    if override:
        executable = Path(override).expanduser().resolve(strict=False)
        if not executable.is_file():
            raise TuiUnavailableError(f"NANOBOT_TUI_BIN does not exist: {executable}")
        return [str(executable)]

    suffix = ".exe" if os.name == "nt" else ""
    system = {"Windows": "win32", "Darwin": "darwin", "Linux": "linux"}.get(
        platform.system(),
        platform.system().lower(),
    )
    machine = {"x86_64": "x64", "AMD64": "x64", "aarch64": "arm64"}.get(
        platform.machine(),
        platform.machine().lower(),
    )
    if system == "win32" and machine == "arm64":
        raise TuiUnavailableError(
            "the native TUI is not available on Windows ARM64 because Bun FFI is disabled "
            "on that platform; use the classic prompt until the upstream runtime supports it"
        )
    asset = f"nanobot-tui-{system}-{machine}{suffix}"
    source_dir = _source_checkout_tui_dir()

View on GitHub (pinned to 42f37dc4c0)

When it happens

Trigger: Thrown at nanobot/cli/tui_launcher.py:160 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of HKUDS/nanobot@42f37dc4c0 (2026-08-26). Data as JSON: /api/errors/436ad0fe5094273d. Report an issue: GitHub.