OpenHuman GuideOpenHuman Guide

Setup hub

Install OpenHuman

Desktop builds and terminal install scripts for every platform. Pick your OS, review the script, then install.

Install guidePrivacy checklist

Install OpenHuman

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

Practical, source-linked OpenHuman guidance

Quick Answer

OpenHuman installs in one command or via signed installer. Windows: run the PowerShell command from the official script. macOS/Linux: run the shell command. All platforms take under 10 minutes. Read the script first, verify the source, and use a test account before connecting production data.

  • Windows: PowerShell installer from tinyhumans.ai or GitHub releases.
  • macOS: signed DMG or terminal shell script.
  • Linux: shell script or AppImage. Check architecture (x64 vs ARM) before downloading.
  • Time: under 10 minutes. Post-install config adds 20–40 minutes for first integration and vault setup.

Pick Your Platform

Windows

PowerShell setup, script review steps, and desktop build considerations.

Open

macOS

Terminal setup, DMG verification, and Apple Silicon considerations.

Open

Linux

Shell setup, permissions, desktop dependencies, and distro notes.

Open

Before Running Scripts

  • Open the script URL in a browser and read it before running.
  • Use the official download links if you prefer a signed installer.
  • Record the version or commit so you can reproduce or report issues later.

Download & Verify

Prefer a signed installer or the source code? Get platform downloads and checksums on the Download page first, then follow this guide to set up.

Open

System Requirements

Make sure your system meets the minimum requirements before installing.

  • Windows 10/11, macOS 12+, or a modern Linux distribution (Ubuntu 20.04+, Fedora 35+, Arch).
  • At least 4 GB RAM (8 GB recommended for local AI).
  • At least 2 GB free disk space (more if you plan to sync large email or chat histories).
  • Internet connection for initial download, OAuth setup, and cloud model routing.
  • Administrator or root access may be required for some install paths.

Pre-Install Checklist

A few minutes of preparation can prevent hours of troubleshooting.

  • Back up important data before installing any new desktop application.
  • Temporarily disable antivirus or add an exception for the installer (re-enable after verification).
  • Create a dedicated test account for evaluation before connecting production accounts.
  • Check that your OS architecture matches the installer (ARM vs x64).
  • Close unnecessary applications to free up RAM for the initial sync.

Post-Install Verification

Confirm the installation succeeded before moving on to configuration.

  • Launch the app and verify the version number matches the release you downloaded.
  • Check that the Memory Tree vault path is set and writable.
  • Confirm the app can reach the internet (needed for OAuth and model routing).
  • Test the search panel to ensure the local index initialized correctly.
  • Verify your OS permissions: microphone, accessibility, and screen recording (macOS).

Next Steps After Install

Installation is just the beginning. Follow these guides to get the most out of OpenHuman.

Setup Guide

Post-install configuration: integrations, model routing, local AI, and voice.

Open

Privacy Checklist

Review privacy and security considerations before connecting accounts.

Open

Local AI Setup

Configure Ollama or LM Studio for on-device inference.

Open

Common Install Mistakes

These are the most frequent issues that trip up first-time installers.

  • Running the installer as the wrong user: install as the user who will actually use the app.
  • Skipping the script review: always read curl-to-bash or PowerShell scripts before execution.
  • Architecture mismatch: downloading an x64 build on an ARM Mac or vice versa.
  • Ignoring SmartScreen or Gatekeeper: verify the source is official before bypassing security warnings.
  • Not checking disk space: the vault can grow quickly with large email or chat histories.
How do I install OpenHuman?

On Windows, run the PowerShell installer from tinyhumans.ai or GitHub releases. On macOS, use the signed DMG or a terminal shell script. On Linux, use the shell script or AppImage, checking x64 versus ARM first. Installation takes under 10 minutes; the first integration and vault setup add 20 to 40 minutes. Read the script and verify the source before running.

What is the difference between the Install guide and the Download page?

This guide walks through step-by-step setup: picking your platform, reviewing the script, running the install, verifying it, and configuring your first integration. The Download page is for getting the raw installers and source code with links to verify your download. Use Download to get the files, then this guide to set them up.

What are the system requirements for OpenHuman?

Windows 10 or 11, macOS 12+, or a modern Linux distribution such as Ubuntu 20.04+, Fedora 35+, or Arch; at least 4 GB RAM (8 GB recommended for local AI); at least 2 GB free disk space, more for large email or chat histories; and an internet connection for the initial download, OAuth setup, and cloud model routing.

Is it safe to run the OpenHuman install script?

Open the script URL in a browser and read it before running, prefer the official signed installer if you would rather not run a curl-to-bash or PowerShell script, and verify the source is official before bypassing SmartScreen or Gatekeeper warnings. Create a dedicated test account before connecting production data.

How do I verify the installation worked?

Launch the app and confirm the version matches what you downloaded, check that the Memory Tree vault path is set and writable, confirm internet access for OAuth and model routing, test the search panel to ensure the local index initialized, and grant required OS permissions such as microphone, accessibility, and screen recording on macOS.