How sumet-saeyi/humanoidth works
Thailand Humanoid Atlas is a research and community platform for collecting and exploring Thailand’s humanoid-robotics ecosystem. Its principal workflow is to gather records through source adapters and community submissions, persist them, then expose the resulting robot registry, perspectives, contributions, and inventory through browsing, mapping, analytics, and network views. The graph includes the documented product areas even where their page implementations were not sampled; links for those areas are omitted when wiring is not evidenced. The tree also contains a Python atlas runtime, shown as a separate subsystem because its integration with the Next.js app is not established by the excerpts.
Main entry points: prisma.ts Prisma access · cli.py Python CLI · server.py Python web viewer · page.tsx Atlas overview
Components 27
Atlas experience
- Atlas overview
app/page.tsx - Robot registry
app/robots/page.tsx - Media perspectives
app/perspectives/page.tsx - Contributions
app/contributions/page.tsx - Asset inventory
app/inventory/page.tsx - Contribution map
app/map/page.tsx - Network explorer
app/network/NetworkGraphClient.tsx - Analytics
app/analytics/page.tsx - Database browser
app/database/page.tsx
Collection and review
- Data-pull controls
app/data-pulls/page.tsx - Ingest endpoint
app/api/ingest/[adapter]/route.ts - Source 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
- Prisma access
lib/prisma.ts - Atlas database
- Network API
app/api/network/graph/route.ts - Graph builder
lib/network-graph.ts
Python runtime
- Python CLI
src/humanoid_atlas/cli.py - Python adapters
src/humanoid_atlas/adapters - Analysis pipeline
src/humanoid_atlas/pipeline - Python repositories
src/humanoid_atlas/db/repos.py - SQLite database
src/humanoid_atlas/db/session.py - Python web viewer
src/humanoid_atlas/viewer/server.py
Other components
- Researcher / visitor
- External source services
Connections 26
- Researcher / visitor → Atlas overview: browses
- Researcher / visitor → Robot registry: explores
- Researcher / visitor → Media perspectives: explores
- Researcher / visitor → Contributions: explores
- Researcher / visitor → Asset inventory: explores
- Researcher / visitor → Contribution map: explores
- Researcher / visitor → Network explorer: explores
- Researcher / visitor → Analytics: explores
- Researcher / visitor → Data-pull controls: starts pulls
- Researcher / visitor → Community submission: submits records
- Data-pull controls → Ingest endpoint: triggers
- Ingest endpoint → Source adapters: runs adapter
- Source adapters → External source services: retrieves records
- Community submission → Prisma access: submits data
- Submission review → Prisma access: reviews records
- CSV export → Prisma access: reads records
- Atlas overview → Prisma access: reads metrics
- Network API → Graph builder: builds graph
- Graph builder → Prisma access: reads records
- Prisma access → Atlas database: queries
- Python CLI → Python adapters: runs collection
- Python CLI → Analysis pipeline: runs analysis
- Python adapters → External source services: retrieves records
- Python web viewer → Python repositories: queries data
- Python web viewer → Analysis pipeline: rebuilds caches
- Python repositories → SQLite database: accesses