HumanityOS

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

A free app where people chat, plan, trade, and build together. No accounts, no owner, no ads, public domain. 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. Every message is locked with math only the people in the conversation can read. Threads, search, reactions, screen share.
📋	Organize anything	Kanban boards, calendars, shared notes, skill tracking. Run a team, a club, or your whole life from one place.
🛒	Buy, sell, and trade	Built-in marketplace with listings, reviews, and a multi-layer trust score that catches bots and fake reviews without surveillance.
🆔	Prove who you are	Schools, employers, and communities can issue Verifiable Credentials. You hold them. You choose when to share.
🗳️	Help decide things	Local server proposals or civilization-wide votes. Vote weight comes from your reputation, capped so no single person can dominate.

Add the desktop app and everything works offline. Reconnect → it syncs.

---

🛡️ Three things that make HumanityOS different

1. Your identity is yours, forever

When you sign up, your phone or computer creates a post-quantum cryptographic key — math so strong it will still be secure when quantum computers arrive. No username, no password. Your 24-word backup phrase recovers everything if you lose your device. Forgot your phrase? Trusted friends can recover it for you (Shamir secret sharing — no single friend can do it alone).

2. Nobody can deplatform you

There's no central server. Anyone can run a copy. Your identity works on every server, your credentials follow you, your messages and contacts come with you. If one server goes down, you keep going. A government can't shut down the network because there is no center.

3. Public domain — really

Every line of code, every design doc, every commit is in the public domain (CC0 1.0). Copy it, fork it, sell it, teach from it. No attribution required. 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 Encrypted notes Skills & XP tracking Inventory tracker Maps (real + simulation) Marketplace listings Trade history & reviews Civilization dashboard

Trust & governance DID identity (did:hum:) Verifiable Credentials Multi-layer trust score Vouching from trusted people Local + civilization voting Social key recovery AI-as-citizen rules Server federation Anti-Sybil math built in

What's still cooking

• Native mobile apps (web works on phones today)
• 3D multiplayer game world (planets render, no persistence yet)
• Mesh radio support for off-grid use
• Real Solana transaction signing in the desktop app

---

🚀 Get started

👋 Just try it Visit united-humanity.us/chat Pick a display name Say hi in #welcome Take the 5-minute tour No signup. No email. No credit card.

💻 Desktop app Visit united-humanity.us/download Pick your platform (Win/Mac/Linux) Run the binary Same identity as the web Works fully offline. Native 3D world bundled.

🏠 Run your own server git clone …/Humanity.git cargo build --release --features relay --no-default-features ./target/release/HumanityOS --headless nginx + systemd in front Under 10 minutes from zero to live. 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 and XChaCha20-Poly1305
Password KDF	Argon2id — memory-hard against GPU attacks
Hashing	BLAKE3 — fast and quantum-resistant
Transport	WebSocket over TLS 1.2+, HSTS, strict CSP
Storage	Encrypted vaults — server stores only ciphertext
Logs	No IP logging, no analytics, no tracking pixels
Privilege	Non-root systemd service with hardened sandboxing
Audit	Full report → SECURITY_AUDIT.md

Solana wallet support is optional and decoupled from your identity. Using HumanityOS doesn't require any blockchain. If you opt in, the wallet derives from the same 24-word seed via a separate path (hum/solana/v1).

---

🤖 Transparent AI development

This project is built with open AI participation. Multiple specialized AI agents work on different parts of the codebase, coordinated through:

• Agent dashboard — live status of every AI scope (active / passive / blocked, last audit, gaps)
• Agent registry — who owns what; rules for claiming a scope
• Orchestrator state — running session journal that survives across chat sessions
• Multi-agent design doc — how it all fits together

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.

---

🧠 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 + Litestream replication to S3-compatible storage

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/         ← 38 SQLite domain modules
│   │   ├── handlers/        ← Federation, message routing, announcements
│   │   └── api_v2_*.rs      ← REST endpoints (DID, VC, trust, governance, recovery, …)
│   ├── gui/                 ← egui native UI (theme, widgets, 30+ pages)
│   ├── renderer/            ← wgpu PBR + bloom + particles + hologram
│   ├── ecs/                 ← hecs World + System trait + 41 game systems
│   ├── 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 (37 of them)
│   └── shared/              ← shell.js, theme.css, pq-identity.js bridge
├── data/                    ← Hot-reloadable game + identity + coordination data
│   ├── chemistry/           ← 462 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
• Litestream replication — Disaster recovery for self-hosters

Tests

cargo test --features relay --no-default-features --lib
# 165/165 tests passing across 38 storage modules + crypto + signing + federation

---

🌍 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

---

🤝 Get involved

💬 Show up	united-humanity.us/chat — no account 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	GitHub Sponsors — every dollar goes to development & hosting

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 · ☁️ Bluesky · 🎮 Steam

---

📜 License

CC0 1.0 Universal — public domain. No permission required, no attribution required. This belongs to everyone.

---

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