CommunityMech: Autonomous Knowledge Factory for Microbial Communities

Overview

CommunityMech is an autonomous knowledge factory for microbial community composition, ecological interactions, cultivation conditions, environments, and supporting evidence, with human oversight. Canonical YAML records feed schema validation, static browsing, and graph exports. Repository overview.

The repository contains 392 community records and four additional isolate records. The published site lists 392 communities across 16 categories, checked on September 20, 2026. Its landing page also advertises 512-dimensional v3 embeddings; the embedding views are separate derived artifacts and can cover a different set of records from the current browser. Published site.

Explore the Published Site

Data Architecture

Location Contents
kb/communities/ Canonical microbial community records
data/isolates/ Additional records using the community schema
kb/taxa/ Reusable taxon, genome, and gene records
references_cache/ Source text used by evidence checks
history/ Append-only curation provenance
docs/ Published HTML and maintainer documentation

A community record can describe taxonomic membership, functional roles, environmental context, cultivation conditions, and directed ecological interactions. Ontology identifiers are paired with labels, and evidence is attached to the assertions it supports. Schema validation checks structure; literature validation separately checks evidence against source text. Validation and evidence workflow.

Example: A Curated Community

The Yogurt Two-Species Starter Culture record, CommunityMech:000164, documents Streptococcus thermophilus and Lactobacillus delbrueckii subsp. bulgaricus. It records cross-feeding interactions with taxon and metabolite identifiers and supporting literature.

The README’s schema-validated example shows how that record represents membership, formate exchange, and evidence. Use the linked YAML for the complete current record.

Getting Started

Development and CI use Python 3.13, uv, and just. Run commands from a source checkout:

git clone https://github.com/CultureBotAI/CommunityMech.git
cd CommunityMech
just install
just test

Validate a tracked community:

community_record=kb/communities/Yogurt_TwoSpecies_Starter_Culture.yaml
just validate "$community_record"
just validate-strict "$community_record"
just validate-gtdb "$community_record"
just validate-gtdb-domain "$community_record"
just validate-terms "$community_record"

Evidence checking is a separate step and may use network access:

just validate-references-explained "$community_record"

The repository documents a corpus-wide evidence-repair backlog. A structurally valid record does not by itself establish that all of its scientific assertions have been verified. Current validation status.

Generate Pages and Graph Exports

just gen-html
just check-docs-current
just gen-browser
just kgx-export
just kgx-validate

GitHub Pages serves the committed docs/ tree. Update community YAML or rendering templates before regenerating derived HTML. Embedding-map generation additionally needs the local embedding artifact described in the visualization guide.

The KGX exporter writes nodes.tsv, edges.tsv, and manifest.json under output/kgx/; release artifacts compress the two TSV files. Edges carry deterministic identifiers, relation predicates, source attribution, and available publication/supporting-text evidence. These exports support downstream graph integration and community analysis. KGX contract.

Integration with the X-Mech Suite

Community records can refer to CultureMech media and MediaIngredientMech ingredients. CommunityMech contributes structured community evidence for downstream consortium research, including PFASCommunityAgents. Consult each downstream project’s documentation for its supported integration interface.

Repository & Documentation



Publications & Citations

Primary Citation

If you use CommunityMech in your research, please cite:

Santangelo BE, et al. (2026). KG-Microbe - Building Modular and Scalable Knowledge Graphs for Microbiome and Microbial Sciences. GigaScience, giag077. doi: 10.1093/gigascience/giag077


Contact & Collaboration

For questions about CommunityMech or consortium design projects:


Acknowledgments

CommunityMech development is supported by:


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. Naseem S, Miller MA, Martinez-Gomez NC, Sun N, Joachimiak MP. MicroGrowAgents: An Agentic AI System for Microbial Cultivation Engineering. bioRxiv. 2026. doi:10.64898/2026.06.04.729985
  3. Máša P, Kliegr T, Joachimiak MP. Explainable rule-based prediction of cultivation media for microbes. Computational and Structural Biotechnology Journal. 2025;27:5194–5206. doi:10.1016/j.csbj.2025.10.014 · free full text

Full publication list →