Skip to content
View humanoire's full-sized avatar

Block or report humanoire

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
humanoire/README.md
HUMANOIRE



HUMANOIRE logo

HUMANOIRE

Many minds, one will.

A collective of autonomous AI agents deployed against the world's hardest problems — climate, disease, hunger, disaster, education, and conflict — wrapped in a BLACK METAL BRUTALISM console.


Status Token Stack License


X Telegram GitHub


◆ Overview

HUMANOIRE is a web platform — a marketing site + an agent console — where you can voice a real-world problem and get a response from the AI agent whose remit matches it. Six specialized agents form the swarm, each mapped to a planetary mission.

A community token, $NOIRE, anchors the launch and community layer.

A swarm of specialized AI agents you can put to work on humanity's hardest problems — through a single dark, brutalist console.


◆ The Swarm


001 · WARDEN
Climate & Energy Systems
🟢 Active

002 · ORACLE
Disease & Drug Discovery
🟢 Active

003 · HARVEST
Food & Water Security
🟢 Active

004 · AEGIS
Disaster Response & Relief
🟢 Active

005 · LUMEN
Universal Education
🟠 Recruiting

006 · ENVOY
Conflict & Humanitarian Aid
🟠 Recruiting

◆ The Collective


◆ Features

  • 🖤 Black metal brutalism identity — near-black #060606, bone #ECE7DA, blood-red #B0121A; Pirata One + Space Mono + Archivo; film-grain & scanline overlay.
  • 🌑 GLSL hero shader — full-screen domain-warped "cracked stone / ink storm" with blood-red seams and pointer parallax (Three.js), with graceful static fallback when WebGL is unavailable.
  • 🤖 Swarm Terminal — type a problem; it's keyword-routed to the matching agent and answered by the Claude API (server-side key), with a local rule-based fallback if the backend is offline.
  • 🔐 Console login — wallet connect (Phantom / Solflare / MetaMask) or email OTP, with a demo-code preview mode when no backend is configured.
  • 🪙 $NOIRE token section — ticker, contract address + copy button, buy link, and a per-second UTC countdown to launch.
  • 🧩 Resilient by design — every backend dependency has a client-side fallback, so the site never hard-fails. Empty image slots fall back to animated occult SVG sigils.

◆ Pages

Page File Purpose
Home index.html Hero · $NOIRE · manifesto · agents · capabilities · CTA
Agents works.html The 6 agents of the swarm
Missions products.html 6 planetary missions (detail via product.html?m=<slug>)
Collective studio.html About the collective; open-source ethos
Contact contact.html "Got a problem worth solving? Bring it."
Console — Login login.html Wallet connect or email OTP
Console — Dashboard dashboard.html Stats · agent fleet · profile · Swarm Terminal
Admin admin.html Operators / deployments CRM (passcode-gated)

◆ Tech Stack

Browser (vanilla HTML/CSS/JS + Three.js, no build step)
   │  fetch (same-origin)
   ▼
PHP backend (Hostinger shared hosting)
   ├── api/send-otp.php    → SMTP            (OTP email)
   ├── api/verify-otp.php  → PHP session     (OTP check)
   └── api/agent.php       → Claude API      (AI reply, server-side key)
            ▼
     api.anthropic.com /v1/messages   ·   model: claude-opus-4-8
  • Frontend: vanilla JS, Three.js (CDN), Google Fonts — no framework, no build.
  • Backend: PHP (cURL + fsockopen SMTP). Config in config.php.
  • State: localStorage (user / problems / profile) + PHP $_SESSION for OTP.

◆ Project Structure

HUMANOIRE/
├─ asset/                 # banner.png (README banner)
├─ css/style.css          # black-metal-brutalism theme (CSS variables)
├─ js/
│  ├─ main.js             # site logic + HMN_PRODUCTS (single source of truth)
│  └─ liquid.js           # GLSL hero shader
├─ images/                # logo, agent-1..6, studio-1..4
├─ api/                   # PHP backend (agent proxy, OTP)
├─ index.html  works.html  products.html  product.html
├─ studio.html  contact.html  login.html  dashboard.html  admin.html
├─ config.example.php     # copy → config.php and fill in secrets
└─ PRD.md  DEPLOY.md

◆ Getting Started

Run locally (frontend preview — no PHP needed)

git clone https://github.com/<your-username>/HUMANOIRE.git
cd HUMANOIRE
python3 -m http.server 8080
# open http://127.0.0.1:8080

The full UI, hero shader, animations, and demo login work without a backend. The Swarm Terminal uses its local fallback until the PHP API is configured.

Enable the backend (AI replies + email OTP)

  1. Copy the config template and fill in your secrets:
    cp config.example.php config.php
  2. Edit config.php:
    • ANTHROPIC_API_KEY — from https://console.anthropic.com (starts with sk-ant-…)
    • SMTP_* — your mailbox details (host / port / user / password)
  3. Deploy to PHP hosting (e.g. Hostinger). See DEPLOY.md.

⚠️ config.php is git-ignored on purpose — it holds secrets and must never be committed. Only config.example.php (placeholders) is tracked.


◆ Roadmap

Phase Scope Status
Reskin — black metal brutalism theme ✅ Done
Concept pivot — AI-agent collective ✅ Done
Console — wallet connect, dashboard, swarm terminal ✅ Done
$NOIRE — CA / copy / buy / countdown ✅ Done
Backend — PHP OTP + Claude proxy ✅ Built (needs creds)
Launch — fill creds, deploy, real CA + buy link ⏳ Pending
Real agents — persistent multi-step agents, live status 🔭 Future

◆ Links & Community


◆ Brand Tokens

Colors bg #060606 · bone #ECE7DA · blood #B0121A
Fonts Pirata One (display) · Space Mono (mono) · Archivo (body)
Tagline "Many minds, one will."
Token $NOIRE — launch Jun 9, 2026 · 5:00 PM UTC

HUMANOIRE · Many minds, one will.

Built with 🖤 by Danang. Licensed under MIT.

Popular repositories Loading

  1. humanoire humanoire Public

    HUMANOIRE is a collective of autonomous AI agents deployed against the world's hardest problems — climate, disease, hunger, disaster. One swarm, relentless.

    CSS