Skip to content

Latest commit

 

History

History
84 lines (58 loc) · 2.36 KB

File metadata and controls

84 lines (58 loc) · 2.36 KB

ModSSC logo

ModSSC

Modular framework for semi-supervised classification across heterogeneous data (text, vision, tabular, audio, graph).

Main repository · Documentation · Paper (arXiv) · Paper (HAL)

What ModSSC is for

ModSSC targets research workflows where you need a single, reproducible pipeline to compare semi-supervised methods fairly.

Core ideas:

  • Composable bricks: dataset loaders, sampling, preprocessing, graph construction, SSL methods, evaluation.
  • Inductive and transductive settings share the same mental model and CLI surface.
  • Reproducibility by design: declarative YAML experiments, deterministic seeds, fingerprinted caches, audit-friendly run folders.
  • Extensibility: registries let you add datasets, samplers, preprocess steps, graph specs, and methods without rewriting the runner.

Current status: 0.0.1 (expect API changes until 1.0).

Where to start

The project lives in the main repo:

Quick start from source:

git clone https://github.com/ModSSC/ModSSC.git
cd ModSSC
python -m pip install -e ".[dev]"

Explore the CLI:

modssc --help
modssc-datasets list
modssc-preprocess steps list
modssc-graph specs list
modssc-inductive methods list
modssc-transductive methods list

Run end-to-end examples:

python examples/00_inductive_toy_self_training.py
python examples/01_transductive_toy_label_propagation.py

Benchmarks

The bench/ runner is part of the GitHub repository (not intended as a packaged dependency).

python -m bench.main --config bench/configs/experiments/toy_inductive.yaml
python -m bench.main --config bench/configs/experiments/toy_transductive.yaml

Contributing

Open issues and feature requests in the main repository:

This .github repository stores organization-wide community health files (issue templates, PR templates, policies).

Citation

If you use ModSSC in research, cite the project via CITATION.cff (and the paper linked above).

License

MIT.