Install OpenHuman on Linux

Official Command

Read the script first. Verify it matches your architecture, package manager, desktop environment, and install path.

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

Linux Checklist

• Verify your architecture before using the x64 installer.
• If the app launches to a blank window, check for missing desktop libraries or Wayland issues.
• Report distro-specific dependency gaps to the official issue tracker.

Step-by-Step Walkthrough

Recommended sequence for a clean Linux install. Each step includes what to check and what to do if it fails.

• Step 1 — Verify architecture: run uname -m. If it says x86_64, use the x64 installer. If it says aarch64, check whether an ARM build is available on the releases page.
• Step 2 — Download: grab the latest AppImage or run the install script. If using the script, read it first: curl -fsSL [script-url] | cat.
• Step 3 — Make executable: chmod +x openhuman-*.AppImage. If you use the script, it usually handles this for you.
• Step 4 — Run: ./openhuman-*.AppImage. If you see a blank window, try ./openhuman-*.AppImage --no-sandbox or switch to X11.
• Step 5 — Verify: open Settings and confirm the version. Set the vault path before connecting any integrations.

If This Step Fails

Common Linux-specific issues and their fixes.

• Blank window on launch: install libgtk-3-0 and libnss3. On Ubuntu: sudo apt install libgtk-3-0 libnss3. On Fedora: sudo dnf install gtk3 nss.
• Wayland issues: try running with --ozone-platform=x11 or log into an X11 session.
• AppImage says FUSE is missing: install fuse or fuse3. On Ubuntu: sudo apt install fuse. On Arch: sudo pacman -S fuse2.
• Script fails with permission denied: ensure you have execute permission (chmod +x install.sh) and are not running as root unless necessary.
• Ollama integration not detected: confirm Ollama is running (curl http://localhost:11434/api/tags) and the port is not blocked by a firewall.

Hardware and Compatibility

Linux distribution and hardware requirements.

• Tested on Ubuntu 20.04+, Fedora 35+, Arch Linux, and Debian 11+. Other distros may work but are not officially verified.
• x86_64 or aarch64 required. The installer assumes x86_64 unless you specify otherwise.
• Minimum 4 GB RAM. 8 GB recommended. 16 GB+ if you plan to run local models.
• A desktop environment is required (GNOME, KDE, XFCE, etc.). Headless servers are not supported.
• Disk space: 2 GB minimum, 5-10 GB recommended for large vaults.

Post-Install Verification

Confirm the installation succeeded before moving on to configuration.

• Launch the app and check the version in Settings.
• Set the Memory Tree vault path to a folder in your home directory.
• Test the search panel to confirm the local index initialized.
• Run ldd on the binary to verify all shared libraries are resolved.
• Open one integration page (do not connect yet) and verify the OAuth URL.

Uninstall or Roll Back

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

• Delete the AppImage or uninstall via your package manager if you used a packaged version.
• Delete the vault folder manually if you want to remove all synced data.
• Revoke OAuth tokens at the source services.
• Remove any desktop entries or PATH modifications the installer created.
• Reinstalling later is safe — just repeat the install steps above.

Next Steps