lmc-code / README.md
khanhvinh9's picture
Upload folder using huggingface_hub
a20151e verified
|
Raw
History Blame Contribute Delete
2.95 kB

On Linear Mode Connectivity of Mixture-of-Experts Architectures

Documentation Paper

This repository accompanies the paper: β€œOn Linear Mode Connectivity of Mixture-of-Experts Architectures” (Neurips 2025 Submission)

ImageNet: Linear Mode Connectivity

Installation

git clone https://github.com/repo/lmc-moe.git
cd moe-lmc
pip install -e .
pip install -r requirements.txt

Repository Structure

src/
β”œβ”€β”€ agnews/               # Appendix experiment: Reinit FFN
β”œβ”€β”€ cifar10/              # Main experiment
β”œβ”€β”€ cifar100/             # Main experiment
β”œβ”€β”€ dbpedia/              # Appendix experiment: Reinit FFN
β”œβ”€β”€ enwik8/               # Appendix experiment: Reinit FFN
β”œβ”€β”€ imagenet/             # Main experiment
β”œβ”€β”€ imdbreview/           # Appendix experiment: Reinit FFN
β”œβ”€β”€ lm1b/                 # Main experiment
β”œβ”€β”€ mnist/                # Main experiment
β”œβ”€β”€ penn/                 # Appendix experiment: Reinit FFN 
β”œβ”€β”€ transfer_learning/    # Main experiment
β”œβ”€β”€ wikitext103/          # Main experiment
β”œβ”€β”€ datasets.py
β”œβ”€β”€ utils.py
β”œβ”€β”€ weight_matching.py
└── online_stats.py

Each dataset directory includes a standalone README.md with detailed steps for data preparation, training, and evaluation.

Linear Mode Connectivity Results

ImageNet, WikiText103, One Billion Word (lm1b)

WikiText103: Linear Mode Connectivity

One Billion Word (LM1B): Linear Mode Connectivity

Getting Started

Each dataset experiment can be run individually. See the corresponding src/<dataset>/README.md for configuration options.

Citation

If you find this work helpful, please consider citing:

@article{our2025moelmc,
  title={On Linear Mode Connectivity of Mixture-of-Experts Architectures},
  author={Coauthors},
  journal={arXiv:XXXX.XXXXX},
  year={2025}
}

Acknowledgements

We thank contributors and maintainers of open-source libraries including PyTorch, JAX, Flax, and HuggingFace Transformers. Special thanks to the authors of recent works on LMC and MoE architectures for foundational insights.

Contributing

We welcome pull requests and suggestions. Please ensure new features or bug fixes include tests where appropriate and follow existing code style.

License

This project is licensed under the MIT License.