Make the build readable without downloading anything - #1
Merged
Conversation
The guide, the models and the photographs were all here; none of them rendered on GitHub. The manual was a PDF, the build photos were HEIC — which GitHub will not preview and Windows and Linux often will not open — and the STLs were twelve file names. - Documentation/assembly.md: the assembly guide as Markdown, figures inline, so it reads on the phone propped up next to the bench. The PDF stays as the printable version, and tools/extract_guide_figures.py cuts the figures out of it, so re-exporting the guide updates both. - assembly_photos: HEIC -> JPEG, 63 MB down to 13 MB. The originals stay in history if a full-resolution frame is ever wanted back. - Documentation/renders: every printed part rendered from its STL by tools/render_stl.py (numpy + Pillow, no CAD kernel), as a print set and as the four finger variants side by side. The base plate is rendered from its reverse face on purpose — the printed OpenRB-150 standoffs are the whole point of that part and the default three-quarter view hides them. - README: what the gripper is, what V2 changed, what to print, and where the software lives. The paper it descends from is in Documentation/paper and cited at the end. One thing to check: CAD/Base Top.stl and CAD/Base Bottom.stl are the same file, byte for byte, and it is the plate carrying the printed standoffs. Either V2 uses one plate twice — in which case the BOM, which prices them separately, and the guide, which says they are different sizes, are stale — or the second export never made it in. Flagged in the README rather than guessed at.
The models, the bill of materials and the assembly guide had no licence at all, which in a public repository means nobody may safely print from them — the opposite of what an open-hardware repo is for. Same MIT terms as correlllab/MAGPIE, so the gripper and the code that drives it are under one licence rather than two stories.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The guide, the models and the photographs were all here; none of them rendered on GitHub. The manual was a PDF, the build photos were HEIC — which GitHub will not preview and Windows and Linux often will not open — and the STLs were twelve file names.
What changed
Documentation/assembly.md— the assembly guide as Markdown with the figures inline, so it reads on a phone propped up next to the bench. The PDF stays as the printable version, andtools/extract_guide_figures.pycuts the figures out of it, so re-exporting the guide updates both rather than letting them drift.assembly_photos/HEIC → JPEG, 63 MB down to 13 MB. The originals stay in history if a full-resolution frame is ever wanted back.Documentation/renders/— every printed part rendered from its STL bytools/render_stl.py(numpy + Pillow, no CAD kernel): the V2 print set, and the four finger variants side by side. The base plate is rendered from its reverse face on purpose — the printed OpenRB-150 standoffs are the point of that part, and the default three-quarter view hides them.Documentation/paper/and cited at the end of the README (recompressed from 17 MB to 1.5 MB; arXiv has the original).One thing to check before merging
CAD/Base Top.stlandCAD/Base Bottom.stlare the same file, byte for byte, and it is the plate carrying the printed OpenRB-150 standoffs. Either V2 really does use one plate twice — in which case the BOM, which prices them separately, and the guide, which says they are different sizes, are stale — or the second export never made it in. Flagged in the README rather than guessed at.Two smaller fixes while transcribing the guide: "Repeat Steps 2 through 5" → steps 2 to 4 (step 5 is that step), and "replace is roughness develops" → "replace if".
Documentation/README.mdalso pointed at aHardware/folder that does not exist; the BOM lives inDocumentation/.🤖 Generated with Claude Code