SkillAgentSearch skills...

hea-bench

Free high-entropy alloy (HEA) and high-entropy oxide calculator: mixing entropy, atomic-size mismatch, VEC, Miedema enthalpy, and the canonical empirical phase-prediction rules. Python library, browser app, desktop app, and MCP server.

Install / Use

claude mcp add dfieser -- npx -y github:dfieser/hea-bench

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

83/100

Supported Platforms

Claude Code
Claude Desktop

Our assessment of hea-bench

hea-bench scores 83/100 on our quality scale, 2999th of 4,716 Development & Engineering skills we index.

Its MCP Server is 30 KB long, well organised into 32 sections with 18 code examples: a thorough specification that gives an agent plenty to work with.

It has 3 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
3/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 11 days ago, so hea-bench is actively maintained.
  • Our last check on 2026-11-12 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-13. Automated pattern scan on 2026-11-13. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

hea-bench compared with similar skills

All 4 of these similar skills score higher than hea-bench; compare them before choosing.

SkillScoreStarsUpdatedFormat
hea-bench (this skill)by dfieser83311d agoMCP Server
taste-skillby Leonxlnx100118.9k11d agoCLAUDE.md
Agent-Reachby Panniantong100113.3k12d agoCLAUDE.md
hyperframesby heygen-com10087.1ktodayCLAUDE.md
rufloby ruvnet10082.1ktodayCLAUDE.md

Frequently asked questions

How do I install hea-bench?
Run claude mcp add dfieser -- npx -y github:dfieser/hea-bench. The install tabs above show the steps for each supported agent.
Which AI agents does hea-bench work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is hea-bench safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is hea-bench still maintained?
The repository was last updated 11 days ago, so hea-bench is actively maintained.
<picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/dfieser/hea-bench/main/docs/assets/banner-dark.png"> <img src="https://raw.githubusercontent.com/dfieser/hea-bench/main/docs/assets/banner-light.png" alt="HEA-Bench: the standard descriptors for high-entropy alloys and oxides, with the work shown."> </picture>

hea-bench

<!-- mcp-name: io.github.dfieser/hea-bench -->

Paper DOI PyPI Python CI License: MIT

Open, interpretable tools for computing the standard high-entropy-alloy (HEA) and high-entropy-oxide (HEO) thermodynamic and geometric descriptors and the classic empirical phase-prediction rules, from any composition. Every descriptor is a transparent closed-form expression over a curated element-property table, validated against the primary literature. The fitted predictions (hardness, phase prediction sets) carry calibrated uncertainty and flag alloys unlike their training data.

Try it now: https://dfieser.github.io/hea-bench/. It needs no install, runs entirely in your browser, and has every library feature: the calculator for alloys, oxides and ceramics with property and phase predictions, the experimental dataset, alloy search and experiment planning, and the benchmark.

<picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/dfieser/hea-bench/main/docs/assets/screenshot-calculator-dark.png"> <img src="https://raw.githubusercontent.com/dfieser/hea-bench/main/docs/assets/screenshot-calculator-light.png" alt="The HEA-Bench browser calculator showing the equimolar Cantor alloy CoCrFeMnNi, with the composition on the left and the computed descriptors on the right."> </picture>

<sup>The equimolar Cantor alloy CoCrFeMnNi, as the browser app reports it. The Python library, the desktop app and this page print the same digits, and a parity suite keeps it that way.</sup>

Using an AI coding agent to integrate this? See AGENTS.md for a machine-oriented guide to the API, exact return types and units, the fastest path to each task, and the mistakes to avoid.

What it computes

For any composition it reports:

  • Core descriptors: mixing entropy ΔS<sub>mix</sub>, atomic-size mismatch δ, mean melting temperature T<sub>m</sub>, Miedema mixing enthalpy ΔH<sub>mix</sub>, valence-electron concentration VEC, Yang–Zhang Ω, Pauling electronegativity mismatch Δχ, Mansoori excess entropy S<sub>E</sub>, ΔG<sub>ss</sub>, ΔG<sub>max</sub>, King Φ, Ye φ.
  • Phase-prediction rules: Yeh entropy, Zhang δ, Guo–Liu VEC, Yang–Zhang Ω, King Φ, Ye φ, Senkov–Miracle κ, the Tsai σ-phase window and Sheikh ductility.
  • Miedema formation enthalpies: compound / solid-solution / amorphous, decomposed into chemical, elastic, structural, and topological terms.
  • Your own elements and pair values: any descriptor or rule, for a composition with an element or pair enthalpy that is not tabulated.
  • High-entropy oxides (hea_bench.oxides + the apps' Oxides mode): rock-salt, perovskite, fluorite, and pyrochlore formability descriptors over Shannon ionic radii with automatic charge-balance oxidation-state assignment: per-sublattice configurational entropy, cation size disorder, Goldschmidt t / octahedral μ / Bartel τ, the fluorite radius-dispersion rule, and the pyrochlore radius-ratio window.

Element coverage: 55 elements for alloys (Ag Al Au Be Bi Ca Ce Co Cr Cu Dy Er Fe Ga Gd Ge Hf Ho In Ir La Li Lu Mg Mn Mo Nb Nd Ni Os Pb Pd Pr Pt Re Rh Ru Sb Sc Si Sm Sn Sr Ta Tb Th Ti Tm U V W Y Yb Zn Zr, covering the full experimentally active rare-earth HEA palette plus the nuclear, solder, and HE-BMG corners). The Miedema pair table covers 75 elements and 1484 of our 1485 pairs. The one missing pair, Th-U, is reported, never zeroed. The oxide module's Shannon table covers 94 elements.

How a number gets made

No fitted model sits anywhere in this chain. Each descriptor is a closed-form expression over curated tables, and the report carries the literature source of every input alongside the value.

flowchart LR
    A["Composition<br/>CoCrFeMnNi"] --> B["Curated element tables<br/>55 elements, 1484 Miedema pairs"]
    B --> C["Closed-form descriptors<br/>ΔS, δ, VEC, ΔH, Ω, Φ, φ, Λ, γ, κ"]
    C --> D["Empirical phase rules<br/>Yeh, Zhang, Guo-Liu, Yang-Zhang, King, Ye"]
    C --> E["Report<br/>per-value provenance, content-hashed result ID"]
    D --> E

Four ways to run it, each with every feature

| Part | Where | Best for | |---|---|---| | Web app | https://dfieser.github.io/hea-bench/ | anyone, no install | | Desktop app | one portable .exe, download (no install), the same app in its own window, engine inside, works offline | Windows users who want it local | | Python library + CLI | pip install "hea-bench[all]" | scripts and notebooks | | MCP server for AI agents | pip install "hea-bench[mcp]", then hea-bench-mcp | Claude, Cursor and other MCP clients, as 24 tools |

Every feature is in all four parts, so pick whichever suits you and you lose nothing. This parity is a standing project rule, and CI enforces it four ways:

  • tests/test_feature_parity.py fails whenever a public feature lacks its library function, its MCP tool or a working app surface.
  • A headless browser uses every tab of the built site.
  • The built desktop exe goes through the same steps before it is attached to a release.
  • A freshly installed wheel answers every MCP tool.

pip install hea-bench alone has no dependencies and covers everything except the fitted models and the MCP server. The [all] extra adds scikit-learn and the MCP SDK for those.

All four share one calculation core. The browser/desktop core (web/hea-calculator-core.js) is a pure-JS port of the Python library. tests/test_web_parity.py guarantees the two match on all 1484 binary pairs and the canonical multi-element fixtures, and tests/test_web_oxides_parity.py does the same for the oxide module, down to identical warning messages. The app's Dataset, Design and Benchmark tabs and its predictions panel run the Python package itself, unchanged, inside the page (Pyodide, web/hea-engine-worker.js). tests/test_web_engine.py checks that the in-page package returns exactly what CPython returns.

Quick start (Python)

pip install hea-bench
import hea_bench as hb

cantor = {"Co": 0.2, "Cr": 0.2, "Fe": 0.2, "Mn": 0.2, "Ni": 0.2}

hb.smix(cantor)               # 13.381 J/(mol·K)  = R · ln 5
hb.delta(cantor)              # 3.164 % atomic-size mismatch
hb.vec(cantor)                # 8.0 valence electrons
hb.mixing_enthalpy(cantor)    # -4.16 kJ/mol  (Miedema)
hb.omega(cantor)              # 5.79  (Yang–Zhang)
hb.delta_chi(cantor)          # 0.138 Pauling electronegativity mismatch
hb.s_excess(cantor)           # 0.318 J/(mol·K)  (Mansoori excess entropy)
hb.delta_g_max(cantor)        # -8.00 kJ/mol  (most-negative Miedema pair)
hb.phi_king(cantor)           # 3.533 (King 2016 proxy)
hb.phi_ye(cantor)             # 34.82 (Ye 2015 proxy)

# Apply the canonical rules
from hea_bench.rules import guo_vec, king_phi, yang_omega, ye_phi, zhang_delta
zhang_delta.predict(cantor)          # 'single-phase'
yang_omega.predict(cantor)           # 'single-phase'
guo_vec.predict(cantor)              # 'FCC'
king_phi.predict(cantor)             # 'solid_solution'
ye_phi.predict(cantor)               # 'solid_solution'

These Cantor-alloy values are pinned in the test suite as the canonical sanity check. The rules are simple empirical surrogates, fast screens rather than predictions, so treat their output accordingly.

Descriptor backends (optional interop)

A pluggable backend can also compute the descriptors. The default (native) is this package's own stdlib implementation. With pip install "hea-bench[interop]", the same interface drives an installed HEACalculator (GPLv3, installed at the user's choice). A workflow standardized on HEACalculator's numbers can then keep them while using everything downstream here:

from hea_bench.descriptors.backend import get_backend
get_backend("heacalculator").compute(cantor)   # same names, their reference data
hea-bench describe Al0.3CoCrFeNi --backend native

The two backends vendor different reference data (radius conventions differ most), so same-named values legitimately differ. docs/backend-agreement.md gives the measured comparison for each descriptor. Quantities whose implementations differ structurally are deliberately not mapped onto each other. The benchmark's published baselines use the native backend unchanged.

Quick start (oxides)

from hea_bench import oxides

# Rost 2015 "J14" entropy-stabilized rock salt
j14 = oxides.describe_rock_salt({"Mg": 1, "Co": 1, "Ni": 1, "Cu": 1, "Zn": 1})
j14["descriptors"]["s_config"]       # 13.382 J/(mol·K) = R·ln 5
j14["oxidation_states"]              # all 2+ by charge balance

# Jiang 2018 single-phase high-entropy perovskite
pvk = oxides.describe_perovskite({"Sr": 1}, {"Zr": 1, "Sn": 1, "Ti": 1, "Hf": 1, "Mn": 1})
pvk["descriptors"]["goldschmidt_t"]  # 0.979, inside the 0.92–1.04 window
pvk["verdicts"]["bartel"]            # 'perovskite' (τ = 3.72 < 4.18)

Each describe_* report carries the solved oxidation states, the Shannon radii actually used, every descriptor, the formability verdicts with their windows, and any warnings. See examples/02_oxides_walkthrough.py for the full tour, including the fluorite and pyrochlore screens and oxidation-state overrides.

Quick start (ceramics, experimental)

hea_bench.ceramics extends the calculator to rock-salt carbides and nitrides and AlB2-type diborides, composition-only and honest about what that buys:

from hea_bench import ceramics

hec = ceramics.describe_rock_salt_carbide({"Ti": 1, "Zr": 1, "Hf": 1, "Nb": 1, "Ta": 1})
hec["vec_per_formula_unit"]        # 8.4, with annotated literature reference points
hec["entropy"]                     # all normalization conventions, labelled

Reports carry the metal-sublattice entropy in every published normalization convention, because papers switch between them without warning. They give VEC with annotated reference points rather than a verdict, since the literature marks points, not one window. They also state what is deferred. The size-mismatch descriptor waits because the field computes it from DFT binary-cell bond lengths, and adopting a cited table is real curation work. Entropy-forming-ability and DEED are DFT-ensemble quantities that this package cannot and does not claim to reproduce. Background, citations, and a license audit of candidate ceramics datasets: docs/ceramics.md.

Quick start (AI agents, MCP)

LLM agents hallucinate descriptor values. This server grounds them. hea_bench.mcp_server exposes every feature of the package over the Model Context Protocol as 24 deterministic tools. The calculator: parse_composition, batch alloy_descriptors (with the Miedema enthalpies) and alloy_rules, both taking custom elements and pair values

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars3
CategoryDevelopment
Updated11d ago
Forks1

Languages

Python

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low