tinyhumansai/openhuman · error

[LocalAIStep] Local AI bootstrap failed:

Error message

[LocalAIStep] Local AI bootstrap failed:

What it means

The background Local AI bootstrap failed after the onboarding consent click. bootstrapLocalAiWithRecommendedPreset is deliberately fire-and-forget (the global snackbar tracks progress), so this warn records that the model download/setup errored rather than crashing the step — Local AI remains unavailable and inference falls back to cloud providers until a bootstrap succeeds.

Source

Thrown at app/src/pages/onboarding/steps/LocalAIStep.tsx:47

          setRecommendDisabled(presets.recommend_disabled ?? false);
        }
      })
      .catch(() => {
        if (!cancelled) setRecommendDisabled(false);
      });
    return () => {
      cancelled = true;
    };
  }, []);

  const handleConsent = useCallback(() => {
    if (downloadStartedRef.current) return;
    downloadStartedRef.current = true;
    console.debug('[LocalAIStep] starting background Local AI bootstrap after consent');

    // Fire-and-forget: start bootstrap in the background — the global snackbar tracks progress.
    void bootstrapLocalAiWithRecommendedPreset(false, '[LocalAIStep]').catch((err: unknown) => {
      console.warn('[LocalAIStep] Local AI bootstrap failed:', err);
      onDownloadError?.(t('onboarding.localAI.setupIssue'));
    });

    // Advance to next step immediately
    onNext({ consentGiven: true, downloadStarted: true });
  }, [onNext, onDownloadError, t]);

  const handleSkip = useCallback(() => {
    console.debug('[LocalAIStep] skipping local AI — using cloud fallback');
    onNext({ consentGiven: false, downloadStarted: false });
  }, [onNext]);

  // Still probing device — show nothing yet.
  if (recommendDisabled === null) {
    return null;
  }

  // Low-RAM device: show cloud fallback option as the primary path.

View on GitHub (pinned to 7491200858)

Solutions

1. Check the snackbar/error surface for the bootstrap's failure detail (download failure, disk space, checksum)
2. Retry via the Local AI settings action once the cause is fixed — consent is remembered, so no re-consent needed
3. Verify network access to the model artifact host and free disk space in the models directory
4. Cloud inference continues to work regardless; Local AI can be retried later

When it happens

Trigger: Thrown at app/src/pages/onboarding/steps/LocalAIStep.tsx:47 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/f5bb8b427849a4ed. Report an issue: GitHub.