← Plugin catalog
Developer Tools

Vibe Catalysis

Aoni Xu v1.3.0

Run ASE + UMA adsorption

Create a free account to save this plugin.

From the developer

Declared capabilities

  • Local computation
  • Scientific visualization

Not specified in the available declarations: limitations, pricing & account requirements.

Onboarding example

Calculate CO adsorption on Cu(111) and compare sites.
Sources & dates

Developer declarations; not independently tested. Listing last checked Nov 21, 2026. Package observed Nov 20, 2026.

View package source →

Description

From the marketplace listing

Generate or import catalyst structures, run ASE + UMA adsorption calculations, and compare CO-family hydrogenation with an explicit H2-referenced computational hydrogen electrode energy profile.

Language: English · Automatically detected from descriptions.

What changed

Similar plugins

Finding similar plugins… Results will appear here automatically.

Browse plugins →

Keywords

Files & skills

File archives

Plugin package11 files · 281 KBBrowse files →
Skill instructions
vibe-catalysis9.22 KB

View saved version →

---
name: vibe-catalysis
description: Build and run local heterogeneous-catalysis adsorption calculations with ASE and FAIR-Chem UMA. Use when a user asks Codex to model, relax, rank, inspect, or estimate adsorption energies for CO, CHO/HCO, COH, CHOH, or CH2OH on a generated elemental fcc/bcc/hcp surface or a user-supplied catalyst slab/framework such as a COF, MOF, oxide, nitride, supported catalyst, CIF, POSCAR/CONTCAR, XYZ/EXTXYZ, or TRAJ; also use for the Vibe Catalysis ten-step workflow, adsorption-site enumeration, active-atom selection, fixed slab layers, UMA relaxation, data processing, plots, or generated structure/result files.
---

# Vibe Catalysis

Run the deterministic local backend; do not generate ad hoc ASE calculation
code when the validated backend can perform the request.

## Resolve the local runtime

Use the backend bundled with this installed skill:

```text
Python: a Python 3.12 environment containing ASE, fairchem-core, NumPy, and Matplotlib
Backend: scripts/predict_adsorption.py
Launcher: scripts/run_local.py
```

Run `python3 scripts/run_local.py --check` before the first calculation in a task.
The launcher must choose the working runtime reported by that check; it searches
`VIBE_CATALYSIS_PYTHON` and common `cathub-uma` Conda locations, so the Python
used to start the launcher does not itself need ASE. Stop and explain the missing
dependency only if this launcher check fails after its search. Never request or print the
Hugging Face token; FAIR-Chem reads the existing local login and cached model.
The user must separately obtain access to the gated `facebook/UMA` model and
authenticate through Hugging Face. Access and model weights are not bundled.

## Translate the request

Extract:

- structure source: either an attached/local catalyst structure readable by ASE, or an
  elemental metal whose ASE reference state is `fcc`, `bcc`, or `hcp`;
- facet for generated slabs: fcc `111`/`100`/`110`, bcc `111`/`100`/`110`, or
  hcp `0001`/`10-10`;
- adsorbate: `CO`, `CHO`, `COH`, `CHOH`, or `CH2OH`;
- optional slab size, sites, anchors, vacuum, fixed layers, `fmax`, and steps.

Treat `CHO`/`HCO` as the formyl isomer. Keep `COH` distinct. If the user omits
settings, use 3×3×4 (3×4×4 for hcp(10-10)), 10 Å vacuum, bottom two
layers fixed, `fmax=0.05 eV/Å`, and at most 100 LBFGS steps. Infer the stable
crystal structure from ASE. If the facet is omitted, use fcc(111), bcc(110),
or hcp(0001). Run one metal per job; multiple requested adsorbates may run as
separate child calculations under one comparison directory.

When the user supplies a structure, resolve its local absolute path and pass it
with `--structure`; do not require a metal or facet. Treat **every atom already
in the file as part of the catalyst/framework**, even C, O, N, or H. Never infer
adsorbates from element identity. Only the species explicitly requested for
addition is the new adsorbate. Never modify or overwrite the uploaded source. CIF, POSCAR/CONTCAR,
XYZ/EXTXYZ, TRAJ, and any other format readable by ASE are acceptable, but CIF
usually cannot preserve VASP selective-dynamics constraints. Do not attempt to
decompose a pre-existing combined structure into catalyst and adsorbate unless
the user explicitly supplies atom membership or paired-state inputs.

## Execute the ten-step workflow

1. Build a supported elemental slab, or read the user-supplied catalyst/framework structure without changing the source or reclassifying its atoms.
2. Validate its 3D cell, in-plane periodicity, and approximate vacuum; for generated structures, add vacuum and surface-plane periodicity.
3. Preserve constraints read by ASE; if none exist, apply `FixAtoms` to the bottom two layers. Replace uploaded constraints only when the user explicitly asks.
4. Build and independently relax the gas-phase molecular/isomer reference and H₂ for CHE hydrogenation energies.
5. For generated slabs, enumerate ASE's named sites for that exact surface. For uploaded slabs, discover index

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 4 — file references are metadata, not package contents.

Package details

Publisher declarations from the archived package. These are separate from our research and the live service's terms.

Package author
Aoni Xu
Keywords
See keywords

Declared capabilities

  • Local computation
  • Scientific visualization

Package observed Nov 20, 2026.

Technical details
First seen
Sep 30, 2026 · 22:02 UTC
Last seen
Nov 21, 2026 · 00:00 UTC
Collection status
Collected

plugins_6a7511ad47d88191bdfad321d2efe514

Download plugin data (JSON)

Plugin details: freshly prepared. Prepared . Refreshed when plugin data changes or after 6 hours. Your account and Follow status are live.