APP v0.1.0 Pending Review

Adom Molecule CLI

Import KiCad, Fusion 360, and EasyEDA files into the Adom molecule system. Create, optimize, list, and delete molecules from the command line or Claude Code.

⚡ Install this app

Paste this into Claude Code (VS Code panel, Adom editor, or terminal) to install:

I want to install the "Adom Molecule CLI" app from the Adom Wiki (https://wiki-ufypy5dpx93o.adom.cloud/wiki/apps/adom-molecule). For the Docker CLI: gh release download v0.1.0 --repo adom-inc/adom-molecule --pattern adom-molecule -D /usr/local/bin && chmod +x /usr/local/bin/adom-molecule && adom-molecule install Then verify the install works.

Download v0.1.0

⊞ Windows coming soon

macOS coming soon

🐧 Linux coming soon

🐳 Adom Docker CLI adom-molecule · 3.1 MB

See all releases on GitHub (private repo — access required)

Adom Molecule CLI

Rust CLI that wraps the Hydrogen molecule import pipeline. Upload KiCad, Fusion 360, or EasyEDA design files to create molecules, automatically queue 3D optimization via the Blender pipeline, and manage your molecule library — all from the command line or Claude Code.

Install

gh release download v0.1.0 --repo adom-inc/adom-molecule --pattern 'adom-molecule' -D /usr/local/bin
chmod +x /usr/local/bin/adom-molecule
adom-molecule install

Quick Start

# Check connectivity
adom-molecule health

# Create a KiCad molecule (uploads + auto-optimizes)
adom-molecule create --name "RP2040_Core" --owner adom \
    --glb model.glb --pcb board.kicad_pcb --sch schematic.kicad_sch

# Create a Fusion 360 molecule
adom-molecule create --source fusion --name "Enclosure" --owner john \
    --usdz model.usdz --silk-top silkscreen.png

# List all molecules
adom-molecule list

# Delete a molecule
adom-molecule delete --owner john --name "OldBoard"

Supported Sources

Source	Required Files	Pipeline
KiCad	`.glb`, `.kicad_pcb`, `.kicad_sch`	Blender 3D optimization
Fusion 360	`.usdz`, silkscreen `.png`	USDZ-to-GLB conversion via Blender
EasyEDA	`.obj`	Direct upload

Source type is auto-detected from file extensions, or set explicitly with --source.

How It Works

Upload — Files are sent via multipart POST to the Hydrogen API (/api/molecules/create)
Optimize — After upload, the CLI auto-queues the Blender optimization pipeline (KiCad or Fusion, depending on source)
Result — Molecule appears at hydrogen.adom.inc/{owner}/molecules/{name} with optimized 3D model

Repo

Source: https://github.com/adom-inc/adom-molecule (private)
Binary: 3.1 MB (Linux x86_64)
Dependencies: serde, ureq, clap (same stack as adom-wiki CLI)

Install notes

Adom Docker CLI install steps

gh release download v0.1.0 --repo adom-inc/adom-molecule --pattern adom-molecule -D /usr/local/bin && chmod +x /usr/local/bin/adom-molecule && adom-molecule install

AI Skill — how Claude uses this app

Edit AI Skill

name: adom-molecule description: > Use when the user wants to create a molecule, import KiCad/Fusion 360/EasyEDA files into the Adom molecule system, upload a molecule, optimize a molecule's 3D model, list molecules, or delete a molecule. Trigger words: create molecule, import molecule, upload molecule, molecule from kicad, molecule from fusion, import kicad files, upload fusion files, list molecules, delete molecule, optimize molecule, usdz to glb, kicad to molecule, fusion to molecule.

Adom Molecule CLI

Create and manage Adom molecules from KiCad, Fusion 360, and EasyEDA design files. Wraps the Hydrogen molecule import pipeline — file upload, Blender 3D optimization, listing, and deletion.

Quick Start

# Check connectivity
adom-molecule health

# Create a KiCad molecule (uploads files + auto-queues 3D optimization)
adom-molecule create --source kicad --name "MyBoard" --owner john \
    --glb model.glb --pcb board.kicad_pcb --sch schematic.kicad_sch

# Create a Fusion 360 molecule
adom-molecule create --source fusion --name "MyEnclosure" --owner john \
    --usdz model.usdz --f3d design.f3d --brd board.brd --silk-top silkscreen.png

# List all molecules
adom-molecule list

# Delete a molecule
adom-molecule delete --owner john --name "MyBoard"

Commands

`adom-molecule health`

Check connectivity to the Hydrogen and Carbon APIs.

Example:

adom-molecule health
# OK: Hydrogen API reachable (https://hydrogen.adom.inc)
# OK: Carbon API reachable (https://carbon.adom.inc)

`adom-molecule create`

Upload design files and create a molecule. Auto-queues 3D optimization unless --no-optimize is passed.

Flag	Required	Description
`--source`	no	`kicad`, `fusion`, or `easyeda`. Auto-detected from files if omitted.
`--name`	yes	Molecule name
`--owner`	yes	Owner username or org name
`--glb`	KiCad	Path to `.glb` 3D model
`--pcb`	KiCad	Path to `.kicad_pcb` board file
`--sch`	KiCad	Path to `.kicad_sch` schematic file
`--pro`	no	Path to `.kicad_pro` project file
`--usdz`	Fusion	Path to `.usdz` 3D model
`--f3d`	no	Path to `.f3d` Fusion native file
`--brd`	no	Path to `.brd` board file
`--sch-eagle`	no	Path to `.sch` EAGLE schematic file
`--silk-top`	Fusion	Path to silkscreen top `.png`
`--silk-bottom`	no	Path to silkscreen bottom `.png`
`--obj`	EasyEDA	Path to `.obj` 3D model
`--extra`	no	Additional files (repeatable)
`--no-optimize`	no	Skip automatic optimization queue

KiCad example:

adom-molecule create --name "RP2040_Core" --owner adom \
    --glb /home/adom/project/molecules/rp2040/model.glb \
    --pcb /home/adom/project/molecules/rp2040/board.kicad_pcb \
    --sch /home/adom/project/molecules/rp2040/schematic.kicad_sch \
    --pro /home/adom/project/molecules/rp2040/project.kicad_pro
# OK: Created molecule "RP2040_Core" (v1). Optimization queued.

Fusion 360 example:

adom-molecule create --source fusion --name "Enclosure_v2" --owner john \
    --usdz /home/adom/exports/enclosure.usdz \
    --f3d /home/adom/exports/enclosure.f3d \
    --brd /home/adom/exports/board.brd \
    --silk-top /home/adom/exports/silkscreen_top.png
# OK: Created molecule "Enclosure_v2" (v1). Fusion optimization queued.

EasyEDA example:

adom-molecule create --source easyeda --name "Sensor_Board" --owner adom \
    --obj /home/adom/exports/sensor.obj
# OK: Created molecule "Sensor_Board" (v1).

With extra files:

adom-molecule create --name "MyBoard" --owner adom \
    --glb model.glb --pcb board.kicad_pcb --sch schematic.kicad_sch \
    --extra datasheet.pdf --extra bom.csv
# OK: Created molecule "MyBoard" (v1). Optimization queued. 2 extra file(s) attached.

`adom-molecule optimize`

Manually queue a KiCad molecule for 3D optimization (Blender pipeline). Normally not needed — create does this automatically.

Flag	Required	Description
`--owner`	yes	Owner username or org
`--name`	yes	Molecule name
`--version`	yes	Version string (e.g. `v1`)
`--glb`	yes	GLB filename that was uploaded

Example:

adom-molecule optimize --owner adom --name "RP2040_Core" --version v1 --glb model.glb
# OK: Optimization queued for "RP2040_Core" v1 (job abc123)

`adom-molecule optimize-fusion`

Manually queue a Fusion 360 molecule for USDZ-to-GLB optimization.

Flag	Required	Description
`--owner`	yes	Owner username or org
`--name`	yes	Molecule name
`--version`	yes	Version string
`--usdz`	no	USDZ filename
`--f3d`	no	F3D filename
`--brd`	no	BRD filename
`--silk-top`	yes	Silkscreen top filename

Example:

adom-molecule optimize-fusion --owner john --name "Enclosure_v2" --version v1 \
    --usdz enclosure.usdz --silk-top silkscreen_top.png
# OK: Fusion optimization queued for "Enclosure_v2" v1 (job def456)

`adom-molecule list`

List all molecules in the system.

Example:

adom-molecule list
# OK: 0 molecule(s)
# (empty — no molecules created yet)

`adom-molecule delete`

Delete a molecule.

Flag	Required	Description
`--owner`	yes	Owner username or org
`--name`	yes	Molecule name

Example:

adom-molecule delete --owner john --name "OldBoard"
# OK: Deleted molecule "OldBoard" owned by john

`adom-molecule install`

Deploy the SKILL.md to ~/.claude/skills/adom-molecule/ and optionally copy the binary to /usr/local/bin/.

Example:

adom-molecule install
# OK: Installed skill to /home/adom/.claude/skills/adom-molecule/SKILL.md
# OK: Binary already at /usr/local/bin/adom-molecule

Source Types & Required Files

Source	Required Files	Optional Files
KiCad	`.glb`, `.kicad_pcb`, `.kicad_sch`	`.kicad_pro`
Fusion 360	`.usdz`, silkscreen top `.png`	`.f3d`, `.brd`, `.sch`, silkscreen bottom `.png`
EasyEDA	`.obj`	—

If --source is omitted, it's auto-detected from file extensions:

.glb, .kicad_pcb, .kicad_sch → KiCad
.usdz, .f3d, .brd, .png → Fusion 360
.obj → EasyEDA

Environment Variables

Variable	Default	Description
`ADOM_HYDROGEN_URL`	`https://hydrogen.adom.inc`	Hydrogen API base URL
`ADOM_CARBON_URL`	`https://carbon.adom.inc`	Carbon API base URL

Troubleshooting

`ERROR: Failed to create molecule: Access Key Id does not exist`

The Hydrogen server's S3 storage credentials are expired or misconfigured. This is a server-side issue — contact the Adom team.

`ERROR: Cannot reach Hydrogen API`

Check your network connection. The API is at https://hydrogen.adom.inc. From inside an Adom container, this should always be reachable.

Optimization queued but molecule doesn't update

The Blender optimization pipeline runs asynchronously. Check the molecule page at https://hydrogen.adom.inc/{owner}/molecules/{name} after a few minutes.

Sub-Skills
?
What are Sub-Skills?
Sub-skills are community-contributed AI skill extensions for this component. They teach AI assistants about specific tools, configurators, or workflows.

Examples:

A manufacturer’s configuration tool for a motor controller

A community-written design guide for an amplifier circuit

An automated test/validation script for a sensor module

How to add one: Click Add Sub-Skill, provide the URL to your skill and a brief description. Submissions are reviewed by the Adom team before going live.

No sub-skills yet. Be the first to contribute one!

🔎 How Claude finds this page (discovery snippet)

This page opts into Adom Wiki auto-discovery. When a user working in Claude Code mentions any of the trigger phrases below, Claude can proactively suggest this page. The pitch is exactly what Claude will say.

Pitch

"Import KiCad, Fusion 360, or EasyEDA design files into Adom molecules with one command. Handles file upload, 3D optimization (Blender pipeline), and molecule management."

Triggers

"create molecule", "import molecule", "upload molecule", "molecule from kicad", "molecule from fusion", "import kicad files", "upload fusion files", "list molecules", "delete molecule", "optimize molecule", "usdz to glb", "kicad to molecule", "fusion to molecule", "blender optimization", "molecule pipeline"

Page URL

/apps/adom-molecule