Skip to main content
MoCo Logo

MoCo: A One-Stop Shop for Model Collaboration Research

MoCo is a toolkit for Model Collaboration research, where multiple language models collaborate and complement each other for compositional AI systems.

Technical report: paper

Quick Start

Environment Setup

We use uv for package management.

uv venv --python 3.10 moco
source moco/bin/activate
uv pip install -r requirements.txt

The nvidia-*-cu12 entries in requirements.txt are bundled CUDA wheels; skip them if your system already has CUDA drivers installed, or install torch via the PyTorch index instead (uv pip install torch==2.7.1 --index-url https://download.pytorch.org/whl/cu126).

Optional: NemotronH / Mamba model support (click to expand)

If you plan to use NemotronH models, also install causal-conv1d and mamba-ssm:

uv pip install --no-build-isolation --no-deps git+https://github.com/Dao-AILab/causal-conv1d.git
uv pip install --no-build-isolation --no-deps git+https://github.com/state-spaces/mamba.git

If this crashes at runtime with no kernel image is available for execution on the device on GPUs like RTX 3090/A40/A10 or L40/L40S/RTX 4090, see docs/user_readme.md for why and how to fix it.

Running Your First Collaboration

If you don't have 3 GPUs, go to model_collaboration/test_config.json and set "gpu_ids": [0], [0,1], or whatever you have; if your GPU is nice, increase batch_size.

python -m model_collaboration.main -c model_collaboration/test_config.json

You will see the outputs and evaluation results in the model_collaboration/logs/ folder.

Supported Methods

MoCo currently supports the following model collaboration algorithms, across API-level, text-level, logit-level, and weight-level collaboration. We provide a sample config for each method in examples/ and please check out docs/user_readme.md for more details about writing configs and the different collaboration methods implemented.

Method Core Idea Code Sample Config Doc
API: Nudging one model guides the decoding of another link link link
API: Prompt Routing prompt an LM to decide which model to use based on model descriptions link link link
API: Switch Generation multiple LMs take turns to generate parts of the response link link link
API: Trained Router train an LM to route based on the dev set link link link
API: Graph Routing train a graph neural network for routing link link link
API: Cascade use multiple models in a cascade to improve efficiency link link link
API: Mentor Collab a mentor model guides a smaller student model for generation link link link
API: Co-LLM train LMs to defer to another model when uncertain link link link
Text: Multiagent Refine multiple LMs refine each other's answers iteratively link link link
Text: Mixture of Agents all LMs propose candidates; dev-best LM aggregates into a final answer link link link
Text: Multiagent Feedback multiple LMs provide feedback to each other's answers link link link
Text: Knowledge Card models generate knowledge paragraphs to assist each other link link link
Text: LLM Blender use ranker and fuser LMs to combine multiple answers link link link
Text: Heterogeneous Swarms optimize a graph of multiple LLMs for collaboration link link link
Text: Majority Vote majority vote link link link
Text: Structured Interaction execute a structured interaction protocol among LLMs link link link
Text: Multiagent Finetuning multiple LLMs critique, debate, and refine via finetuning link link link
Text: BBMAS blackboard-based collaboration among LLMs link link link
Text: Sparta Alignment models compete and combat for collective alignment link link link
Text: Stackelberg Alignment extension of Sparta with adversarial instruction selection link link link
Text: SLM-Mux Orchestraing small models link link link
Text: AggLM RL to train a solution aggregation model link link link
Logit: Logit Fusion merge the next-token logits from multiple models link link link
Logit: Logit Contrastive contrast the logits from best/worst models link link link
Weight: Greedy Soup iteratively consider adding each model's weights from best to worst link link link
Weight: Dare Ties the dare-ties model merging algorithm link link link
Weight: Model Swarms particle swarm optimization for models to search in the weight space link link link
Weight: LoraHub gradient-free optimization of lora combinations link link link
Weight: ExPO model weight extrapolation link link link

Please note that MoCo does not aim to be a reproducibility study: we adapt the core ideas behind related papers and employ what works flexibly.

Supported Data

MoCo comes with a lot of evaluation datasets built-in, and you are free to bring your own datasets, or even just generate responses only and take evaluation elsewhere. Essentially, change the task and task_type in the config to use diverse datasets. Check out link for more details.

Contributing to MoCo

We welcome contributions to MoCo!

If you are interested in contributing new model collaboration methods, check out link.

If you are interested in contributing new datasets, check out link.

If you have any suggestions, please open an issue.

MoCo-supported projects

Scaling participation in modular AI systems: diverse participants contribute small specialized models that collaborate together, outperforming monolithic LLMs. link

Safety of model collaboration systems: what if one of the models is malicious? link

The single-multi evolution loop: multiple LMs collaborate, distill the collaborative system back into each individual model, and repeat for multi-LLM self-evolution. link

Citation

If MoCo is helpful for you, please consider citing:

@inproceedings{feng2026one,
  title={When one llm drools, multi-llm collaboration rules},
  author={Feng, Shangbin and Ding, Wenxuan and Liu, Alisa and Wang, Zifeng and Shi, Weijia and Wang, Yike and Shen, Shannon Zejiang and Han, Xiaochuang and Lang, Hunter and Lee, Chen-Yu and others},
  booktitle={Proceedings of the 64th Annual Meeting of the Association for Computational Linguistics (Volume 1: Long Papers)},
  pages={17048--17063},
  year={2026}
}

@article{feng2026moco,
  title={MoCo: A One-Stop Shop for Model Collaboration Research},
  author={Feng, Shangbin and Bai, Yuyang and Yang, Ziyuan and Wang, Yike and Tan, Zhaoxuan and Yan, Jiajie and Lei, Zhenyu and Ding, Wenxuan and Shi, Weijia and Wang, Haojin and others},
  journal={arXiv preprint arXiv:2601.21257},
  year={2026}
}

Also, please cite the related papers for the methods you employed, as listed in docs/user_readme.md.

Have a nice day.

Release files for modelco 1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for modelco 1.1.1
File Size Uploaded
modelco-1.1.1.tar.gz 13.9 MB Details

Release files / modelco-1.1.1.tar.gz

Download URL modelco-1.1.1.tar.gz
Size 13.9 MB
Tags Source
SHA-256 checksum
How to use checksums
12784a928be6036528e53fc61e5740fe135086a4f40e5408a4784873dfe05dce
BLAKE2b-256 checksum
How to use checksums
9c755ba5ff8768cba286af33bf40beb2570d076df9153212cf41789bef937da6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.1

Release history Release notifications | RSS feed

This release

1.1.1 This release

1 release file

1.1.0

1 release file

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page