How fararen/humanoidth works
Thailand Humanoid Atlas is a research database and interactive map of Thailand’s humanoid and social-robotics ecosystem. Its user workflow is to collect records from external sources or community submissions, review and store them, then explore the resulting perspectives, contributions, robot registry, and physical inventory through the atlas, map, network, and analytics views. The graph includes documented product capabilities and the sampled API/network implementation. Most page-to-data wiring and the Python pipeline internals were not sampled, so uncertain links are omitted.
Main entry points: __init__.py Source adapters · network-graph.ts Graph builder · cli.py Atlas CLI · page.tsx Overview
Components 25
Atlas interface
- Overview
app/page.tsx - Robot registry
app/robots/page.tsx - Perspectives
app/perspectives/page.tsx - Contributions
app/contributions/page.tsx - Asset inventory
app/inventory/page.tsx - Contribution map
app/map/page.tsx - Map data actions
app/map/actions.ts - Network explorer
app/network/NetworkGraphClient.tsx - Analytics
app/analytics/page.tsx
Collection and review
- Data pulls
app/data-pulls/page.tsx - Ingest endpoint
app/api/ingest/[adapter]/route.ts - Ingest adapters
lib/ingest/adapters.ts - Community submission
app/submit-data/page.tsx - Submission review
app/admin/submitted-data/page.tsx - CSV export
app/api/export/route.ts
Data and analysis
- Network API
app/api/network/graph/route.ts - Network detail APIs
app/api/network/node/[node_id]/route.ts - Graph builder
lib/network-graph.ts - Atlas database
lib/prisma.ts
Research pipeline
- Atlas CLI
src/humanoid_atlas/cli.py - Source adapters
src/humanoid_atlas/adapters/__init__.py - Analysis pipeline
src/humanoid_atlas/pipeline/nlp.py - Data repositories
src/humanoid_atlas/db/repos.py
Other components
- Atlas visitor
- Research sources
Connections 16
- Atlas visitor → Overview: browses
- Atlas visitor → Data pulls: starts pulls
- Atlas visitor → Community submission: submits records
- Ingest endpoint → Ingest adapters: runs adapter
- Ingest adapters → Research sources: retrieves records
- Network explorer → Network API: fetches graph
- Network API → Graph builder: builds graph
- Network detail APIs → Graph builder: looks up detail
- Graph builder → Atlas database: reads records
- Overview → Atlas database: reads metrics
- Contribution map → Map data actions: requests points
- Atlas CLI → Source adapters: runs collection
- Atlas CLI → Analysis pipeline: runs analysis
- Source adapters → Research sources: collects records
- Analysis pipeline → Data repositories: uses data
- Source adapters → Data repositories: stores records