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
- Ingredient browser — search names, synonyms, and ontology identifiers; filter by source, mapping status, and mapping quality.
- Mapped ingredients — browse the mapped subset.
- Embedding map and graph layout — explore ingredient relationships in KG-Microbe embedding space.
Recent Additions
Five most recently added ingredient records in the pinned repository snapshot (0dac278):
- 2,5-didehydro-D-gluconate (
CHEBI:11449, added 2026-11-02) - Na2MoO4 x H2O (
UNMAPPED_0851, added 2026-11-01) - Trisodium citrate x 3 H2O (
UNMAPPED_0852, added 2026-11-01) - Na2-citrate (
cas:144-33-2, added 2026-09-24) - 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:
- Ingredient records with identifiers, synonyms, mapping status, and curation history.
- Ontology mappings, mostly to ChEBI, then MeSH, NCIT, MicrO, FOODON and ENVO, with quality ratings. Where curation found no ontology term, about 175 mapped ingredients carry kg-microbe registry ids, mostly for preparations and mixtures, and about 85 carry CAS Registry Numbers; about 55 more carry kg-microbe placeholder ids pending curation.
- Environmental context linked to ENVO terms with relevance qualifiers.
- Curation events that record provenance and LLM assistance.
- Component relationships for ingredients made of other components, with evidence and validation.
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
- Repository and published site
- Current mapping inventory
- Workflow guide
- Licensing policy: CC BY 4.0 for data; BSD-3-Clause for code. Redistributed source material retains its applicable terms.
Related Tools
- X-Mech Suite overview - All fourteen Mechs, their shared vocabulary and cross-references, and the culturebotai-claw orchestrator
- HabitatMech - Habitats harmonized from GOLD, BacDive, PREGO and Madin et al. into ontology-grounded records
- CommunityMech - Microbial community interaction modeling
- TaxonMech - Microbial taxa and strains grounded in NCBI Taxonomy, harmonized with GTDB, LPSN and BacDive
- TraitMech - Autonomous knowledge factory for microbial ecophysiological traits
- PathwayMech - Microbial pathway mechanisms with participants, reactions, causal edges, and reference-backed evidence
- CellStructureMech - Microbial cell structures, between the trait and protein layers
- ProteinTraitsMech - Protein sequence, structure, and function traits
- DUFMech - Domains and protein families of unknown function, with evidence gathering and triage worklists
- NaturalProductMech - Natural product structures with their producer organisms and gene clusters
- AntibioticMech - Antimicrobial structures harmonizing ChEBI and CARD/ARO
- CMMMech - Evidence-backed microbial extraction, transformation and recovery of critical materials
- AIMech - AIO-grounded AI concepts with maintained evidence and explicit ontology mappings
- CultureMech - Chemical entity extraction from media recipes (6,325 canonical media)
- MicroMediaParam - Chemical compound standardization (78% ChEBI coverage)
- kg-microbe - Central knowledge graph for microbial cultivation
Contact & Collaboration
For questions about MediaIngredientMech or to contribute:
- Principal Investigator: Dr. Marcin P. Joachimiak
- Email: mjoachimiak@lbl.gov
- Organization: CultureBotAI
- Laboratory: Environmental Genomics and Systems Biology Division, Lawrence Berkeley National Laboratory
Bibliography
- 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
- 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
- METPO: Microbial Ecophysiological Trait and Phenotype Ontology. BioPortal · GitHub