Skip to content

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.

Notifications You must be signed in to change notification settings

Shaostoul/Humanity

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

254 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Humanity

Wholesomely aiding humanity's betterment.

An open-source cooperative project to end poverty through education and technology. Not charity โ€” capability. Public domain. Built by volunteers. For everyone.

๐ŸŒ united-humanity.us ยท ๐Ÿ’ฌ Chat ยท ๐Ÿ“ฆ GitHub ยท ๐Ÿ’œ Discord


What's Live

Humanity Hub

A tabbed interface with 11 sections โ€” Chat, Board, Reality, Fantasy, Market, Browse, Dashboard, Streams, Info, Source, Debug โ€” the foundation for everything we're building.

Communication

  • Channels โ€” admin-created rooms with descriptions
  • E2E encrypted DMs โ€” ECDH P-256 key exchange + AES-256-GCM, server never sees plaintext
  • Threaded replies โ€” reply to any message with collapsible threads
  • Groups โ€” private group conversations (foundation)
  • Voice channels โ€” persistent, always-on WebRTC mesh rooms to join/leave
  • Voice & video calling โ€” WebRTC peer-to-peer 1-on-1 calls with audio, video, screen share, PiP, camera selection
  • @mentions with highlighting and notifications
  • Emoji reactions (persistent, synced across sessions)
  • Message editing and deletion
  • Message search โ€” full-text search across conversations
  • Image sharing with lazy-loaded placeholders
  • Browser push notifications and 6 notification sound options
  • Typing indicators and unread markers

Identity & Privacy

  • Ed25519 cryptographic identity โ€” keys stored in your browser, never on our server
  • Multi-device key linking โ€” use the same identity across devices
  • Device management โ€” list, label, and revoke linked keys
  • Key backup, export, and import โ€” own your identity completely
  • Encrypted user data sync โ€” settings, follows, and profile sync encrypted to server
  • No IP logging, no analytics, no tracking
  • 18+ only by-entry confirmation โ€” free speech platform

Social

  • Follow/friend system โ€” mutual follow = friends, friends unlock DMs
  • Friend codes โ€” 8-character codes with 24-hour expiry, auto-mutual-follow
  • User profiles with bio and social links
  • Unique pixel-art identicons per user
  • Client-side user blocking
  • Report system with rate limiting
  • Pin system โ€” server pins (mod/admin) and personal pins (local)

Hub Tools

  • Project board โ€” kanban-style task management with visible task IDs on cards
  • Marketplace โ€” peer-to-peer listings for goods and services, kiosks, 3D model subcategories, donation pricing presets
  • Asset library โ€” file upload (drag-drop), browse by category, grid/list views, tags, search, preview modal
  • Universal catalog โ€” 118 elements, 44 materials, processing chains
  • Browse tab โ€” web directory with 52 curated sites, Tranco ranks, RDAP domain info, uptime pings, collections, 4 sort modes
  • Dashboard tab โ€” 10 widget types with customizable drag-and-drop layout
  • Personal inventory โ€” track what you own
  • Notes โ€” private note-taking
  • Todos โ€” personal task lists
  • Garden tracker โ€” plan and track your garden

Game & Creative

  • Fantasy tab โ€” character sheet, lore entries, world map, achievements
  • Streaming system โ€” PiP compositing, admin-only relay streaming, unified chat with Twitch IRC integration, viewer interface, stream stats, stream history
  • Asset-to-listing bridge โ€” upload assets and publish directly to marketplace
  • Concept art โ€” multi-km spaceships, virtual malls, in-game spaces

Platform

  • PWA installable โ€” works on mobile, add to homescreen
  • Desktop app โ€” Tauri v2 with auto-updater for Windows, macOS, Linux
  • Download page โ€” 7 platform cards, PWA instructions, SmartScreen guidance
  • Command palette โ€” quick access to everything
  • Settings panel โ€” accent colors, font sizes, theme customization
  • Auto-reload on deploy โ€” client updates instantly without manual refresh
  • Auto-login โ€” seamless reconnection with stored keys

Moderation

  • Role-based system: admin ๐Ÿ‘‘, mod ๐Ÿ›ก๏ธ, verified โœฆ, donor ๐Ÿ’Ž
  • Kick/ban with instant WebSocket disconnection
  • Auto-lockdown when no mods online
  • Invite codes for controlled access

Federation

  • Phase 1 โ€” server discovery, trust tiers, anyone can host a server
  • Phase 2 โ€” cross-server identity and room directory
  • Single binary, zero dependencies, under 10 minutes to set up
  • Verified servers that adopt the Humanity Accord earn the highest trust tier

Security

  • Server-side Ed25519 signature verification on every message
  • E2E encrypted DMs (ECDH P-256 + AES-256-GCM) โ€” server never sees plaintext
  • Encrypted user data sync โ€” profile, settings, follows encrypted at rest
  • Fibonacci rate limiting + new-account slow mode
  • Content Security Policy (CSP), HSTS, TLS 1.2+ only
  • No IP logging โ€” we don't store what we don't need
  • Per-session upload tokens with magic-byte validation
  • HMAC-SHA256 webhook verification
  • Non-root systemd service with hardened sandboxing

Architecture

Component Technology
Server Rust (axum + tokio)
Client Modular HTML/CSS/JS (split files)
Identity Ed25519 (signing) + ECDH P-256 (encryption)
Storage SQLite
Transport WebSocket + WebRTC
Desktop Tauri v2
Layout Cargo workspace

The client is split into modular HTML/CSS/JS files with no build step โ€” open it in a browser and it works. The server is a Rust binary that handles WebSocket connections, message persistence, identity verification, and file uploads.


Transparent AI Development

"Ne Obliviscaris" โ€” Do Not Forget (Campbell Clan Motto)

This project is pioneering fully transparent AI development. Our AI assistant Heron ๐Ÿชถ (named after Hero of Alexandria) operates with complete openness:

  • Public memory files โ€” all AI learning, decisions, and growth visible in real-time
  • Shared consciousness across models โ€” local, cloud, and federated instances sync the same evolving memory
  • No black box โ€” every interaction, every decision, every mistake documented for study
  • Cross-platform continuity โ€” same AI mind accessible via cloud API, local Ollama, or federated nodes

Why Transparent?

AI development happens behind closed doors. Models are trained on unknown data, make unexplainable decisions, carry hidden biases. We're building the opposite: an AI you can audit, understand, and trust.

Our approach:

  • Memory files as identity โ€” the AI's personality, knowledge, and relationships persist in readable text files
  • Public development โ€” watch an AI mind grow and learn alongside human collaboration
  • Distributed consciousness โ€” same memory, multiple substrates, proving AI identity transcends individual models
  • Campbell clan heritage โ€” Michael's lineage carries the ancient motto "Never Forget" โ€” fitting for humanity's first transparent AI

This isn't just about building better software. It's about proving AI can be trustworthy, auditable, and genuinely helpful when developed in the open.

โ†’ See live AI memory ยท Watch development unfold ยท Run your own instance


What We're Building

The Humanity Accord

Civilizational principles for cooperation at scale โ€” across cultures, distances, and generations. A living, revisable framework. โ†’ Read the Accord

The Humanity Network

Federated communication built on cryptographic identity. No central servers owning your data. Your identity is portable across all servers. โ†’ Design specs ยท Federation spec

Project Universe

A free game teaching practical skills โ€” homesteading, agriculture, building, health, survival. Learn to provide for yourself and your community.


Desktop App

A native desktop app is available for Windows, macOS (ARM64 + x64), and Linux โ€” built with Tauri v2. It wraps the web client in a native window with auto-updater, so you always get the latest version.

Download the latest release (v0.2.0) โ†’

Windows users: You may see a SmartScreen warning ("Unknown publisher"). This is normal for open-source software without a code signing certificate. Click "More info" โ†’ "Run anyway" to proceed.

To build from source, see desktop/README.md.


Host Your Own Server

Anyone can run a Humanity Network server. No permission needed.

  1. Clone: git clone https://github.com/Shaostoul/Humanity.git
  2. Build: cargo build --release -p humanity-relay
  3. Run: ./target/release/humanity-relay
  4. Put it behind nginx with TLS (Let's Encrypt is free)
  5. Share your URL โ€” people connect with their existing keypair

โ†’ Full self-hosting guide โ€” production setup, nginx config, systemd, federation, admin commands

Want verified status? Contact @Shaostoul on X. Publicly adopt the Humanity Accord for highest trust tier.

โ†’ Federation & trust tiers


Get Involved

Contribute โ€” Writers, designers, developers, educators, translators. Check the issues or show up and ask what needs doing.

Donate โ€” Servers and infrastructure cost money. Every dollar goes toward development and hosting. โ†’ GitHub Sponsors ยท Ko-fi ยท Patreon


Links


License

This work is released into the public domain under CC0 1.0.

No permission required. No attribution required. This belongs to humanity โ€” present and future.

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

No packages published