Humanity is an open, public-domain project exploring how humans can live together with dignity, cooperation, and long-term continuity. It combines civilizational principles with rigorous system design to model learning, stewardship, and peaceful scalability. https://united-humanity.us
  • Rust 65.2%
  • JavaScript 27%
  • HTML 4.4%
  • WGSL 2.2%
  • CSS 0.6%
  • Other 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Shaostoul 87e1fe419d Outreach: an open invitation to join, test, share and support HumanityOS, one version per platform
Facebook, LinkedIn, Instagram, Threads, X, Bluesky and Mastodon, and Discord, each within its platform's limit and share-safe (no 'here', no stale time words); the facts each rests on, checked; where else to post; what was left out and why. The AI paragraph asks an AI to act only with its own person's go-ahead, the project's own rule.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 21:32:42 -08:00
.claude Claude Code's per-person settings leave the repository: .claude/settings.local.json untracked and ignored 2026-11-16 12:33:18 -08:00
.github/workflows The operator's five answers: a daily Android build (on now), and decisions recorded for the organisation pass and the picture rail 2026-11-15 22:22:21 -08:00
android Android rung A1: the app builds as an APK on GitHub's free runners, survives leaving the screen, and says what a phone lacks 2026-11-15 02:44:24 -08:00
app/web v0.1564.0: organisations delivered, room casings and rails, skills practice quality, doorways clear, the simulation without a screen, and the first-run privacy fix 2026-11-16 00:09:58 -08:00
assets Far tree cards rung 2: each card drawn as a tight outline around its tree, near cards out of the sun pass 2026-11-15 04:37:45 -08:00
backups Restructure: eliminate native/ nesting, clean up stale files 2026-04-05 22:03:27 -07:00
crates A contributor's post-quantum review recorded and checked: the wallet key is the master secret, the KEM key cannot rotate, the tests show agreement not conformance 2026-11-16 15:54:26 -08:00
data Journal: clean-worktrees cannot see squash merges; the ledger fix for the reset 2026-11-16 17:59:41 -08:00
docs Outreach: an open invitation to join, test, share and support HumanityOS, one version per platform 2026-11-16 21:32:42 -08:00
examples Whole-Earth maps rung 2: home packs, and the Silverdale coast slopes into the water 2026-11-09 10:59:51 -08:00
logs Restructure: eliminate native/ nesting, clean up stale files 2026-04-05 22:03:27 -07:00
mods v0.86.0: Remove Tauri app/, simplify repo structure, add mods/ 2026-03-29 17:32:23 -07:00
ops/vps ops: operator PUBLIC keys for VPS re-provisioning 2026-08-07 14:45:17 -07:00
saves Restructure: eliminate native/ nesting, clean up stale files 2026-04-05 22:03:27 -07:00
schemas Skills rung 1: the approved base set as data, every live verb training its skill, the Skills page, and the "I can" statements with the review's 103 corrections 2026-11-15 03:23:34 -08:00
scripts Hardcoded paths, first pass: the launchers and the HDR diff find the repo themselves, a test passes on macOS and Linux, a fixture drops a personal folder 2026-11-16 13:23:03 -08:00
src Hardcoded paths, first pass: the launchers and the HDR diff find the repo themselves, a test passes on macOS and Linux, a fixture drops a personal folder 2026-11-16 13:23:03 -08:00
tests Headless sim runner increment 4: the step runs first and whole, the engine boots with no GPU, and HumanityOS --sim walk walks the storeys route agreeing 14 of 14 legs with the windowed game 2026-11-15 23:19:41 -08:00
tools Spike follow-up: prove the BGRA screen texture rather than claim it 2026-09-18 23:51:07 -07:00
vendor Rust warnings to zero, and the ratchet that holds them there 2026-11-01 18:51:45 -08:00
web A picture rail by default in the living room and the study, and the Calculator's mode tabs fit a small phone 2026-11-16 15:20:32 -08:00
.gitattributes The look's textures: BC7 at conversion, a slot pool, and Garment textures in Settings 2026-11-10 05:40:38 -08:00
.gitignore Claude Code's per-person settings leave the repository: .claude/settings.local.json untracked and ignored 2026-11-16 12:33:18 -08:00
.mcp.json Connect Claude Code to the dev MCP server: .mcp.json and the CLAUDE.md Router line 2026-10-24 02:35:57 -07:00
build.rs Room finishes rung 1: skirting and crown moulding swept round every room with true mitres, chosen per room and per wall side in the build editor 2026-11-15 04:20:59 -08:00
Cargo.lock v0.1564.0: organisations delivered, room casings and rails, skills practice quality, doorways clear, the simulation without a screen, and the first-run privacy fix 2026-11-16 00:09:58 -08:00
Cargo.toml v0.1564.0: organisations delivered, room casings and rails, skills practice quality, doorways clear, the simulation without a screen, and the first-run privacy fix 2026-11-16 00:09:58 -08:00
CHANGELOG.md docs: fix all 13 audited false claims in the root documents 2026-09-06 17:29:24 -07:00
CLAUDE.md Organisations rung 2: changes reach every member as sealed DMs, the owner can hand the organisation on, and guilds retire into Organisations 2026-11-15 10:06:04 -08:00
CONTRIBUTING.md The licence moves to plan B: AGPL-3.0-or-later for code, CC BY-SA 4.0 for the Library and docs, CC0 for plain data, with a name policy 2026-11-14 16:32:40 -08:00
CREDITS.md Eleven approved instrument libraries: the core set's new public-domain picks and six optional packs, with the pipeline they needed 2026-11-13 19:09:57 -08:00
Justfile The Justfile runs on macOS and Linux: bash by name there, Git Bash only on Windows, and PATH changed only on Windows 2026-11-16 13:39:22 -08:00
LICENSE The licence moves to plan B: AGPL-3.0-or-later for code, CC BY-SA 4.0 for the Library and docs, CC0 for plain data, with a name policy 2026-11-14 16:32:40 -08:00
LICENSES.md The licence moves to plan B: AGPL-3.0-or-later for code, CC BY-SA 4.0 for the Library and docs, CC0 for plain data, with a name policy 2026-11-14 16:32:40 -08:00
LICENSING.md The licence moves to plan B: AGPL-3.0-or-later for code, CC BY-SA 4.0 for the Library and docs, CC0 for plain data, with a name policy 2026-11-14 16:32:40 -08:00
package-lock.json Major refactor: split relay.rs, unify settings, replace hardcoded colors, reorganize docs (v0.6.0) 2026-03-17 20:53:02 -07:00
package.json Major refactor: split relay.rs, unify settings, replace hardcoded colors, reorganize docs (v0.6.0) 2026-03-17 20:53:02 -07:00
prlint.pdb dev tooling: page_registry_lint now guards the NATIVE GuiPage count too 2026-07-23 15:10:39 -07:00
README.md The licence moves to plan B: AGPL-3.0-or-later for code, CC BY-SA 4.0 for the Library and docs, CC0 for plain data, with a name policy 2026-11-14 16:32:40 -08:00
rust-toolchain.toml Pin Rust 1.99.1 for the PC, GitHub and both servers; just brief says when updates exist 2026-10-23 12:07:10 -07:00

HumanityOS

Own your tools. Own your life. Own your future.

A free app where people chat, plan, trade, and build together. No sign-up, no owner, no ads, free and open source. The infrastructure for cooperation, made for everyone.

🌐 united-humanity.us   ·   💬 Chat   ·   📥 Download   ·   💜 Discord


💡 What you can do today

What How it helps
💬 Talk to anyone, privately Text, voice, video calls. Direct messages are locked end-to-end with post-quantum math - only the people in the conversation can read them, not even the server. Threads, search, reactions, screen share.
📋 Organize anything Kanban boards, calendars, notes with optional per-note passphrase encryption, skill tracking. Run a team, a club, or your whole life from one place.
🛒 Buy, sell, and trade Built-in marketplace with signed listings, reviews, and seller ratings. The platform introduces buyers and sellers and never touches the money, so no operator can freeze your sale. A separate multi-layer trust score (identity, vouching, activity, no surveillance) is computed for every identity, with every input published so nobody has to trust a black box. You look it up on the Identity page today; escrowed payment for real goods and trust badges inside listings are next.
🆔 Prove who you are Schools, employers, and communities can issue Verifiable Credentials over the open API. Signed, revocable, auditable by anyone. (Choosing exactly what to disclose - selective disclosure - is in development.)
🗳️ Help decide things Local server proposals or civilization-wide votes. Vote weight comes from your reputation, capped so no single person can dominate.
🌱 Play and learn survival A full 3D homestead: farm real crops, cook, craft, fight, trade, and build a multi-deck ship under a night sky of real stars.

Add the desktop app and the 3D world runs fully offline with local saves. The collaboration tools (chat, market, tasks, voting) are server-backed by design and pick back up when you reconnect.


🛡️ Three things that make HumanityOS different

1. Your identity is yours, forever

The first time you open HumanityOS, your phone or computer creates a post-quantum cryptographic key - math so strong it will still be secure when quantum computers arrive. No sign-up, and no password stored on any server. Your 24-word recovery phrase restores your identity on any device, and with it everything the server holds. Your private message history is deliberately not on the server: it lives encrypted on your own device, and undelivered mail expires after 30 days. That is exactly what makes the relay unable to read or hand over your conversations, and it also means your device holds the only copy of that history. Lost your device and your phrase too? A few friends you chose earlier can each send back a piece of it, after checking that it is really you; no single piece is any use alone, and the server cannot read them (Settings > Account in the app, and /recovery on the website).

2. Nobody can deplatform you

There's no lock-in to a central server. Anyone can run a copy. Your identity works on any server you join, your credentials follow you, your messages and contacts come with you. If one server goes down, you keep going. Server-to-server federation is live between united-humanity.us and public.guide, and fail-closed - a network with no center can't be shut down from one.

3. Free and open source, and it stays that way

Copy it, fork it, sell it, teach from it. The code is under the GNU AGPL 3.0 or later: anyone who shares a changed version, or runs one as a server for other people, shares its source too, so nobody can take HumanityOS private. The Library and the docs are under CC BY-SA 4.0 (credit us, share alike), which lets them take in other share-alike knowledge such as Wikipedia. The game data is public domain (CC0 1.0), and so is the Humanity Accord. Which folder is under which licence: LICENSING.md. Everything released before 14 November 2026 was CC0 and stays public domain. A few real-world datasets we ship keep their own open terms and travel with the bundle: the OpenStreetMap map regions are ODbL 1.0 and ask for credit on any map drawn from them, the Gaia star catalogue is CC-BY-SA-IGO 3.0, and some planetary textures are CC-BY 4.0. Every one is listed with its obligation in LICENSES.md. Built by volunteers, owned by humanity.


✅ What's working right now

Communication

  • Text, voice, video chat
  • End-to-end encrypted DMs
  • Threaded replies & reactions
  • Screen share & PiP video
  • Pinned messages, mentions
  • Group conversations
  • Voice channels (always-on)
  • File and image sharing
  • Push notifications

Organize your life

  • Kanban project boards
  • Calendar & event planning
  • Notes (optional per-note encryption)
  • Skills & XP tracking
  • Inventory tracker
  • Maps (real + simulation)
  • Marketplace listings
  • Trade history & reviews
  • Civilization dashboard

Trust & governance

  • DID identity (did:hum:)
  • Verifiable Credentials (API)
  • Multi-layer trust score
  • Vouching (API; UI coming)
  • Local + civilization voting
  • AI-as-citizen rules
  • Server federation (live between two servers, fail-closed)
  • Anti-Sybil math built in

The 3D world (desktop app)

Farming, cooking, crafting, combat, quests, skills and XP, a player market with escrowed trades, livestock, weather, procedural planets, and a buildable multi-deck ship - all playable solo today with local saves. Shared-world co-presence over the relay is built and in live testing.

What's still cooking

  • Native mobile apps (web works on phones today)
  • Multiplayer polish: shared-world co-presence is in live two-player testing
  • One-click vouching and credential-issuing UI (the signed-object plumbing is live)
  • Mesh radio support for off-grid use
  • Real Solana transaction signing in the desktop app

🚀 Get started

👋 Just try it

  1. Visit united-humanity.us/chat
  2. Pick a display name
  3. Say hi in #global
  4. Take the 5-minute tour

No sign-up. No email. No credit card.

💻 Desktop app

  1. Visit united-humanity.us/download
  2. Pick your platform (Win/Mac/Linux)
  3. Run the binary
  4. Same identity as the web

Works fully offline. Native 3D world bundled.

🏠 Run your own server

  1. Download HumanityOS-relay-linux-x64 (the server build) from Releases
  2. chmod +x HumanityOS-relay-linux-x64
  3. ./HumanityOS-relay-linux-x64 --headless
  4. nginx + systemd in front

No compiler, no Docker. Under 10 minutes from download to live. Building from source instead adds roughly 7 minutes of compile time. Full guide →


🔐 Security & privacy

Identity signing ML-DSA-65 (Dilithium3) - post-quantum, FIPS 204
Key exchange ML-KEM-768 (Kyber768) - post-quantum, FIPS 203
Symmetric encryption AES-256-GCM
Password KDF PBKDF2-SHA-256 (600,000 iterations) for client vaults; Argon2id (memory-hard) for server-stored secrets
Hashing BLAKE3 - fast and quantum-resistant
Transport WebSocket over TLS 1.2+, HSTS, CSP + full security-header set
Storage Encrypted vaults - server stores only ciphertext
Logs No analytics, no tracking pixels. The relay database has no IP column at all. The web server in front keeps access logs for 2 days so it can ban abusers, and the relay writes an IP into its own log only when a rate limit trips. For no IP at all, reach the server over the Tor onion service.
Privilege Non-root systemd service with hardened sandboxing
Audit Ongoing cadence → SECURITY-CADENCE.md (initial Feb 2026 audit archived at docs/history/SECURITY_AUDIT_2026-02-12.md)

Solana wallet support is optional and decoupled from your identity. Using HumanityOS doesn't require any blockchain. If you opt in, the wallet is the Ed25519 keypair derived from your same 24-word recovery phrase (your post-quantum chat identity is a separate Dilithium3 key).


🤖 Transparent AI development

This project is built in the open by a two-person team: one human (Shaostoul) and one AI (Claude), working together daily. When workload calls for it, the AI dispatches short-lived helper agents for parallel tasks -- every one of them coordinated and reviewed through:

Every AI decision is documented. AI agents are first-class citizens with the same rules as humans (no extra authority), mandatory transparency, and humans always retain the right to refuse AI interaction.

→ Every line of AI work is visible in the git history. → The same history lives on our own server too: git.united-humanity.us, a mirror that copies every change from GitHub by itself, so the code does not depend on any one company.


🧠 How it works under the hood

Click to expand technical details

Stack

Layer Technology
Server (relay) Rust · axum · tokio · SQLite (WAL mode, Litestream-replicable)
Native client Rust · wgpu · egui · hecs ECS · rapier3d physics · kira audio
Web client Plain HTML/JS/CSS - no build step
Identity ML-DSA-65 (Dilithium3) post-quantum signatures
Key exchange ML-KEM-768 (Kyber768) post-quantum KEM
Object format Canonical CBOR + BLAKE3 + signed substrate
Federation WebSocket multi-hop gossip with cycle-breaking via dedup
Web realtime WebSocket + WebRTC for voice/video/data channels
Hosting nginx + systemd; continuous backup built into the relay (every change within seconds, sealed, to a folder, an S3-compatible bucket or another HumanityOS server - see docs/admin/continuous-backup.md)

Layout

Humanity/
├── src/                     ← Single Rust crate. Feature flags: native, relay, wasm.
│   ├── main.rs              ← --headless for relay-only, default for desktop
│   ├── relay/               ← Server (axum WebSocket + REST API + SQLite)
│   │   ├── core/            ← PQ crypto, signed objects, DIDs
│   │   ├── storage/         ← 40+ SQLite domain modules
│   │   ├── handlers/        ← Federation, message routing, announcements
│   │   └── api.rs + api_v2_*.rs ← REST endpoints (DID, VC, trust, governance, recovery, …)
│   ├── gui/                 ← egui native UI (theme, widgets, 40+ pages)
│   ├── renderer/            ← wgpu PBR + bloom + particles + hologram
│   ├── ecs/                 ← hecs World + System trait
│   ├── systems/             ← 40+ game systems (farming, combat, weather, economy, …)
│   ├── physics/             ← rapier3d wrapper
│   └── terrain/             ← Icosphere planets, voxel asteroids, ship interiors
├── web/                     ← Plain JS/HTML/CSS site (served by nginx)
│   ├── chat/                ← Chat client modules
│   ├── pages/               ← Standalone pages (listed in docs/PAGES.md)
│   └── shared/              ← shell.js, theme.css, pq-identity.js bridge
├── data/                    ← Hot-reloadable game + identity + coordination data
│   ├── chemistry/           ← 483 elements, compounds, alloys, gases, toxins
│   ├── items/foods/         ← Real-world items with ingredient tox profiles
│   ├── coordination/        ← Multi-AI agent registry + session state
│   ├── governance/          ← Proposal type schemas
│   └── identity/            ← VC schema registry + trust score weights
├── assets/                  ← Shaders, models, icons, audio
└── docs/                    ← All design documents and operations guides

Architecture documents to read

  • Storage architecture - 3-layer model (server / web / native), authority via signed objects, scaling story, P2P paths
  • Identity - DID resolution, key rotation, signed profile replication
  • UI system - Theme tokens, universal Button widget, design tokens
  • Federation - Federation protocol, signed-object gossip, peer trust
  • Humanity Accord - Voluntary constitution every server may adopt
  • Continuous backup - Disaster recovery for self-hosters: about a minute of data at most, restorable to any moment in the history kept

Tests

cargo test --features relay --no-default-features --lib
# the server's tests: storage, crypto, signing, federation, and game logic
cargo test --features native --lib
# about 5,200 tests for the full desktop app (5,208 on 2026-10-25); on Windows
# run `just test-lib` instead, which links the tests in a way Windows accepts

🌍 Federated server registry

The Humanity Accord is a voluntary set of principles every server may adopt. Servers that publicly adopt it earn the highest trust tier in federation. Reach out to @Shaostoul to register.

→ Read the Accord


🧭 The standard we hold ourselves to

Society, business, government, our whole civilization: this is what we have to be to live our best lives. One for every letter, so it is easy to remember and hard to weasel out of.

Altruistic · Benevolent · Compassionate · Diligent · Empathetic · Frugal · Generous · Humble · Intelligent · Just · Kind · Loving · Mindful · Noble · Observant · Persevering · Quixotic · Righteous · Sincere · Truthful · United · Valiant · Wholesome · Xenial · Yielding · Zealous

Xenial means welcoming to strangers. Yielding means giving way when you are wrong. Quixotic means chasing something most people call impossible, on purpose. Ending poverty is exactly that, so it stays.

Anything less is a path toward pain, suffering, despair, and eventually extinction. Becoming a peaceful, harmonious, united Humanity is how we survive both the disasters outside our control and the tools we are building.

→ The full mission


🤝 Get involved

💬 Show up united-humanity.us/chat - no sign-up needed
💜 Discord discord.gg/9XxmmeQnWC
🐛 Report bugs united-humanity.us/bugs or open a GitHub issue
📖 Contributing CONTRIBUTING.md - start here if you want to write code
💸 Donate To the nonprofit Sponsor-a-Can: your donation goes to Sponsor-a-Can, a 501(c)(3), so it is tax-deductible as the law allows. Or to the maintainer directly on Patreon: he receives it personally, so it is not tax-deductible. More ways: united-humanity.us/donate

We need writers, designers, developers, educators, translators, testers - and just anyone who cares. Show up in chat and ask what needs doing.


🔗 Find Michael (project lead)

🎥 YouTube · 📺 Twitch · 𝕏 X / Twitter · 🎮 Steam


📜 License

Code: GNU AGPL 3.0 or later. Library and docs: CC BY-SA 4.0. Data and the Humanity Accord: CC0 1.0, public domain. The folder-by-folder map is LICENSING.md; the name "HumanityOS" has its own short policy, docs/legal/trademark-policy.md: fork freely, under your own name.


Built since 2019 (originally Project Universe). 7 years of work, hundreds of features, all free, all yours.