whatisgithub

What is atomos?

revolutionarybukhari/atomos — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · generalComplexity · 1/5LicenseSetup · easy

In one sentence

A single-file browser app that lets you rotate and explore 3D chemistry molecules using webcam hand gestures.

Mindmap

mindmap
  root((ATOMOS))
    What it does
      3D molecule viewer
      Hand gesture control
      Six textbook molecules
    Tech stack
      Three.js
      MediaPipe Hands
      WebAssembly
    Use cases
      Chemistry teaching
      GitHub Pages demo
      Gesture UI reference
    Audience
      Students
      Teachers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Explore 3D molecule structures in a chemistry class using hand gestures.

USE CASE 2

Deploy the single HTML file to GitHub Pages as a free interactive teaching demo.

USE CASE 3

Learn how MediaPipe Hands can be used to build gesture-controlled interfaces.

USE CASE 4

Use the keyboard shortcuts as an accessible alternative to gesture control.

What is it built with?

HTMLJavaScriptThree.jsMediaPipe HandsWebAssembly

How does it compare?

revolutionarybukhari/atomosamureki/sweatbucksanikchand461/ragbucket
Stars00
LanguageHTMLHTMLHTML
Last pushed2025-08-15
MaintenanceQuiet
Setup difficultyeasyeasyeasy
Complexity1/51/52/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Just open the single HTML file in a browser and allow camera access, no build tools needed.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

ATOMOS is a chemistry education tool that lets you explore three-dimensional models of molecules using hand gestures captured by your webcam. It runs entirely in a single HTML file with no installation, no server, and no external dependencies to download. You just open it in a browser, allow camera access, and start interacting. The app includes six molecules commonly found in chemistry textbooks: Water, CO2, Methane, Ammonia, Ethanol, and Benzene. Each is rendered in a ball-and-stick style, showing atoms as colored spheres connected by bonds, with lighting to give depth. A panel alongside shows the formula and chemistry notes for each molecule. Gesture control is handled by MediaPipe Hands, a technology that detects 21 points on each hand in real time through the webcam. A custom classifier built into the app interprets those points as discrete gestures: holding one palm up rotates the molecule, bringing two palms together or apart scales it, pinching with thumb and index finger highlights a specific atom, and closing both fists resets the view. For users who prefer not to use gestures, keyboard shortcuts cover all the same actions. Because all processing happens inside the browser using a WebAssembly runtime, the camera feed never leaves the device, and nothing is sent to any server. The app uses Three.js for WebGL-based 3D rendering, along with vanilla HTML, CSS, and JavaScript with no build tools. It can be deployed to any static hosting service, including GitHub Pages, simply by uploading the single file, and it is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain how the gesture classifier in ATOMOS turns hand landmarks into rotate, scale, and pick actions.
Prompt 2
Show me how to add a new molecule to the six already included in ATOMOS.
Prompt 3
Walk me through deploying this single-file app to GitHub Pages.
Prompt 4
Help me understand how Three.js renders the ball-and-stick molecule models in this project.

Frequently asked questions

What is atomos?

A single-file browser app that lets you rotate and explore 3D chemistry molecules using webcam hand gestures.

What language is atomos written in?

Mainly HTML. The stack also includes HTML, JavaScript, Three.js.

What license does atomos use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is atomos to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is atomos for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.