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.

---

◆ 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

• 𝕏 / Twitter — https://x.com/humanoire_
• Telegram — https://t.me/humanoire
• GitHub — https://github.com/humanoire/humanoire

---

◆ 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.}