Download Humanity

First-run warnings on Windows and macOS

Neither build carries a paid platform certificate (Windows code signing is $300+/year, Apple notarization is $99/year), so both systems warn you the first time you open it. This is normal for open-source software, and it is a one-time click.

• Windows shows "Windows protected your PC": click "More info" → "Run anyway"
• macOS refuses to open it at all: right-click the app, choose Open, then confirm. If it still refuses, run xattr -dr com.apple.quarantine HumanityOS once.
• The app is fully open source, verify the source

Install as PWA (No App Store)

Works like a native app, homescreen icon, no browser chrome, push notifications.

• iOS Safari: Open united-humanity.us → Share → "Add to Home Screen"
• Android Chrome: Open united-humanity.us → Menu → "Install app"
• Desktop Chrome/Edge: Look for the install icon in the address bar

Why direct downloads?

App stores charge fees, impose restrictions, and can remove apps. We distribute from GitHub so:

• No 30% tax on donations
• No corporate gatekeeper can pull the app
• Updates ship immediately, not when approved
• You can verify the source matches the binary

Auto-update

HumanityOS checks GitHub for newer versions on launch, and will only install a release the operator has cryptographically signed: an unsigned build is skipped rather than trusted. Signing is a manual step that runs behind the release stream, so the newest few releases are usually unsigned. When you want the very latest, download it from the releases page yourself.

Host your own node

The app you just downloaded is the server. Run it headless to host chat, the market, or the game for others, with no separate install:

HumanityOS --headless

That starts the WebSocket relay and REST API. Set PORT and DATABASE_PATH to place them where you want. It is featherweight: measured on our live server, the relay uses about 50 MB of memory and half a percent of one CPU core. A donated laptop or a $4/mo VPS runs it comfortably (floor: 1 GB RAM, 1 core, 20 GB disk).

Choose what your node hosts. A server owner decides which features they offer (chat only, the market only, the game, or all of it), and whether to let others use their relay as a backup. Switches live in data/server-config.json; a disabled feature is genuinely refused, not just hidden.

Reachable from the internet needs a domain and an open port (a home router usually needs port-forwarding or a tunnel). A LAN-only node (a household, a classroom, a community center) needs none of that and works today. Full walkthrough: the self-hosting guide.

Which build for weak hardware?

It is all one program, but it ships two ways so a small server is never forced to carry what it will not use:

• The full app (about 66 MB for the Windows .exe, or about 175 MB for the mac and Linux bundles, which carry the game data alongside the binary). The desktop program you download above. It is the server too: run it with --headless and it hosts without a window. Best on any machine you also sit in front of.
• The headless server (about 28 MB, HumanityOS-relay-linux-x64 on each release). No graphics or audio libraries needed, so it runs on a bare Linux box, a Raspberry Pi, or the cheapest VPS. This is what you want for a dedicated, always-on node.

Either way, running the server costs about 50 MB of memory and half a percent of one core. Building from source is the only heavy part (it needs a couple of GB of memory and a few minutes), which is exactly why the headless server is offered prebuilt: a 1 GB box can run a node even though it could never compile one. Our setup script fetches the prebuilt binary automatically.

Build from source

Everything is public domain (CC0). Clone, build, verify:

git clone https://github.com/Shaostoul/Humanity.git
cd Humanity
cargo build --release --features native

For a headless server build (no GPU dependencies):

cargo build --release --features relay --no-default-features