run.py

#!/usr/bin/env python
"""Launch the Particles simulator.

Usage:
    python run.py            # normal GUI
    python run.py --headless # no window (used for automated screenshots/tests)

Requires: numpy, pygame (numba optional but strongly recommended for speed).
"""
import argparse
import os
import sys


def main() -> int:
    parser = argparse.ArgumentParser(description="周期多类别粒子模拟器")
    parser.add_argument("--headless", action="store_true",
                        help="run without opening a window (dummy video driver)")
    args = parser.parse_args()

    if args.headless:
        os.environ["PARTICLES_HEADLESS"] = "1"
    from particles.app import main
    main()
    return 0


if __name__ == "__main__":
    sys.exit(main())