Skip to content

Commit 13ef5f6

Browse files
committed
added finetune tutorial html file
1 parent 577f341 commit 13ef5f6

17 files changed

Lines changed: 530 additions & 17 deletions
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
_site/
2+
.jekyll-cache/
3+
.sass-cache/
4+
.bundle/
5+
.gems/
6+
.home/
7+
.gem-spec-cache/
8+
vendor/

docs/droid-openpi-pipeline/Gemfile

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
source "https://rubygems.org"
2+
3+
gem "jekyll", "~> 4.3.3"
4+
gem "just-the-docs", "0.7.0"
5+
gem "webrick", "~> 1.8"
Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
GEM
2+
remote: https://rubygems.org/
3+
specs:
4+
addressable (2.9.0)
5+
public_suffix (>= 2.0.2, < 8.0)
6+
colorator (1.1.0)
7+
concurrent-ruby (1.3.6)
8+
em-websocket (0.5.3)
9+
eventmachine (>= 0.12.9)
10+
http_parser.rb (~> 0)
11+
eventmachine (1.2.7)
12+
ffi (1.17.4)
13+
ffi (1.17.4-arm64-darwin)
14+
ffi (1.17.4-x86_64-darwin)
15+
forwardable-extended (2.6.0)
16+
google-protobuf (3.25.8)
17+
google-protobuf (3.25.8-arm64-darwin)
18+
google-protobuf (3.25.8-x86_64-darwin)
19+
google-protobuf (3.25.8-x86_64-linux)
20+
http_parser.rb (0.8.1)
21+
i18n (1.14.8)
22+
concurrent-ruby (~> 1.0)
23+
jekyll (4.3.4)
24+
addressable (~> 2.4)
25+
colorator (~> 1.0)
26+
em-websocket (~> 0.5)
27+
i18n (~> 1.0)
28+
jekyll-sass-converter (>= 2.0, < 4.0)
29+
jekyll-watch (~> 2.0)
30+
kramdown (~> 2.3, >= 2.3.1)
31+
kramdown-parser-gfm (~> 1.0)
32+
liquid (~> 4.0)
33+
mercenary (>= 0.3.6, < 0.5)
34+
pathutil (~> 0.9)
35+
rouge (>= 3.0, < 5.0)
36+
safe_yaml (~> 1.0)
37+
terminal-table (>= 1.8, < 4.0)
38+
webrick (~> 1.7)
39+
jekyll-include-cache (0.2.1)
40+
jekyll (>= 3.7, < 5.0)
41+
jekyll-sass-converter (3.0.0)
42+
sass-embedded (~> 1.54)
43+
jekyll-seo-tag (2.9.0)
44+
jekyll (>= 3.8, < 5.0)
45+
jekyll-watch (2.2.1)
46+
listen (~> 3.0)
47+
just-the-docs (0.7.0)
48+
jekyll (>= 3.8.5)
49+
jekyll-include-cache
50+
jekyll-seo-tag (>= 2.0)
51+
rake (>= 12.3.1)
52+
kramdown (2.5.2)
53+
rexml (>= 3.4.4)
54+
kramdown-parser-gfm (1.1.0)
55+
kramdown (~> 2.0)
56+
liquid (4.0.4)
57+
listen (3.10.0)
58+
logger
59+
rb-fsevent (~> 0.10, >= 0.10.3)
60+
rb-inotify (~> 0.9, >= 0.9.10)
61+
logger (1.7.0)
62+
mercenary (0.4.0)
63+
pathutil (0.16.2)
64+
forwardable-extended (~> 2.6)
65+
public_suffix (6.0.2)
66+
rake (13.4.2)
67+
rb-fsevent (0.11.2)
68+
rb-inotify (0.11.1)
69+
ffi (~> 1.0)
70+
rexml (3.4.4)
71+
rouge (4.7.0)
72+
safe_yaml (1.0.5)
73+
sass-embedded (1.69.5)
74+
google-protobuf (~> 3.23)
75+
rake (>= 13.0.0)
76+
sass-embedded (1.69.5-arm64-darwin)
77+
google-protobuf (~> 3.23)
78+
sass-embedded (1.69.5-x86_64-darwin)
79+
google-protobuf (~> 3.23)
80+
terminal-table (3.0.2)
81+
unicode-display_width (>= 1.1.1, < 3)
82+
unicode-display_width (2.6.0)
83+
webrick (1.9.2)
84+
85+
PLATFORMS
86+
arm64-darwin
87+
ruby
88+
x86_64-darwin
89+
x86_64-linux
90+
91+
DEPENDENCIES
92+
jekyll (~> 4.3.3)
93+
just-the-docs (= 0.7.0)
94+
webrick (~> 1.8)
95+
96+
BUNDLED WITH
97+
2.5.23
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# DROID/OpenPI Lab Pipeline Site
2+
3+
This directory is a standalone docs site.
4+
5+
Public GitHub Pages URL after the workflow is enabled:
6+
7+
```text
8+
https://wisc-hci.github.io/openpi/droid-openpi-pipeline/
9+
```
10+
11+
## Jekyll path
12+
13+
Use this when Ruby development headers are available:
14+
15+
```bash
16+
cd docs/droid-openpi-pipeline
17+
bundle install
18+
bundle exec jekyll serve --host 127.0.0.1 --port 4000
19+
```
20+
21+
Then open:
22+
23+
```text
24+
http://127.0.0.1:4000/droid-openpi-pipeline/
25+
```
26+
27+
## Local fallback path
28+
29+
Use this on machines where Ruby/Jekyll native gems cannot build:
30+
31+
```bash
32+
cd docs/droid-openpi-pipeline
33+
python3 preview.py --serve
34+
```
35+
36+
Then open:
37+
38+
```text
39+
http://127.0.0.1:4000/droid-openpi-pipeline/
40+
```
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
title: DROID/OpenPI Lab Pipeline
2+
description: Lab documentation for the DROID hardware, OpenPI policy server, CHTC fine-tuning, and real-robot deployment workflow.
3+
theme: just-the-docs
4+
5+
url: "http://127.0.0.1:4000"
6+
baseurl: "/droid-openpi-pipeline"
7+
8+
color_scheme: lab
9+
10+
aux_links:
11+
OpenPI Repository: https://github.com/Wisc-HCI/openpi
12+
DROID Repository: https://github.com/Wisc-HCI/droid
13+
14+
nav_external_links:
15+
- title: Official DROID Docs
16+
url: https://droid-dataset.github.io/droid/docs/
17+
hide_icon: false
18+
19+
search_enabled: true
20+
heading_anchors: true
21+
back_to_top: true
22+
back_to_top_text: Back to top
23+
24+
callouts:
25+
warning:
26+
title: Warning
27+
color: yellow
28+
note:
29+
title: Note
30+
color: blue
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
$body-background-color: $white;
2+
$sidebar-color: #f7f8fa;
3+
$body-text-color: #172033;
4+
$body-heading-color: #172033;
5+
$nav-child-link-color: #526176;
6+
$link-color: #2563eb;
7+
$btn-primary-color: #2563eb;
8+
$code-background-color: #eef2f6;
9+
$feedback-color: darken($sidebar-color, 3%);

docs/droid-openpi-pipeline/example-workflows/chtc-finetuning.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ layout: default
33
title: CHTC Fine-tuning
44
parent: Example Workflows
55
nav_order: 3
6+
permalink: /example-workflows/chtc-finetuning/
67
---
78

89
# CHTC Fine-tuning
@@ -101,4 +102,3 @@ cd /home/kindred/Desktop/repo/openpi
101102
tar -xzf checkpoints.tar.gz
102103
find checkpoints -maxdepth 4 -type d | sort | tail
103104
```
104-

docs/droid-openpi-pipeline/example-workflows/dataset-conversion-and-upload.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ layout: default
33
title: Dataset Conversion and Upload
44
parent: Example Workflows
55
nav_order: 2
6+
permalink: /example-workflows/dataset-conversion-and-upload/
67
---
78

89
# Dataset Conversion and Upload
@@ -52,4 +53,3 @@ hf upload Wisc-HCI/realsense_droid_pick \
5253
```
5354

5455
If you change the dataset repo id, update `repo_id` in `src/openpi/training/config.py` under `pi05_droid_finetune`.
55-

docs/droid-openpi-pipeline/example-workflows/example-workflows.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,18 @@ parent: DROID/OpenPI Lab Pipeline
55
nav_order: 4
66
has_children: true
77
has_toc: false
8+
permalink: /example-workflows/
89
---
910

1011
# Example Workflows
1112

1213
Use these workflows after hardware and software setup are complete.
1314

14-
1. [Teleoperation and Data Collection](./teleoperation-and-data-collection.md)
15-
2. [Dataset Conversion and Upload](./dataset-conversion-and-upload.md)
16-
3. [CHTC Fine-tuning](./chtc-finetuning.md)
17-
4. [Policy Deployment](./policy-deployment.md)
18-
5. [Troubleshooting](./troubleshooting.md)
15+
1. [Teleoperation and Data Collection]({{ site.baseurl }}/example-workflows/teleoperation-and-data-collection/)
16+
2. [Dataset Conversion and Upload]({{ site.baseurl }}/example-workflows/dataset-conversion-and-upload/)
17+
3. [CHTC Fine-tuning]({{ site.baseurl }}/example-workflows/chtc-finetuning/)
18+
4. [Policy Deployment]({{ site.baseurl }}/example-workflows/policy-deployment/)
19+
5. [Troubleshooting]({{ site.baseurl }}/example-workflows/troubleshooting/)
1920

2021
## Fast Path: Run Existing Policy Only
2122

@@ -25,4 +26,3 @@ If you do not need to collect data or fine-tune:
2526
2. Start the DROID low-level server on the NUC.
2627
3. Run `scripts/main.py` on the control laptop.
2728
4. Enter the natural-language instruction when prompted.
28-

docs/droid-openpi-pipeline/example-workflows/policy-deployment.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ layout: default
33
title: Policy Deployment
44
parent: Example Workflows
55
nav_order: 4
6+
permalink: /example-workflows/policy-deployment/
67
---
78

89
# Policy Deployment
@@ -79,4 +80,3 @@ python scripts/main.py \
7980
```
8081

8182
The script prompts for `Enter instruction:` and saves rollout results under `results/`.
82-

0 commit comments

Comments
 (0)