https://github.com/shaostoul/humanity

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. CA: 6MUWmhH1QES5hCLeKiL6kDj4fvMMEi5rbpux1Rbzpump
https://github.com/shaostoul/humanity

crypto cryptography decentralized-identity dilithium3 education federated-network free humanitarian-tech humanitarian-technology humanity open-source opensource p2p post-quantum privacy-focused public-domain rust verifiable-credentials

Last synced: 1 day ago
JSON representation

Host: GitHub
URL: https://github.com/shaostoul/humanity
Owner: Shaostoul
Created: 2026-01-16T09:00:26.000Z (5 months ago)
Default Branch: main
Last Pushed: 2026-06-02T06:55:42.000Z (14 days ago)
Last Synced: 2026-06-02T08:26:59.105Z (14 days ago)
Topics: crypto, cryptography, decentralized-identity, dilithium3, education, federated-network, free, humanitarian-tech, humanitarian-technology, humanity, open-source, opensource, p2p, post-quantum, privacy-focused, public-domain, rust, verifiable-credentials
Language: Rust
Homepage: https://united-humanity.us
Size: 53.2 MB
Stars: 10
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Security: docs/SECURITY-CADENCE.md
- Roadmap: docs/roadmap-2026-05-01.md
- Agents: docs/AGENTS.md

Awesome Lists containing this project

README

          # 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](https://united-humanity.us)**   ·   💬 **[Chat](https://united-humanity.us/chat)**   ·   📥 **[Download](https://united-humanity.us/download)**   ·   💜 **[Discord](https://discord.gg/9XxmmeQnWC)**

---

## 💡 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](https://creativecommons.org/publicdomain/zero/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](https://united-humanity.us/chat)**

2. Pick a display name

3. Say hi in `#welcome`

4. Take the **[5-minute tour](https://united-humanity.us/onboarding)**

No signup. No email. No credit card.

### 💻 Desktop app

1. Visit **[united-humanity.us/download](https://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 →](docs/admin/SELF-HOSTING.md)**

---

## 🔐 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](docs/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](https://united-humanity.us/agents)** — live status of every AI scope (active / passive / blocked, last audit, gaps)

- **[Agent registry](data/coordination/agent_registry.ron)** — who owns what; rules for claiming a scope

- **[Orchestrator state](data/coordination/orchestrator_state.json)** — running session journal that survives across chat sessions

- **[Multi-agent design doc](docs/design/multi-agent-development.md)** — 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](https://github.com/Shaostoul/Humanity/commits/main).

---

## 🧠 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](docs/design/storage-architecture.md)** — 3-layer model (server / web / native), authority via signed objects, scaling story, P2P paths

- **[Identity](docs/design/identity.md)** — DID resolution, key rotation, signed profile replication

- **[UI system](docs/design/ui-system.md)** — Theme tokens, universal Button widget, design tokens

- **[Federation](docs/network/server_federation.md)** — Federation protocol, signed-object gossip, peer trust

- **[Humanity Accord](docs/accord/humanity_accord.md)** — Voluntary constitution every server may adopt

- **[Litestream replication](docs/operations/litestream.md)** — Disaster recovery for self-hosters

### Tests

```bash

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](https://x.com/Shaostoul) to register.

→ [Read the Accord](docs/accord/humanity_accord.md)

---

## 🤝 Get involved

| | |

|---|---|

| 💬 **Show up** | [united-humanity.us/chat](https://united-humanity.us/chat) — no account needed |

| 💜 **Discord** | [discord.gg/9XxmmeQnWC](https://discord.gg/9XxmmeQnWC) |

| 🐛 **Report bugs** | [united-humanity.us/bugs](https://united-humanity.us/bugs) or open a GitHub issue |

| 📖 **Contributing** | [CONTRIBUTING.md](CONTRIBUTING.md) — start here if you want to write code |

| 💸 **Donate** | [GitHub Sponsors](https://github.com/sponsors/Shaostoul) — 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](https://youtube.com/@Shaostoul) · 📺 [Twitch](https://twitch.tv/Shaostoul) · 𝕏 [X / Twitter](https://x.com/Shaostoul) · ☁️ [Bluesky](https://bsky.app/profile/shaostoul.bsky.social) · 🎮 [Steam](https://steamcommunity.com/id/Shaostoul)

---

## 📜 License

[**CC0 1.0 Universal**](https://creativecommons.org/publicdomain/zero/1.0/) — 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.}

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/shaostoul/humanity

Awesome Lists containing this project

README