Mark455 commited on
Commit
d2f3a03
·
verified ·
1 Parent(s): 602b8c1

Upload folder using huggingface_hub

Browse files
Files changed (2) hide show
  1. README.md +75 -0
  2. README_zh.md +75 -0
README.md CHANGED
@@ -18,6 +18,31 @@ tags:
18
 
19
  <p align="center"><a href="README.md">English</a> | <a href="README_zh.md">中文</a></p>
20
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
21
  ## 📥 Download
22
 
23
  | Checkpoint | Benchmarks |
@@ -37,3 +62,53 @@ uv run --frozen --all-extras --no-sync hf download Mark455/Copper-Policy \
37
  To download only one model, keep only its file path in the command.
38
 
39
  For installation and inference, see the [code repository](https://github.com/Mark4551124015/Copper-Policy).
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
18
 
19
  <p align="center"><a href="README.md">English</a> | <a href="README_zh.md">中文</a></p>
20
 
21
+ Official inference checkpoints for **Copper-Policy: Focus on the Representation for Robust Robot Manipulation**.
22
+
23
+ Copper-Policy combines a compact world representation with spatial visual features for robot manipulation. This release contains two approximately 2B-parameter policies.
24
+
25
+ [📄 Paper](https://arxiv.org/abs/2609.32779) · [🌐 Project Page](https://zexinfeng-cn.github.io/works/copper-policy/) · [💻 Code](https://github.com/Mark4551124015/Copper-Policy)
26
+
27
+ ## 📦 Included checkpoints
28
+
29
+ ```text
30
+ libero/
31
+ ├── policy.pt
32
+ └── policy.json
33
+ robotwin/
34
+ ├── policy.pt
35
+ └── policy.json
36
+ release_manifest.json
37
+ SHA256SUMS
38
+ LICENSE
39
+ ```
40
+
41
+ - **LIBERO:** one checkpoint shared by LIBERO and LIBERO-Plus; 2 RGB views, 7-dimensional actions and 8-dimensional proprioception.
42
+ - **RoboTwin:** one checkpoint shared by clean and randomized evaluations; 3 RGB views, 14-dimensional actions and proprioception.
43
+ - Both checkpoints predict an action horizon of **32**. Normalization statistics and the configuration needed for inference are included in `policy.pt`; no separate dataset-statistics file is required.
44
+ - `policy.json` describes each checkpoint; `SHA256SUMS` provides checksums. These custom PyTorch checkpoints are loaded using the Copper-Policy code repository.
45
+
46
  ## 📥 Download
47
 
48
  | Checkpoint | Benchmarks |
 
62
  To download only one model, keep only its file path in the command.
63
 
64
  For installation and inference, see the [code repository](https://github.com/Mark4551124015/Copper-Policy).
65
+
66
+ ## ⚙️ Inference
67
+
68
+ The code repository provides four evaluation launchers:
69
+
70
+ ```bash
71
+ uv run --frozen --all-extras --no-sync bash test_libero.sh --all-tasks
72
+ uv run --frozen --all-extras --no-sync bash test_libero_plus.sh --all-tasks
73
+ uv run --frozen --all-extras --no-sync bash test_robotwin_clean.sh --all-tasks
74
+ uv run --frozen --all-extras --no-sync bash test_robotwin_rand.sh --all-tasks
75
+ ```
76
+
77
+ Default inference uses **10 denoising steps**, with **10 replan steps for LIBERO / LIBERO-Plus** and **24 for RoboTwin**. Compilation and rollout videos are enabled. Download the V-JEPA 2.1, DINOv2 and Wan T5 encoder presets using `python -m tools.download_weights all --yes` through the repository's uv environment. No separate Wan transformer initialization weights are needed.
78
+
79
+ Follow the [code repository](https://github.com/Mark4551124015/Copper-Policy) for installation and simulator assets; adapt PyTorch/CUDA to your hardware and driver. **Training code — coming soon.**
80
+
81
+ <details>
82
+ <summary><b>Note: LIBERO language mapping</b></summary>
83
+
84
+ LIBERO training instructions sometimes differ from benchmark prompts. The code maps exact plaintext benchmark prompts to training instructions. LIBERO-Plus language perturbations are not mapped; unmatched prompts retain the benchmark text.
85
+
86
+ </details>
87
+
88
+ ## 📊 Reported results
89
+
90
+ | LIBERO | LIBERO-Plus | RoboTwin clean | RoboTwin randomized |
91
+ | :---: | :---: | :---: | :---: |
92
+ | 97.25% | 80.85% | 70.84% | 12.98% |
93
+
94
+ These are results reported in the [paper and project page](https://zexinfeng-cn.github.io/works/copper-policy/). Individual evaluation runs record their own measured scores.
95
+
96
+ ## 📚 Citation
97
+
98
+ ```bibtex
99
+ @misc{feng2026copperpolicyfocusrepresentationrobust,
100
+ title={Copper-Policy: Focus on the Representation for Robust Robot Manipulation},
101
+ author={Zexin Feng and Yixu Feng and Lingyu Xiao and Shang Su and Kexin Zheng and Chang Xu and Mengkai Shi and Shuo Feng and Xintao Yan},
102
+ year={2026},
103
+ eprint={2609.32779},
104
+ archivePrefix={arXiv},
105
+ primaryClass={cs.RO},
106
+ url={https://arxiv.org/abs/2609.32779}
107
+ }
108
+ ```
109
+
110
+ ## 🙏 Acknowledgements and license
111
+
112
+ Our implementation builds on [FastWAM](https://github.com/yuantianyuan01/FastWAM) and [LingBot-VA](https://github.com/robbyant/lingbot-va). Dataset conversion uses our [lerobot-tools](https://github.com/Mark4551124015/lerobot-tools). Codex helped organize the open-source code.
113
+
114
+ Released under [Apache 2.0](LICENSE). External encoders and simulator assets retain their respective licenses.
README_zh.md CHANGED
@@ -2,6 +2,31 @@
2
 
3
  <p align="center"><a href="README.md">English</a> | <a href="README_zh.md">中文</a></p>
4
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
5
  ## 📥 模型下载
6
 
7
  | 权重 | 测评环境 |
@@ -21,3 +46,53 @@ uv run --frozen --all-extras --no-sync hf download Mark455/Copper-Policy \
21
  只下载一个模型时,在命令中保留对应的文件路径即可。
22
 
23
  安装与推理说明见[代码仓库](https://github.com/Mark4551124015/Copper-Policy)。
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2
 
3
  <p align="center"><a href="README.md">English</a> | <a href="README_zh.md">中文</a></p>
4
 
5
+ **Copper-Policy: Focus on the Representation for Robust Robot Manipulation** 的官方推理权重。
6
+
7
+ Copper-Policy 将紧凑的世界表征与空间视觉特征结合,用于机器人操作。本仓库提供两份约 2B 参数的策略模型。
8
+
9
+ [📄 论文](https://arxiv.org/abs/2609.32779) · [🌐 项目主页](https://zexinfeng-cn.github.io/works/copper-policy/) · [💻 代码](https://github.com/Mark4551124015/Copper-Policy)
10
+
11
+ ## 📦 发布的模型
12
+
13
+ ```text
14
+ libero/
15
+ ├── policy.pt
16
+ └── policy.json
17
+ robotwin/
18
+ ├── policy.pt
19
+ └── policy.json
20
+ release_manifest.json
21
+ SHA256SUMS
22
+ LICENSE
23
+ ```
24
+
25
+ - **LIBERO:** LIBERO 与 LIBERO-Plus 共用一份权重;输入 2 个 RGB 视角,动作维度为 7,本体状态维度为 8。
26
+ - **RoboTwin:** clean 与 randomized 共用一份权重;输入 3 个 RGB 视角,动作及本体状态维度均为 14。
27
+ - 两份模型的动作预测长度均为 **32**。`policy.pt` 已包含归一化统计与推理所需配置,无需单独下载数据集统计文件。
28
+ - `policy.json` 提供模型信息,`SHA256SUMS` 提供校验值。这些自定义 PyTorch checkpoint 请使用 Copper-Policy 代码仓库加载。
29
+
30
  ## 📥 模型下载
31
 
32
  | 权重 | 测评环境 |
 
46
  只下载一个模型时,在命令中保留对应的文件路径即可。
47
 
48
  安装与推理说明见[代码仓库](https://github.com/Mark4551124015/Copper-Policy)。
49
+
50
+ ## ⚙️ 推理
51
+
52
+ 代码仓库提供四个测评入口:
53
+
54
+ ```bash
55
+ uv run --frozen --all-extras --no-sync bash test_libero.sh --all-tasks
56
+ uv run --frozen --all-extras --no-sync bash test_libero_plus.sh --all-tasks
57
+ uv run --frozen --all-extras --no-sync bash test_robotwin_clean.sh --all-tasks
58
+ uv run --frozen --all-extras --no-sync bash test_robotwin_rand.sh --all-tasks
59
+ ```
60
+
61
+ 默认使用 **10 个去噪步**;**LIBERO / LIBERO-Plus 的 replan steps 为 10**,**RoboTwin 为 24**。默认开启编译与视频保存。在仓库的 uv 环境中使用 `python -m tools.download_weights all --yes` 下载 V-JEPA 2.1、DINOv2 与 Wan T5 编码器预设。无需额外的 Wan transformer 初始化权重。
62
+
63
+ 安装与模拟器资源请参考[代码仓库](https://github.com/Mark4551124015/Copper-Policy),按自己的硬件和驱动适配 PyTorch/CUDA。**训练代码 coming soon。**
64
+
65
+ <details>
66
+ <summary><b>Note:LIBERO 语言映射</b></summary>
67
+
68
+ LIBERO 训练数据的指令有时与 benchmark 提供的文本不同。代码通过明文到明文的精确查表映射回训练指令。LIBERO-Plus 的 language 扰动不做映射;找不到映射时保留 benchmark 原始文本。
69
+
70
+ </details>
71
+
72
+ ## 📊 论文报告结果
73
+
74
+ | LIBERO | LIBERO-Plus | RoboTwin clean | RoboTwin randomized |
75
+ | :---: | :---: | :---: | :---: |
76
+ | 97.25% | 80.85% | 70.84% | 12.98% |
77
+
78
+ 以上为[论文与项目主页](https://zexinfeng-cn.github.io/works/copper-policy/)报告的结果,每次测评会记录该次实际运行的分数。
79
+
80
+ ## 📚 引用
81
+
82
+ ```bibtex
83
+ @misc{feng2026copperpolicyfocusrepresentationrobust,
84
+ title={Copper-Policy: Focus on the Representation for Robust Robot Manipulation},
85
+ author={Zexin Feng and Yixu Feng and Lingyu Xiao and Shang Su and Kexin Zheng and Chang Xu and Mengkai Shi and Shuo Feng and Xintao Yan},
86
+ year={2026},
87
+ eprint={2609.32779},
88
+ archivePrefix={arXiv},
89
+ primaryClass={cs.RO},
90
+ url={https://arxiv.org/abs/2609.32779}
91
+ }
92
+ ```
93
+
94
+ ## 🙏 致谢与许可证
95
+
96
+ 实现基于 [FastWAM](https://github.com/yuantianyuan01/FastWAM) 与 [LingBot-VA](https://github.com/robbyant/lingbot-va)。数据转换使用我们自己的 [lerobot-tools](https://github.com/Mark4551124015/lerobot-tools)。Codex 协助整理了开源代码。
97
+
98
+ 权重以 [Apache 2.0](LICENSE) 发布,外部编码器和模拟器资源遵循各自的许可证。