Skip to content

Shaostoul/Humanity

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1,358 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

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

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

No signup. 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. git clone โ€ฆ/Humanity.git
  2. cargo build --release --features relay --no-default-features
  3. ./target/release/HumanityOS --headless
  4. 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:

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.

About

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.

Topics

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors