HumanID

Biometrics are broken, deepfakes are everywhere, and KYC is a nightmare. HumanID lets you verify once with DNA on the decentralized device and carry that proof everywhere — Web2, Web3, banks, apps — without ever giving up your data.

💡 HumanID is a decentralized verification system that binds your crypto wallet to a DNA-backed proof created on a portable realtime DNA sequencer. The raw biometrics hosted user custody/server; signed proofs are stored in GolemDB with an on-chain hash for audit. Genetics never on-chain, but proof is. Apps integrate our SDK with a single line of code, instantly confirming “real human” status across platforms. No vaults, no leaks, no endless KYC loops — just portable trust you own and take anywhere.

HumanID – Biometric Verification System (readme Summary)

OverviewHumanID is a biometric verification system that uses genome data for proving humanity and confirming identity. It works through two modes:

1. Humanity Verification – first-time verification from genome data.

2. Identity Confirmation – similarity checking against existing records.

Architecture

• Frontend (Next.js) – web app with RainbowKit wallet integration.

• Genome Device (Python) – generates STR profiles from VCF files.

• Biometrics Server (FastAPI) – processes and stores encrypted data.

• GolemDB – stores metadata and verification history.

• Humanity SDK – multi-language SDKs (Python, TypeScript, Rust) for easy integration.

Key Features

• Wallet-based identity proof.

• Encrypted file uploads, SHA-256 verification, and secure storage.

• Real-time verification status and history via the frontend.

• Kubernetes-ready deployment with Docker support.

Quick Start & Deployment

• Requires Python 3.7+, Node.js 18+, bcftools, and Docker.

• Run locally via uvicorn (server) and npm run dev (frontend).

• Deployed server: https://biometrics-server.biokami.com/ (health check endpoint provided).

• Includes scripts for Kubernetes deployment with GolemDB integration.

API Endpoints

• POST /first_humanity_verification – initial DNA verification.

• POST /similarity_check – confirm against existing data.

• GET /verification_status/ – check current verification status.

Data Flow

1. Genome device processes VCF → STR profile.

2. Profile is uploaded and encrypted.

3. Biometrics server handles verification.

4. Metadata stored in GolemDB.

TestingSample STR profiles included for testing both humanity verification and identity confirmation.

Frontend Features

• Wallet integration (MetaMask, WalletConnect).

• Secure uploads with progress feedback.

• Responsive UI with verification history tracking.

Docs & SupportEach component has its own README. Contributing is open (MIT license). Issues can be resolved via provided documentation and sample tests.