Interactive supply chain intelligence platform for the humanoid robotics industry. Explore OEM ecosystems, component suppliers, geopolitical dependencies, and AI-powered strategic analysis — all in the browser.
Live at humanoids.fyi
- 3D Component Viewer — Point-cloud renderings of robotics hardware (motors, batteries, actuators, bearings) using Gaussian Splat PLY files rendered as stippled point clouds via Three.js
- Supply Chain Graph — Interactive network visualization of OEM-supplier relationships across 17 humanoid robot companies and 50+ suppliers
- Geopolitical Exposure — Country-level dependency analysis for supply chain risk assessment
- AI Analysis — Groq-powered investment theses, competitive comparisons, scenario modeling, and semantic search
- Component Deep Dives — Detailed breakdowns across motors, reducers, bearings, actuators, screws, batteries, compute, sensors, PCBs, and end effectors
- Competitive Comparison — Side-by-side OEM specs and capability analysis
- Timeline View — Buildout and production ramp tracking
- Node.js 18+
- pnpm (recommended) or npm
git clone https://github.com/kingjulio8238/humanoid-atlas.git
cd humanoid-atlas
pnpm installCopy the env template and fill in your keys:
cp .env.example .env.local| Variable | Required | Source |
|---|---|---|
GROQ_API_KEY |
Yes (for AI features) | console.groq.com |
UPSTASH_REDIS_REST_URL |
No (view counter only) | console.upstash.com |
UPSTASH_REDIS_REST_TOKEN |
No (view counter only) | console.upstash.com |
pnpm devOpen http://localhost:5173.
pnpm build
pnpm previewpnpm lint├── api/ # Vercel serverless functions
│ ├── company-chat.ts # Company-specific AI Q&A
│ ├── compare.ts # Competitive analysis
│ ├── graph-query.ts # Supply chain graph queries
│ ├── investment-thesis.ts# Investment analysis
│ ├── scenario-parse.ts # Scenario impact parsing
│ ├── scenario-summary.ts # Scenario summaries
│ ├── smart-search.ts # Semantic search
│ └── views.ts # View counter (Upstash Redis)
├── src/
│ ├── App.tsx # Main application
│ ├── components/
│ │ ├── DetailPanel.tsx # Company/supplier detail views
│ │ ├── PLYViewer.tsx # 3D point cloud renderer
│ │ └── SupplyChainGraph.tsx # Network graph
│ └── data/
│ ├── companies.ts # OEM & supplier data
│ ├── components.ts # Hardware component definitions
│ ├── relationships.ts# Supply chain edges
│ └── types.ts # TypeScript interfaces
├── public/models/ # PLY point cloud files + robot images
└── index.html
The supply chain data lives in src/data/ and is structured as:
- Companies — OEMs (Tesla, Figure, Unitree, etc.) and suppliers with specs, funding, HQ location
- Relationships — Directed edges between companies with component type, confidence level, and source
- Components — Hardware category definitions with descriptions
The most impactful way to contribute is improving the supply chain dataset. To add or update data:
- Edit files in
src/data/ - Follow the existing TypeScript interfaces in
types.ts - Include a
sourcefield with a URL for any new relationships - Set an appropriate
confidencelevel (confirmed,likely,speculative)
Contributions are welcome! Whether it's new data, bug fixes, UI improvements, or new features.
- Fork the repo
- Create a feature branch (
git checkout -b feature/my-feature) - Commit your changes
- Push to your fork and open a Pull Request