MediaIngredientMech: Autonomous Knowledge Factory for Media Ingredients

Overview

MediaIngredientMech is an autonomous knowledge factory for culture-media ingredient identity and ontology mappings, with LLM-assisted curation and human oversight. It maintains ingredient records, synonyms, mapping quality, environmental context, and an audit trail for curation decisions. Repository overview.

The published browser contains 2,956 ingredients: 2,611 MAPPED, 262 UNMAPPED, 82 REJECTED, and 1 AMBIGUOUS, giving 88% mapped coverage after rounding. These figures were checked on November 8, 2026 against the browser’s live data index.

Explore the Published Site

Recent Additions

Five most recently added ingredient records in the pinned repository snapshot (0dac278):

  1. 2,5-didehydro-D-gluconate (CHEBI:11449, added 2026-11-02)
  2. Na2MoO4 x H2O (UNMAPPED_0851, added 2026-11-01)
  3. Trisodium citrate x 3 H2O (UNMAPPED_0852, added 2026-11-01)
  4. Na2-citrate (cas:144-33-2, added 2026-09-24)
  5. Nitrilotriacetic acid, trisodium salt (CHEBI:132766, added 2026-09-22)

See all fourteen Mechs’ recent additions on the X-Mech Suite overview.

What a Record Represents

An ingredient record identifies a practical reagent or formulation used in media. Curation distinguishes salts, hydrates, mixtures, and other forms, preserves raw names as synonyms, and records the convention used when sources are ambiguous. Mapping quality and curation status are separate fields. Mapping semantics.

The current model includes:

See the schema reference, environmental-context model, and component model.

Curation Workflow

Curators compare upstream recipe changes with the tracked ingredient corpus, make scoped updates with provenance, and validate ontology identifiers and labels through OAK/OLS. Ingredient occurrence counts help prioritize unmapped records. Validated mapping artifacts can then support coordinated downstream updates to CultureMech.

The former CultureMech collection writers are retired because their aggregate projections could overwrite ingredient curation. Current guidance is to review upstream changes and apply scoped updates to MIM-owned records. Current workflow and migration status.

Getting Started

Development and CI use Python 3.13, uv, and just:

git clone https://github.com/CultureBotAI/MediaIngredientMech.git
cd MediaIngredientMech
just install
just gen-schema
just validate-all

For an interactive curation session:

just snapshot
just curate
just report

These are the repository’s documented commands. See the curation guide and role-curation workflow for record editing and validation.

Exports and Integration

The project provides YAML records, browser JSON, generated inventories, SSSOM mappings, and a standalone KGX ingredient graph. The reviewed SSSOM release holds 1,763 supported mappings. It keeps the 1,255 withheld mappings in a separate file. An earlier release carries a KGX snapshot limited to supported assertions. SSSOM predicates preserve distinctions between exact, close, broader, and narrower matches. Registry identity mappings and ontology assertions have different meanings; downstream consumers should follow the mapping contract.

kg-microbe stages reviewed ingredient mappings as candidates; production integration still requires its separate review and validation steps. Current integration status.

Deep-research tools help select providers and prepare ingredient research. Their results remain curation proposals until identity and evidence are validated. Provider workflow.

Repository & Documentation



Contact & Collaboration

For questions about MediaIngredientMech or to contribute:


Bibliography

  1. Santangelo BE, Hegde H, Caufield JH, Reese J, Kliegr T, Hunter LE, Lozupone CA, Mungall CJ, Joachimiak MP. KG-Microbe — Building Modular and Scalable Knowledge Graphs for Microbiome and Microbial Sciences. GigaScience. 2026;giag077. doi:10.1093/gigascience/giag077
  2. Caufield JH, Hegde H, Emonet V, Harris NL, Joachimiak MP, et al. Structured Prompt Interrogation and Recursive Extraction of Semantics (SPIRES): a method for populating knowledge bases using zero-shot learning. Bioinformatics. 2024;40(3):btae104. doi:10.1093/bioinformatics/btae104 · free full text
  3. METPO: Microbial Ecophysiological Trait and Phenotype Ontology. BioPortal · GitHub

Full publication list →