tinyhumansai/openhuman · error

runtime python server failed to start: {}

Error message

runtime python server failed to start: {}

What it means

The server's ready line parsed but carried ready=false with the server's own error string — initialization inside the python process failed after the protocol handshake succeeded.

Source

Thrown at src/openhuman/runtime/python_server/server.rs:522

        .take()
        .context("runtime python server stdout missing")?;
    if let Some(stderr) = child.stderr.take() {
        drain_server_stderr(stderr);
    } else {
        log::debug!("[runtime_python_server] stderr pipe missing; continuing without drain");
    }
    let mut lines = BufReader::new(stdout).lines();

    let ready_line = match tokio::time::timeout(HANDSHAKE_TIMEOUT, lines.next_line()).await {
        Ok(Ok(Some(line))) => line,
        Ok(Ok(None)) => bail!("runtime python server exited before readiness handshake"),
        Ok(Err(error)) => return Err(error).context("reading runtime python server handshake"),
        Err(_) => bail!("runtime python server readiness handshake timed out"),
    };
    let ready: ReadyLine = serde_json::from_str(&ready_line)
        .with_context(|| format!("parsing runtime python server ready line: {ready_line}"))?;
    if !ready.ready {
        bail!(
            "runtime python server failed to start: {}",
            ready.error.unwrap_or_else(|| "unknown".to_string())
        );
    }
    if ready.protocol != Some(PROTOCOL_VERSION) {
        bail!(
            "runtime python server protocol mismatch: expected {}, got {:?}",
            PROTOCOL_VERSION,
            ready.protocol
        );
    }
    log::info!(
        "[runtime_python_server] server ready backends={:?}",
        ready.backends
    );

    Ok(ServerInner {
        _child: child,

View on GitHub (pinned to 7491200858)

Solutions

1. Read the server-supplied error text to find the failing init step
2. Fix the named cause (missing model, bad config) and restart

When it happens

Trigger: Thrown at src/openhuman/runtime/python_server/server.rs:522 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/82dc3b3251f3b144. Report an issue: GitHub.