Windows setup

Install OpenHuman on Windows

One PowerShell command installs OpenHuman. Read the script first, or grab the signed installer instead.

Install OpenHuman on Windows

Practical notes for evaluating a fast-moving open-source AI assistant.

Practical, source-linked OpenHuman guidance

Official Command

This command downloads and executes the latest install script from the main branch. Convenient — but the script can change after this page is reviewed, so read it first.

powershell
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

Windows Checklist

  • Run PowerShell as the user who will use the app.
  • Inspect the raw script first — look for download URLs, install paths, and PATH changes.
  • If SmartScreen or antivirus blocks a binary, verify it came from official TinyHumans or GitHub links before bypassing.

Step-by-Step Walkthrough

This is the recommended sequence for a clean Windows install. Each step includes what to check and what to do if it fails.

  • Step 1 — Download: go to tinyhumans.ai/openhuman and download the signed EXE for your architecture (x64 or ARM). If you prefer the script, open it in a browser and read every line before running it.
  • Step 2 — Run: double-click the EXE or paste the PowerShell command into a terminal. If SmartScreen appears, verify the publisher is TinyHumans before clicking 'More info' → 'Run anyway'.
  • Step 3 — Permissions: grant any OS prompts the installer requests. Note what each permission is for so you can audit them later.
  • Step 4 — Launch: open the app and confirm the version number in Settings matches the release you downloaded.
  • Step 5 — First-run check: open Settings > Integrations and verify the list loads. Do not connect anything yet — run the privacy checklist first.

If This Step Fails

Common Windows-specific issues and their fixes.

  • Script fails with execution policy error: run Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser first, then retry.
  • Download is blocked by company proxy: use a personal network or ask IT to whitelist GitHub and tinyhumans.ai.
  • Installer says 'Windows protected your PC': click 'More info' and verify the publisher is TinyHumans before proceeding.
  • App launches then crashes immediately: check Event Viewer > Windows Logs > Application for the crash signature, then search the GitHub issues.
  • Antivirus quarantined the installer: restore it from quarantine and add an exclusion for the OpenHuman install path.

Hardware and Compatibility

Make sure your system meets the requirements before installing.

  • Windows 10 (1903+) or Windows 11 required. Windows 7/8 are not supported.
  • x64 or ARM64 processor. Check Settings > System > About to confirm your architecture.
  • Minimum 4 GB RAM (8 GB recommended if you plan to run local AI with Ollama).
  • At least 2 GB free disk space. The vault grows with email and chat history — plan for 5-10 GB if you sync large accounts.
  • Administrator access is only needed during install, not for daily use.

Post-Install Verification

Confirm the installation succeeded before moving on to configuration.

  • Launch the app and check the version in Settings matches your download.
  • Set the Memory Tree vault path to a folder that is backed up.
  • Test the search panel to confirm the local index initialized.
  • Open one integration page (do not connect yet) and verify the OAuth consent screen URL is from the real service.
  • Run a quick malware scan on the install directory if you used the script installer.

Uninstall or Roll Back

If you need to remove OpenHuman, follow these steps to clean up fully.

  • Uninstall the app via Settings > Apps > OpenHuman > Uninstall.
  • Delete the vault folder manually if you want to remove all synced data.
  • Revoke any OAuth tokens at the source services (Google Account > Third-party apps, etc.).
  • Remove PATH entries if the installer added them. Check System Properties > Environment Variables.
  • Reinstalling later is safe — just repeat the install steps above.

Next Steps