Download Humanity

Windows SmartScreen Warning

Windows may show "Windows protected your PC", this is normal for open-source software without a paid code signing certificate ($300+/year).

• Click "More info" → "Run anyway"
• 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 for newer versions on launch. If a newer exe exists, the old one delegates to it automatically. You never need to re-download manually.

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 20 MB of memory and a half-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 62 MB). 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 26 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 20 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