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.
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iexWindows 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.