Upload README.md with huggingface_hub

README.md

@@ -1,13 +1,49 @@
-# ConTSG Public Release (synth-u/synth-m only)
+---
+license: mit
+language:
+- en
+tags:
+- time-series
+- benchmark
+- conditional-generation
+datasets:
+- mldi-lab/ConTSG-Bench-Datasets
+---
 
-This folder is prepared from consolidated_target_datasets2 without modifying source files.
+# ConTSG-Bench Checkpoints (Public Subset)
 
-Contents:
-- experiments/<model>/<dataset>/<seed>/checkpoints/finetune/best.ckpt
-- experiments/.../config.template.yaml (sanitized placeholders)
-- expected/full_results_synth.csv, expected/results_mean_std_synth.csv
-- resources/cttp/{synth-u,synth-m}/clip_model_best.pth + model_configs.yaml
-- manifests/checkpoints_manifest.csv, manifests/release_manifest.json
+This repository hosts the official public checkpoint release for **ConTSG-Bench**.
 
+## Release Scope
 
-Public package note: internal source path manifests are intentionally excluded.
+The current public release includes checkpoints and reproducibility assets for:
+
+- `synth-u`
+- `synth-m`
+
+Checkpoints for other benchmark datasets are **not** publicly released at this stage.
+
+## Repository Structure
+
+- `experiments/<model>/{synth-u|synth-m}/seed{0,1,2}/checkpoints/finetune/best.ckpt`
+- `experiments/<model>/{synth-u|synth-m}/seed{0,1,2}/config.template.yaml`
+- `experiments/<model>/{synth-u|synth-m}/seed{0,1,2}/results/expected_seed_metrics.json`
+- `experiments/<model>/{synth-u|synth-m}/seed{0,1,2}/summary.json`
+- `resources/cttp/{synth-u,synth-m}/clip_model_best.pth`
+- `resources/cttp/{synth-u,synth-m}/model_configs.yaml`
+- `expected/full_results_synth.csv`
+- `expected/results_mean_std_synth.csv`
+- `expected/seed_metrics_nested.json`
+- `manifests/release_manifest_public.json`
+
+## Reproducibility Notes
+
+- This release is designed to support leaderboard reproducibility for the public subset.
+- Some config templates contain placeholders (for example `${LONGCLIP_ROOT}`) that should be set to your local dependency path before running.
+- For submission format and one-click reproduction template, see the main project repository:
+  - https://github.com/seqml/ConTSG-Bench
+
+## Related Links
+
+- Dataset repository: https://huggingface.co/datasets/mldi-lab/ConTSG-Bench-Datasets
+- Leaderboard Space: https://huggingface.co/spaces/mldi-lab/ConTSG-Bench-Leaderboard