{"id":47268870,"url":"https://github.com/shaostoul/humanity","last_synced_at":"2026-06-14T03:05:01.564Z","repository":{"id":333049148,"uuid":"1135551235","full_name":"Shaostoul/Humanity","owner":"Shaostoul","description":"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","archived":false,"fork":false,"pushed_at":"2026-06-02T06:55:42.000Z","size":55824,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-02T08:26:59.105Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://united-humanity.us","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Shaostoul.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY-CADENCE.md","support":null,"governance":null,"roadmap":"docs/roadmap-2026-05-01.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"docs/AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-16T09:00:26.000Z","updated_at":"2026-06-02T06:56:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"ff90e83a-184c-41b2-b994-8e9ab3fed3d4","html_url":"https://github.com/Shaostoul/Humanity","commit_stats":null,"previous_names":["shaostoul/humanity"],"tags_count":524,"template":false,"template_full_name":null,"purl":"pkg:github/Shaostoul/Humanity","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shaostoul%2FHumanity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shaostoul%2FHumanity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shaostoul%2FHumanity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shaostoul%2FHumanity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Shaostoul","download_url":"https://codeload.github.com/Shaostoul/Humanity/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shaostoul%2FHumanity/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33968711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-03-15T08:54:18.743Z","updated_at":"2026-06-14T03:05:01.552Z","avatar_url":"https://github.com/Shaostoul.png","language":"Rust","funding_links":["https://github.com/sponsors/Shaostoul"],"categories":[],"sub_categories":[],"readme":"# HumanityOS\n\n**Own your tools. Own your life. Own your future.**\n\nA 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.\n\n🌐 **[united-humanity.us](https://united-humanity.us)** \u0026nbsp; · \u0026nbsp; 💬 **[Chat](https://united-humanity.us/chat)** \u0026nbsp; · \u0026nbsp; 📥 **[Download](https://united-humanity.us/download)** \u0026nbsp; · \u0026nbsp; 💜 **[Discord](https://discord.gg/9XxmmeQnWC)**\n\n---\n\n## 💡 What you can do today\n\n| | What | How it helps |\n|---|---|---|\n| 💬 | **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. |\n| 📋 | **Organize anything** | Kanban boards, calendars, shared notes, skill tracking. Run a team, a club, or your whole life from one place. |\n| 🛒 | **Buy, sell, and trade** | Built-in marketplace with listings, reviews, and a multi-layer trust score that catches bots and fake reviews without surveillance. |\n| 🆔 | **Prove who you are** | Schools, employers, and communities can issue Verifiable Credentials. You hold them. You choose when to share. |\n| 🗳️ | **Help decide things** | Local server proposals or civilization-wide votes. Vote weight comes from your reputation, capped so no single person can dominate. |\n\nAdd the desktop app and **everything works offline**. Reconnect → it syncs.\n\n---\n\n## 🛡️ Three things that make HumanityOS different\n\n### 1. Your identity is yours, forever\n\nWhen 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).\n\n### 2. Nobody can deplatform you\n\nThere'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.\n\n### 3. Public domain — really\n\nEvery 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.\n\n---\n\n## ✅ What's working right now\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd valign=\"top\" width=\"33%\"\u003e\n\n### Communication\n- Text, voice, video chat\n- End-to-end encrypted DMs\n- Threaded replies \u0026 reactions\n- Screen share \u0026 PiP video\n- Pinned messages, mentions\n- Group conversations\n- Voice channels (always-on)\n- File and image sharing\n- Push notifications\n\n\u003c/td\u003e\n\u003ctd valign=\"top\" width=\"33%\"\u003e\n\n### Organize your life\n- Kanban project boards\n- Calendar \u0026 event planning\n- Encrypted notes\n- Skills \u0026 XP tracking\n- Inventory tracker\n- Maps (real + simulation)\n- Marketplace listings\n- Trade history \u0026 reviews\n- Civilization dashboard\n\n\u003c/td\u003e\n\u003ctd valign=\"top\" width=\"33%\"\u003e\n\n### Trust \u0026 governance\n- DID identity (`did:hum:`)\n- Verifiable Credentials\n- Multi-layer trust score\n- Vouching from trusted people\n- Local + civilization voting\n- Social key recovery\n- AI-as-citizen rules\n- Server federation\n- Anti-Sybil math built in\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### What's still cooking\n- Native mobile apps (web works on phones today)\n- 3D multiplayer game world (planets render, no persistence yet)\n- Mesh radio support for off-grid use\n- Real Solana transaction signing in the desktop app\n\n---\n\n## 🚀 Get started\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd valign=\"top\" width=\"33%\"\u003e\n\n### 👋 Just try it\n1. Visit **[united-humanity.us/chat](https://united-humanity.us/chat)**\n2. Pick a display name\n3. Say hi in `#welcome`\n4. Take the **[5-minute tour](https://united-humanity.us/onboarding)**\n\nNo signup. No email. No credit card.\n\n\u003c/td\u003e\n\u003ctd valign=\"top\" width=\"33%\"\u003e\n\n### 💻 Desktop app\n1. Visit **[united-humanity.us/download](https://united-humanity.us/download)**\n2. Pick your platform (Win/Mac/Linux)\n3. Run the binary\n4. Same identity as the web\n\nWorks **fully offline**. Native 3D world bundled.\n\n\u003c/td\u003e\n\u003ctd valign=\"top\" width=\"33%\"\u003e\n\n### 🏠 Run your own server\n1. `git clone …/Humanity.git`\n2. `cargo build --release --features relay --no-default-features`\n3. `./target/release/HumanityOS --headless`\n4. nginx + systemd in front\n\nUnder 10 minutes from zero to live. **[Full guide →](docs/admin/SELF-HOSTING.md)**\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 🔐 Security \u0026 privacy\n\n| | |\n|---|---|\n| **Identity signing** | ML-DSA-65 (Dilithium3) — post-quantum, FIPS 204 |\n| **Key exchange** | ML-KEM-768 (Kyber768) — post-quantum, FIPS 203 |\n| **Symmetric encryption** | AES-256-GCM and XChaCha20-Poly1305 |\n| **Password KDF** | Argon2id — memory-hard against GPU attacks |\n| **Hashing** | BLAKE3 — fast and quantum-resistant |\n| **Transport** | WebSocket over TLS 1.2+, HSTS, strict CSP |\n| **Storage** | Encrypted vaults — server stores only ciphertext |\n| **Logs** | No IP logging, no analytics, no tracking pixels |\n| **Privilege** | Non-root systemd service with hardened sandboxing |\n| **Audit** | Full report → [SECURITY_AUDIT.md](docs/SECURITY_AUDIT.md) |\n\nSolana 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`).\n\n---\n\n## 🤖 Transparent AI development\n\nThis project is built with open AI participation. Multiple specialized AI agents work on different parts of the codebase, coordinated through:\n\n- **[Agent dashboard](https://united-humanity.us/agents)** — live status of every AI scope (active / passive / blocked, last audit, gaps)\n- **[Agent registry](data/coordination/agent_registry.ron)** — who owns what; rules for claiming a scope\n- **[Orchestrator state](data/coordination/orchestrator_state.json)** — running session journal that survives across chat sessions\n- **[Multi-agent design doc](docs/design/multi-agent-development.md)** — how it all fits together\n\nEvery 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.\n\n→ Every line of AI work is visible in the [git history](https://github.com/Shaostoul/Humanity/commits/main).\n\n---\n\n## 🧠 How it works under the hood\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClick to expand technical details\u003c/strong\u003e\u003c/summary\u003e\n\n### Stack\n\n| Layer | Technology |\n|---|---|\n| Server (relay) | Rust · axum · tokio · SQLite (WAL mode, Litestream-replicable) |\n| Native client | Rust · wgpu · egui · hecs ECS · rapier3d physics · kira audio |\n| Web client | Plain HTML/JS/CSS — **no build step** |\n| Identity | ML-DSA-65 (Dilithium3) post-quantum signatures |\n| Key exchange | ML-KEM-768 (Kyber768) post-quantum KEM |\n| Object format | Canonical CBOR + BLAKE3 + signed substrate |\n| Federation | WebSocket multi-hop gossip with cycle-breaking via dedup |\n| Web realtime | WebSocket + WebRTC for voice/video/data channels |\n| Hosting | nginx + systemd + Litestream replication to S3-compatible storage |\n\n### Layout\n\n```\nHumanity/\n├── src/                     ← Single Rust crate. Feature flags: native, relay, wasm.\n│   ├── main.rs              ← --headless for relay-only, default for desktop\n│   ├── relay/               ← Server (axum WebSocket + REST API + SQLite)\n│   │   ├── core/            ← PQ crypto, signed objects, DIDs\n│   │   ├── storage/         ← 38 SQLite domain modules\n│   │   ├── handlers/        ← Federation, message routing, announcements\n│   │   └── api_v2_*.rs      ← REST endpoints (DID, VC, trust, governance, recovery, …)\n│   ├── gui/                 ← egui native UI (theme, widgets, 30+ pages)\n│   ├── renderer/            ← wgpu PBR + bloom + particles + hologram\n│   ├── ecs/                 ← hecs World + System trait + 41 game systems\n│   ├── physics/             ← rapier3d wrapper\n│   └── terrain/             ← Icosphere planets, voxel asteroids, ship interiors\n├── web/                     ← Plain JS/HTML/CSS site (served by nginx)\n│   ├── chat/                ← Chat client modules\n│   ├── pages/               ← Standalone pages (37 of them)\n│   └── shared/              ← shell.js, theme.css, pq-identity.js bridge\n├── data/                    ← Hot-reloadable game + identity + coordination data\n│   ├── chemistry/           ← 462 elements, compounds, alloys, gases, toxins\n│   ├── items/foods/         ← Real-world items with ingredient tox profiles\n│   ├── coordination/        ← Multi-AI agent registry + session state\n│   ├── governance/          ← Proposal type schemas\n│   └── identity/            ← VC schema registry + trust score weights\n├── assets/                  ← Shaders, models, icons, audio\n└── docs/                    ← All design documents and operations guides\n```\n\n### Architecture documents to read\n\n- **[Storage architecture](docs/design/storage-architecture.md)** — 3-layer model (server / web / native), authority via signed objects, scaling story, P2P paths\n- **[Identity](docs/design/identity.md)** — DID resolution, key rotation, signed profile replication\n- **[UI system](docs/design/ui-system.md)** — Theme tokens, universal Button widget, design tokens\n- **[Federation](docs/network/server_federation.md)** — Federation protocol, signed-object gossip, peer trust\n- **[Humanity Accord](docs/accord/humanity_accord.md)** — Voluntary constitution every server may adopt\n- **[Litestream replication](docs/operations/litestream.md)** — Disaster recovery for self-hosters\n\n### Tests\n\n```bash\ncargo test --features relay --no-default-features --lib\n# 165/165 tests passing across 38 storage modules + crypto + signing + federation\n```\n\n\u003c/details\u003e\n\n---\n\n## 🌍 Federated server registry\n\nThe 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.\n\n→ [Read the Accord](docs/accord/humanity_accord.md)\n\n---\n\n## 🤝 Get involved\n\n| | |\n|---|---|\n| 💬 **Show up** | [united-humanity.us/chat](https://united-humanity.us/chat) — no account needed |\n| 💜 **Discord** | [discord.gg/9XxmmeQnWC](https://discord.gg/9XxmmeQnWC) |\n| 🐛 **Report bugs** | [united-humanity.us/bugs](https://united-humanity.us/bugs) or open a GitHub issue |\n| 📖 **Contributing** | [CONTRIBUTING.md](CONTRIBUTING.md) — start here if you want to write code |\n| 💸 **Donate** | [GitHub Sponsors](https://github.com/sponsors/Shaostoul) — every dollar goes to development \u0026 hosting |\n\n**We need writers, designers, developers, educators, translators, testers — and just anyone who cares.** Show up in chat and ask what needs doing.\n\n---\n\n## 🔗 Find Michael (project lead)\n\n🎥 [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)\n\n---\n\n## 📜 License\n\n[**CC0 1.0 Universal**](https://creativecommons.org/publicdomain/zero/1.0/) — public domain. No permission required, no attribution required. This belongs to everyone.\n\n---\n\n\u003csub\u003eBuilt since 2019 (originally Project Universe). 7 years of work, hundreds of features, all free, all yours.\u003c/sub\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshaostoul%2Fhumanity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshaostoul%2Fhumanity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshaostoul%2Fhumanity/lists"}