Assembly guide for Stringman
Cable-suspended household crane robot driven by four corner-mounted lines
License
- software: Apache 2.0
- hardware: CERN-OHL-W 2.0 (weakly reciprocal)
- pcb: no licence (all rights reserved)
- documentation: CC BY-SA 4.0
Split licensing. The firmware (nhnifong/cranebot3-firmware) is Apache-2.0. The hardware designs - CAD document, STL files, Print Guide and BOM - are CERN-OHL-W 2.0 with an addendum stating that the user assumes full responsibility for any injury, damage or loss resulting from installation or use. The PCB repository (nhnifong/stringman-pcbs) carries no licence file, so the KiCad projects and Gerbers are published without an open-source grant - all rights reserved by default. Checked 2026-08-07.
Assembly guide
1. Print the parts
About 80 hours of printing for a complete system. Defaults from the Print Guide apply unless a part says otherwise: PLA, 2 walls, 15% grid infill, one of each part, tree supports on the build plate only at 0.5 mm XY distance.
1.1 Set up the default print profile
Everything except the parts called out below prints on one profile.
- Material PLA, 2 walls, 15% grid infill, one of each part unless the part says otherwise.
- Tree supports, build plate only, 0.5 mm XY distance to part.
- Print the regular bearing block, the slip ring block and the sunglasses WITHOUT supports - these three are the exceptions.
- Do not use PET for any gear. Upstream's reason is blunt: it squeaks.
- Covers, faces, fingers, geared levers, linkages and parking hooks are visible on the finished robot, so choose those colours deliberately. Colour is irrelevant for everything else.
- The whole plate is also published as a Bambu 3MF project if you would rather not profile each part yourself.
1.2 Print the anchor parts
Two anchors, so most anchor parts are printed twice. The frame is the one part that must not be PLA.
- Cover 2x. It is visible, so choose a colour to match the walls or crown moulding. Print it on its bottom face, the only large flat face. Print guides up to 18 Oct 2026 listed a separate cover top and cover bottom instead: print the top cover upside down and glue the halves together with cyanoacrylate.
- Frame 2x in PCTG or PETG-CF - not PLA. This part needs strength and heat tolerance.
- Frame settings: 2 walls, 22% adaptive cubic, tree supports on the build plate only with critical regions only and 0.5 mm XY distance. A Bambu super cool tack plate is recommended.
- Regular bearing block 1x and slip ring block 1x, no supports, printed on the side face.
- Spool A Power 1x, Spool A Regular 3x, Spool B 4x. Use tree supports for the recessed holes and glue each A to a B to make a complete spool.
- Stud mount 2x: 5 wall thickness and 30% cubic infill. It may be visible if you take the anchors down, so white PET-GF15 is a great choice. It can be converted for tripod use by adding a 1/4 inch coarse thread insert to the hole at the bottom. The earlier print guide gave 3 wall thickness and 100% infill.
- Sunglasses 2x, no supports, 4 wall thickness and 30% cubic infill. Externally visible, so use the same white PLA as the anchor cover.
- Tilt adapter 2x, PLA in any colour, very fine details at 0.16 mm layers. The earlier print guide listed fixed adapters of 22, 26 and 30 degrees, one of each: the angle is the camera centreline tilt below the horizon, higher for high ceilings and lower for low ones.
- Odd spacer 2, 2x, default settings. One for each anchor: it gives back support to the barrel jack.
1.3 Print the eyelet parts
Two eyelets carry the far ends of two of the four lines.
- Body stud mount: print it on the odd diagonal flag face, which is stronger than printing on the back. 100% infill, PET-GF15, matched to the wall colour.
- Eyelet vice block 1x: a jig for holding the eyelet so you can press the body, ring and retainer together with a drill press.
- Retainer: match the colour of the other eyelet part.
- The Anchor Build Guide has you create two eyelets, so print two bodies and two retainers.
1.4 Print the gripper parts
The drive gear is the part that decides whether the gripper works - it is the one print in the whole system with a non-standard nozzle temperature.
- Back plate, camera mount, mechanism lid and motor bracket: default settings, colour almost irrelevant, though small parts show through when the fingers open. The older two-part ABS pole needs a printed coupler, which the print guide no longer lists.
- Flat marker 1x: if multicolour is available use flat_marker_colored.3mf, otherwise print it in white and apply stickers. 2 walls, 15% grid infill. Also print the hang bar 1x in black PLA, an auxiliary part for the flat marker. The earlier design was a marker box (platform box), printed in white with stickers or in multicolour.
- Drive gear 1x: 100% infill, 3 walls. Common plastics are not strong enough for this part, and kits are shipped with a resin-printed gear. PCTG at a 265 degree C nozzle temperature, higher than usual for the filament, is the second best choice. PET squeaks, PLA breaks and PETG is too soft. Nylon and ABS are probably fine if you can print those.
- Face Back and Face Front: visible parts, choose the colour deliberately. Merge them in the slicer and print with their open faces towards each other so they share tree supports.
- Finger 2x, geared lever left and geared lever right: visible parts, otherwise default settings.
- Linkage 2x - it is part of the finger.
- Spacer 7x, default settings. Three are for the gripper and two for each anchor.
- Wrist pole helical gear, wrist removal block and wrist servo helical gear: default settings, colour irrelevant.
1.5 Print the extras
Parking hardware and the printed AprilTag cards used for calibration.
- Clip or alligator clip, 4x, default settings, white. The alligator version is an alternative that works on bigger things.
- Parking hook 1x and parking support bar 1x: visible parts, so match the wall colour. 2 walls, 11% cubic infill.
- all_cards.3mf: print with the Bambu multicolour profile. These are the calibration cards you lay on the floor later.
2. Build the anchors
Repeat this whole section twice, once per anchor. Upstream quotes 40 hours of printing and 1.5 hours of assembly per anchor. Kits bought from neufangled.com after 26 June 2026 need no soldering; self-sourced parts may.
2.1 Gather the tools
Both build guides open with the same short tool list.
- Mini screwdriver with a bit set, manual or electric.
- Cross-locking tweezers.
- Super glue - Loctite Super Glue Professional Liquid is the one upstream recommends.
- A bean bag is worth having: both guides suggest it for holding an assembly at any angle while driving screws.
2.2 Glue up the spools
A complete system needs three regular spools carrying fishing line and one powerline spool carrying cable.
- Each spool is two printed halves: glue side A to side B.
- Spool side A differs on the powerline spool - it has a wider centre hole. Keep that one separate.
2.3 Assemble the three regular spools
Straightforward: spool onto motor, then a bearing on the far side.
- Press the dry spool onto the motor until it is fully seated, then twist until the holes align.
- Secure with three M3x8 screws.
- Put an M4x12 screw through a 4x13x5 bearing followed by two M4 washers, then screw it into the 4 mm hole in the centre of the spool with a dab of superglue or loctite.
2.4 Assemble the powerline spool
This is the one that feeds 24 V to the gripper down a line that also winds, so a slip ring sits at its centre.
- Solder a JST ZH female plug housing onto the fixed end of the slip ring.
- Cut a 10 mm length of 10 mm diameter ABS tube with an imp pipe cutter. The kit includes this 1 cm tube.
- Glue the tube into the hole in powerline spool side A. A coin makes a good press.
- When dry, put a 3/8 x 7/8 stainless steel washer onto the tube, followed by a 10x15x4 bearing.
- Place the slip ring into the slip ring block and secure it with two M3x8 screws, each with an M4 washer, in two of the three accessible holes.
- Thread the rotating wire end about halfway through the tube in the spool, then out of the side of the spool through the wire hole. Do not cinch it down yet - leave room for the motor screws.
- Press the motor into the spool, align the holes and secure with three M3x8 screws.
- Now seat the slip ring fully against the side of the spool by gently pulling the wires through.
2.5 Build the anchor electronics
A Pi 3A+, the Stringman Anchor Hat and a Camera Module 3 on an adjustable tilt adapter, plus a fan. Earlier anchors used a Pi Zero 2W; see the last lines of this step.
- Assemble a Raspberry Pi 3A+ with a Stringman-imaged SD card and a single heat sink on the Broadcom chip. The 3A+ image is different from the Zero 2W image.
- Press a Stringman Anchor Hat onto the Pi.
- Put cylindrical spacers in the corners between the two boards and insert two M2.5x18 screws in the holes at the corners, through the hat, spacers and Pi.
- Under the barrel jack, wedge an odd spacer 2. It looks like a single-peg Lego piece and supports the barrel jack, so it cannot bend the hat down when you push a plug into it.
- Carefully unpack a Camera Module 3 standard FOV. Leave the white (full-size) ribbon cable attached.
- With the camera face down on something soft, to protect its autofocus mechanism, screw it into the adjustable tilt adapter as shown, using M2x4 screws on all four corners.
- Insert the other end of the ribbon cable into the Pi's camera ribbon connector, the one near the centre of the board, as pictured. The cable has excess length, so tuck an extra fold of it under the hat.
- Screw the Pi into the electronics box on the bottom of the frame, first with the two M2.5x18 screws and then with two M2.5x6 screws in the remaining holes. The camera should hang out of the window at the front.
- Flip the camera over and wedge it between the two protrusions on the frame. Insert the toothed arm into the corresponding slot on the frame. Align the screw holes on each side and screw two M2.5x6 screws into the sides of the adapter to secure it to the frame.
- Install a 4-wire 3007 PWM fan, blowing out, in the slot in the back of the frame. Feed the wire through, plug it into the matching port on the hat, then secure it with two M3x8 screws in opposite corners.
- Anchors built to the earlier guide (up to the 19 Oct 2026 capture) used a Raspberry Pi Zero 2W with a heat sink and the Zero 2W image. For those, the guide said: if the Pi has no header pins, solder a full set; unpack the camera and remove whatever ribbon cable came attached; fit a 4 cm mini ribbon cable on the camera with the gold pads facing down towards the board and attach the smaller end to the Pi; press the hat on; put spacers in the corners and insert four M2.5x18 screws; screw the Pi into the conical standoffs in the electronics box.
- In that earlier version the camera was fitted to a fixed printed camera angle mount, front right when looking at the lens with the ribbon connector on top, of 22, 26 or 30 degrees of downward pitch from horizontal, chosen to keep the floor well centred. It could be changed later, but the config then had to be told the new pitch. The mount went on the frame with one M2.5x6 screw, and its small protrusion set the final angle and fitted only one way.
2.6 Mount the motors in the frame
Lower spool first. Both motors are screwed from the outside of the frame.
- Flip the frame right side up. Insert the plug downwards through the rectangular hole on the lower spool side.
- Avoid cross-threading the motor screws: first rotate them backwards to make sure you are engaged with the metal and not just the plastic.
- The bearing block may have to be pushed away from the spool. It should not touch the spool. If it does, pry it back by 2 mm with a flat object. The spool should spin freely.
- Align the motor shaft so the gap points down and the flat sides are vertical, then slide it into the slot, pulling the wire through as you go.
- Seat it firmly in the slot and in the bearing cup on the other side. Spin it and confirm it is not crooked.
- Secure the motor from the outside of the frame with three M3x8 screws.
- If the higher spool is a regular spool, print the variant of the slip ring block made for regular spools and press it onto the bearing protruding from the spool.
- If the higher spool is the powerline spool, it already has a bearing block: cinch the wire down firmly by pulling it through until the slip ring cannot get any closer to the spool.
- Thread the plug, align the shaft, align the bearing block on the far side, then secure the motor with three M3x8 screws from the outside and the bearing block with two M3x8 screws.
- Secure the sunglasses to the top of the frame with four M3x8 screws.
2.7 Wind the fishing-line spools
Winding is scripted, not manual: qa-anchor-arp sets the motor IDs, winds the right length per spool type and checks the camera.
- Power on the anchor and connect it to the network by wifi or an ethernet adapter.
- SSH in with ssh pi@<hostname or ip>; the password on the stock Stringman image is Fo0bar!!.
- Update first: /opt/robot/env/bin/pip install --upgrade "nf_robot[pi]".
- Run /opt/robot/env/bin/qa-anchor-arp and follow the prompts.
- It asks you to plug in one motor at a time and power cycle them, which you do by pulling and replugging the motor plugs from the hat, not the barrel jack. If you lose the connection, log back in and rerun the script: it picks up where it left off. The earlier guide, for Pi Zero 2W anchors, said to pull and replug the barrel jack.
- Before winding a fishing line spool, tie the end of the line to the small tie-off point on the spool with a buntline hitch.
- Hold the supply spool loosely in a clear space. Winding is fast - do not grip it.
- Answer y at the prompt for each spool you are ready to wind, or n to skip it for now.
- When winding finishes, feed the line end out of the sunglasses from back to front and tie a carabiner on with a palomar knot. If you have both colours, tie silver on the left side and black on the right side.
2.8 Wind and splice the powerline spool
The one step where a mistake costs you the cable: the knot must take the load, not the splice.
- If you received a pre-cut length of cable, thread one carabiner onto the bare end now, through the carabiner's small hole, and send it all the way down to the JST plug end - you need it there later.
- Feed the bare end of the cable into the front of the sunglasses, pull plenty of slack through, then feed it through the spool's tie-off hole from the back of the anchor to the front.
- Pull more slack through the tie-off hole and tie a simple square knot. Do not cinch it tight yet.
- Rotate the spool forwards and trim the slip ring wires so they wrap about two thirds of the way around the spool without reaching the tie-off point. This length matters.
- Splice the grey power line to the slip ring wires using solder and heat shrink: brown to red, blue to black. Upstream says the strongest splice is made by hooking the exposed wire at the end of each line to its partner, squeezing it tight, soldering it and covering it in heat shrink. The earlier guide used a pair of solder-seal connectors instead, with the heat shrink tube put on first.
- Strip the cable jacket with 18 AWG jaws and the cores with 28 AWG on a smaller stripper.
- Take up the slack in the square knot until the covered splice sits at the base of the spool, but not so far that the splice carries any weight - the knot should take the load if it comes to that.
- Answer y to the upper spool in the script and press Enter to wind.
- Tie the pre-threaded carabiner onto the end with a buntline hitch, so the knot takes the weight and the splice at the end is protected from mechanical stress.
2.9 Finish the anchor and build the eyelets
Two eyelets carry the far ends of two lines; they are the simplest printed assembly in the system.
- The script prompts you to measure the friction of the motors. Before answering yes, pull out 30 cm of slack between the carabiner and the hole and let the lines hang free, then run the friction measurement. Finally the script prompts for a camera feed test and then completes. Power off the anchor by running sudo shutdown now and pulling the power when the light goes off. The earlier guide said simply to pull the power.
- Make sure the black motor cables are tucked away properly in the cavity under the anchor.
- For each eyelet, press a size 20 Alconite ring into the ring slot.
- Put a drop of superglue into the remaining space and press the retainer on with a coin and something to squeeze it with, such as a drill press or vice. The strongest way is a press: set the eyelet body into the printed eyelet vice block so the little arrow sits in the corresponding slot, which makes the ring parallel with the jig's back face, and stack body, glue, ring, glue, retainer, coin. Press the whole stack tight and remove the coin before it sticks. The earlier guide used a coin and a pair of pliers.
- Build two. Then repeat this whole section for the second anchor.
3. Build the gripper
One gripper per robot. Upstream quotes 20 hours of printing and 2 hours of assembly. The recurring instruction throughout is to tighten a nylock nut until the slack is gone and then back it off until the joint swings freely.
3.1 Gather the extra tools
The gripper needs everything the anchor did, plus two cutting tools.
- Mini screwdriver with a bit set, cross-locking tweezers and super glue, as for the anchors.
- An exacto or hobby knife for trimming grip tape.
- Flush-cut wire clippers for the pressure sensor connector.
3.2 Assemble the fingers
There is no left and right finger - forks and finger pads are symmetrical.
- Attach a fork to the back of a finger pad and insert an M3x25 bolt through the upper hole, through both parts, with an M3 lock nut on the other side.
- Tighten the nylock nut until no slack remains, then back it off until the rod can swing. Repeat for the other finger.
- Slide a geared lever into the finger assembly with its flat face coplanar with the finger's flat face.
- Insert an M3x25 bolt through the assembly with an M3 lock nut on the other side, tighten, then back off just until the mechanism moves freely. Repeat with the other finger.
3.3 Fit the pressure sensor
One finger senses contact force. In a build kit this part arrives pre-assembled.
- Locate the pressure sense connector: a 2-pin 1.00 mm pitch male JST-SH with 20 cm wire ends.
- Slide heat shrink onto the wires and solder them to the force-sensing resistor. Polarity is irrelevant.
- Clip the wings off the JST-SH connector with flush cutters so it fits the channel.
- Select the finger with a wire channel inside it, feed the plug through the channel, then stick the resistor pad onto the finger.
3.4 Apply the grip tape
Fingerboard grip tape is what actually holds objects. Four strips, two per finger.
- Prepare at least four strips of 110x37 mm fingerboard grip tape.
- Lay the finger face up with the finger pad and gear lever flat faces coplanar, using the linkage as support.
- Stick one pad lengthwise starting at the top edge nearest the gear; about 10 mm will overhang the far end - fold it over the edge.
- Press the finger flat against a desk so the foam sticks down everywhere.
- Stick a second sheet perpendicular over the fingertip, folding 10 mm around each side.
- Trim the excess with a hobby knife.
- Flip the finger face up and cut the foam right down the crack where the two finger pieces slide past each other, then flex the joint to check nothing lifts.
- Repeat with the other finger.
3.5 Prepare the servos and drive gear
Two STS3215 smart servos: one drives the fingers, one drives the wrist.
- Attach the aluminium servo horns to both motors with the included M3x6 centre screw - use the horn with the ridges inside.
- Snap two of the M3x6 screws that come with the motor into the finger drive gear from the sides.
- Screw the drive gear down tightly to the aluminium servo horn of one motor.
- Kits ship the drive gear printed in resin. If you print it yourself, PCTG at a 265 degree C nozzle temperature is the second best choice and PLA breaks.
- Plug a three-wire SPOX cable into each motor - the one that comes in the box with it.
3.6 Assemble the gripper body
The geared levers must stay meshed the whole time they go together. A rubber band is a legitimate third hand here.
- Tear the ears off the mechanism lid print and clean up where the sacrificial bridge was, using a sharp tool.
- Attach the finger motor to the outside of the mechanism lid with four of the smallest screws included with the motors.
- Insert two M3x25 bolts into the back plate from the bottom, hold them in as you set it down, and place two M3 washers onto them.
- Mesh the two geared levers together in the closed position, checking the alignment. They must stay meshed - use a rubber band if necessary.
- Feed the pressure sense plug through the smile-shaped slot in the back plate, then place both fingers onto the bolts simultaneously, keeping them meshed and keeping the sense wire from being pinched.
- Place an M3 washer over each bolt where it protrudes from the hole in the geared lever.
- Stop the M3x25 bolts coming out of the back during the next part by taping them down or holding them in with your fingers. Then lower the mechanism lid and finger motor assembly onto the back plate, wiggling gently: the two M3x25 bolts pass through the lid and the drive gear meshes with the finger gears. The alignment tabs on the sides should line up. If it will not go, pull the bolts back into the fingers, mesh the gears first, then push the bolts through.
- Insert two M3 lock nuts into the hexagonal pockets, tighten the bolts from behind, then back off enough that the geared levers move freely. If you taped the bolts in, force your tool through the tape rather than fighting to take it off first.
- Screw a single M4x12 into the centre hole in the back plate - it stabilises the finger drive gear.
- Secure the lid around the edges with four M3x8 screws.
- Swing the two fork-shaped linkages up into their slots and secure them on the mechanism lid side with two M3x14 screws. The back side is fastened later.
3.7 Fit the gripper electronics
Pi Zero 2W, Stringman Gripper Hat and the wide-angle camera. Only three of the four corners take screws.
- Select a Pi Zero 2W, either the version with the full header, or a headerless one with pins soldered to the first six positions of each row. If the Pi does not have header pins, solder on a full set. Upstream links a printable soldering jig on MakerWorld if you want one.
- Stick a heat sink onto both the black chip (the SOC) and the silver one (the radio box). Flip the board over and stick two more heat sinks on the bottom, under the chips. Then press the Stringman Gripper Hat onto the Pi.
- Unpack the 64 cm cable with male JST ZH plugs at both ends. Thread it through the hole at the top of the gripper until it comes out of the body near the Pi. Plug it into the socket marked 24v/GND on the Gripper Hat, and stuff a loop of about 10 cm of slack from this wire into the other wires. This makes it the right length for the pole added later.
- Insert spacers between the boards and M2.5x16 screws through boards and spacers, in three corners only - the ribbon cable runs through the fourth.
- Unpack a wide-angle Camera Module 3 and install an 8 cm mini ribbon cable, wide end into the camera.
- Gently pull out both sides of the black retaining clip on the Pi's ribbon connector, insert the cable black side up under the clip, then push the clip back in. If the clip falls out, refit it one side at a time with tweezers.
- Screw the camera to the camera mount with two M2x4 bolts in opposite corners, fold the ribbon as pictured upstream, then screw the board stack onto the mount in the three corners that take screws.
- Open the gripper fingers and attach the camera mount assembly to the back plate with an M3x6 countersunk screw.
- Drive two M3x14 screws into the holes that both hold the electronics mount and secure the forks on the side left unfastened earlier.
- Plug the pressure sense lead into the Gripper Hat's socket marked pressure.
- Image an SD card per the Raspberry Pi Setup guide and insert it.
3.8 Fit the laser rangefinder
A VL53L1 time-of-flight sensor looks down past the fingers.
- If you sourced the rangefinder yourself, solder the straight header - all six pins, or just the four labelled VIN, GND, SCL and SDA.
- Plug the 4-pin rectangular dupont plug into the rangefinder with red on the outer edge.
- Feed the 4-wire rangefinder cable through the hole in the frame edge.
- Plug it into its socket on the short edge of the Gripper Hat.
- Screw the rangefinder into its seat with two M2x4 screws.
3.9 Fit the wrist motor
The second STS3215 turns the whole gripper under the pole through a helical gear pair.
- Attach a bracket to the remaining motor in the orientation shown upstream, using four of the small tapping screws from the motor box.
- Attach the three-holed helical wrist drive gear to the motor horn with two of the M3x6 screws that come with the servo.
- Attach the motor bracket to the gripper with two M3x8 screws.
- Plug the finger motor into the motor port on the Gripper Hat. Leave the wrist motor unconnected for now: both servos ship with ID 1, so they have to be plugged in one at a time to set their IDs.
3.10 Fit the fan
Fit a 30 mm fan to the gripper and plug it into the FAN connector on the Gripper Hat.
- Install a 30 mm fan, blowing inwards towards the Pi, using two M3x10 screws at the bottom. The earlier guide fitted it to the mechanism lid with two M3x8 screws in opposite corners, with the airflow pointing outwards.
- Plug the fan into the 4-pin JST-SH connector labelled FAN on the Gripper Hat. There are two 4-pin JST-SH connectors: FAN is on the long edge of the board and the other is for the rangefinder. The earlier guide said the 5 V socket labelled FAN.
3.11 Build the marker box and pole
The marker is passive: it carries AprilTags at the point where the four lines meet. Older documentation calls it the gantry. Kits bought from Neufangled before 8 August 2026 have a 50 cm ABS pole cut in two and, in earlier versions, a marker box: the last lines of this step cover them.
- The marker connects to the gripper by a 27 cm carbon fibre tube, 10 mm in diameter. It can be cut to length with a hacksaw or chop saw, slowly. Do not breathe the dust.
- Put a 10x15x4 bearing onto the tube, followed by a 3/8 x 7/8 stainless steel washer.
- Push and twist the helical gear onto the tube until about 2 cm of tube is protruding. This is not the final position; it only leaves space.
- Print the marker in multicolour for a more durable result, using flat_marker_colored.3mf from the multicolour prints for Bambu in the STL download, or print it in white PLA and add stickers. Print the hang bar in black PLA.
- For stickers, print the marker images on sticker paper without margins and cut the sheet along the two grey lines to make two rectangular stickers of two tags each. The sticker for this part is the one named gantry.
- Score a triangle in a corner on the back of each sticker. This makes the backing easier to remove.
- Place each sticker so that it straddles one corner and a marker ends up on each face. Note the orientation: the stem of the tree is at the bottom.
- Prepare JB-Weld PlasticWeld epoxy, a paper plate, a mixing stick, the pole with the gear in place, the marker, the hang bar and a measuring device set to 5 mm. Mix a small batch of epoxy according to its instructions.
- Apply epoxy to the carbon tube below the gear. Slide the gear down until 5 mm of tube remains. Place the last steel washer onto the end and stick it to the epoxy that squeezed out. Clean off excess epoxy.
- Apply epoxy to the top 3 cm of the other end of the tube. Push it into the hole at the bottom of the marker until it is fully seated. Clean off excess epoxy.
- Insert the hang bar, rounded corners facing down, into the opening in the marker as shown. Push it almost all the way in, apply some epoxy at the joint, then push it all the way in.
- Allow these glue joints to cure for 24 hours.
- Feed the power supply plug from the gripper up through the pole until it comes out the top. If it gets hung up inside the tube, twist the tube back and forth. Seat the gear and bearing into the wrist socket (the rotation does not matter, calibration determines it later), press the gear in until the teeth mesh and the bearing is fully seated, then press the wrist block down into the cavity and secure it with three M2.5x6 screws.
- Install the front and back covers of the gripper with four M2.5x6 screws. Make sure each cover is pressed all the way on, so the camera's viewing hole is not obstructed.
- Older kits: kits bought from Neufangled before 8 August 2026 have a 50 cm ABS pole, 10 mm in diameter, cut in two. Rejoin it with the printed coupler: apply JB-Weld PlasticWeld epoxy to a 1 cm region at the end of one tube and press it into the coupler, then repeat with the other side. If you have the full pole, skip this. The 6 Jun 2026 guide instead put a ring of cyanoacrylate around the inside of the coupler on one side and jammed a pole section in with one quick motion; that joint is good to about 5 kg.
- Older kits with the marker box: the box is printed in multicolour for a more durable result or in white with stickers. Put the bearing and a 3/8 x 7/8 steel washer on the ABS tube, mark 5 mm from the end of the tube with a sharpie, forcefully twist the helical gear onto the tube until 6 mm of tube protrudes past the gear, and put a few drops of cyanoacrylate where gear and tube meet, with another washer pressed on to glue it in place. Forcefully twist the other end of the rod, the end with no bearing, into the box until it bottoms out, and add a drop of cyanoacrylate from below. The mark should sit at the edge of the plastic gear, not the washer. Then put another steel washer on the tube under the bearing and slide the gear end into the slot in the top of the gripper until firmly seated.
4. Flash and check out the Raspberry Pis
One SD card per component. The image depends on the Pi: the gripper uses the Zero 2W image and the anchors the 3A+ image. The self-test script then leaves the file that tells the component which role it has.
4.1 Image the SD cards
Three cards: two anchors and one gripper. The image depends on the Pi: the gripper uses a Zero 2W and the anchors a 3A+. Skip this if you bought a fully assembled robot.
- Download the Raspberry Pi Imager and insert a microSD card.
- For device, select Raspberry Pi Zero 2 W for the gripper, or Raspberry Pi 3A+ for an anchor.
- Download the Stringman Raspberry Pi image for that Pi (1.6 GB each): stringman-zero2w.img for the gripper, stringman-pi3aplus.img for the anchors. For operating system, select custom image and use the downloaded file.
- Select the card, click Write and confirm.
- Insert the finished card into the component's Pi and boot it.
4.2 Run the component self-test
This is what sets motor IDs and leaves the file that decides which behaviours the service runs next boot.
- SSH into the component and stop the service first: sudo systemctl stop cranebot.service.
- Update the package: /opt/robot/env/bin/pip install --upgrade "nf_robot[pi]".
- For an anchor run /opt/robot/env/bin/qa-anchor-arp and be ready for fast motion while winding - do not hold the supply spool tightly.
- For the gripper run /opt/robot/env/bin/qa-gripper-arp.
- If the finger contact test never detects pressure, adjust the potentiometer on the board slightly until it does.
- The video test at the end can either be completed by opening the stream on a host machine with the printed command, or killed with ctrl-c.
4.3 Join each component to wifi
There is no keyboard on a Pi Zero in a wall anchor: components read wifi credentials off a QR code with their own camera.
- Within about 10 seconds of booting, a component that cannot connect to a saved network starts looking for a wifi share QR code through its camera.
- Generate a code from your phone's wifi share screen, or use qifi.org for a traditional blocky code that reads better at a distance.
- Hold the code in view of each camera, including the gripper's, for about ten seconds each. A 5 cm blocky code reads from about 1.5 m.
- Success is signalled physically: an anchor buzzes its motor, the gripper wiggles its fingers. Anchors also start holding position once connected.
- iPhone codes work fine; Android share codes are decorative and only read when held very close.
- If QR provisioning will not work in your situation, put the SD card from the component in your PC, confirm it is mounted at /media/$USER/rootfs, and run sudo ./add_wifi_config.sh "SSID" "password" from the cranebot3-firmware repository. The script is at src/nf_robot/scripts/add_wifi_config.sh.
- Wifi credentials can be cleared from a gripper by squeezing the finger pad rapidly five times.
4.4 Optional: lock the Pis down
The stock image ships a known password, which is convenient for troubleshooting and nothing else.
- The default user is pi with password Fo0bar!! on the stock Stringman image.
- Automated route: from the firmware repo with the venv active, run python experiments/deploy_ssh_keys.py <robot conf.json>. It only disables password auth after verifying key auth works, so it cannot lock you out.
- Manual route: passwd to change the password, ssh-keygen -t ed25519 and ssh-copy-id pi@<component> for key auth.
- Confirm you can log in without a password, then set PasswordAuthentication no and ChallengeResponseAuthentication no in /etc/ssh/sshd_config and restart ssh.
- Repeat for each of the three components.
5. Install in the room and calibrate
Upstream compares this to hanging a curtain rod: about an hour uninterrupted, plus at least 30 minutes of setup. Tools are a step ladder, a drill/driver, the M1.5 hex bit and the T20 torx bit (both included).
5.1 Plan the work area
The four mounting points define the robot's entire workspace, so this choice is the one that is expensive to change.
- Pick two opposing corners for the anchors; the other two corners take the eyelets. The volume enclosed by those four points is the work area.
- Maximise the area while keeping it free of obstacles.
- Anchors must go into the wooden studs behind the wall, or be strapped to structural columns. In a drywall home there is always at least one stud behind a wall corner, and hitting a stud on one side is sufficient.
- Do not mount with adhesive or magnets. Command strips rated for 5 kg are rated straight down, and Stringman pulls sideways in several directions.
- Do not mount to the T-bars of a drop ceiling - even if the mount holds, bending the bars changes the anchor orientation and wrecks calibration and swing cancellation.
- If the room has a ceiling fan, mount at or below blade height and the robot cannot reach the blades.
- A bunk bed inside the work area is acceptable, but obstacle avoidance is not implemented, so expect to intervene manually sometimes.
- If there are no usable studs, you will need a backer board fixed to the room's structural elements.
5.2 Rejoin the gripper and marker box
They ship separated to fit a smaller box. This is the reverse of the last gripper build step.
- Using the supplied 1.5 mm mini screwdriver bit, remove the two screws holding the back cover of the gripper, one top and one bottom. Your gripper may have been shipped with these removed already, in which case the screws are in the accessory bag.
- Unscrew the three screws holding the wrist removal block, the part at the top of the back with the rectangular hole, and pull it out. It is intentionally a tight fit. If it is too tight, pry it out with a screwdriver.
- Feed the gripper's power supply plug up through the pole of the marker until it comes out the top. If it gets hung up inside the tube, twist the tube back and forth.
- Seat the gear and bearing into the wrist socket - rotation does not matter, calibration determines it later.
- Press the gear in until the teeth mesh and the bearing is fully seated, then press the wrist block down into the cavity and secure it with the three screws.
- Refit the back cover with the two screws you removed.
5.3 Mount the anchors
Height is set from whichever is lowest: the ceiling, the crown moulding, or the fan blades.
- Mark 13 cm (5 in) below the ceiling in the corner. If there is crown moulding, measure from that; if there is a ceiling fan, mark the blade height. Take the lowest of the three.
- Hold the butterfly-shaped stud mount against the wall with its top edge at your mark.
- In a corner, use the two horizontally centred holes: mark, pre-drill through the part, then drive two 76 mm (3 in) wood screws.
- On a flat wall, use a pair of vertical holes on the same side so the mount faces the centre of the room, and find the stud with a stud finder or by spotting the drywall screws.
- Many homes are not square. If the stud mount deforms as you tighten it, back the screws off until it is minimally deformed, or the anchor will not slide on.
- Hold the anchor near the ceiling and slide it straight down into the mount until it locks in.
- While the ladder is still there, plug in one of the white barrel jack extension cords and leave it hanging.
- Pull both lines out of the anchor down to a height you can reach without the ladder, then repeat in the opposite corner.
- Holding the anchor with the cover on can be tricky. It is easiest to clamp it with both hands from the top and bottom, or you can remove the decorative cover on the ground, mount the anchor without it and add the cover afterwards. That adds a step but is probably safer.
5.4 Mount the eyelets and the parking hook
The eyelets turn two of the four lines through the remaining corners.
- In each remaining corner, drive a single wood screw through an eyelet into a stud, with the small pointer facing up.
- It should sit on the right-hand wall when you face the corner; if that corner of the work area is flat, mount it however you can, as long as it is in a stud.
- Facing the eyelet, look to the anchor on your right. Take the carabiner from its left line, pass it through the eyelet from back to front, and pull it down to a reachable height.
- Mount the parking hook, prong facing upwards, into a stud on a wall close to an anchor, in the region upstream marks with a blue outline in its picture, so that when the marker is just in front of the hook its tag is visible to the anchor camera. It can go on either side of an anchor; on the left, the hook's fingers must be flipped so they open towards the anchor. Do not put it too close to the anchor, or the line interferes with normal movement. Angle the screws slightly for tool clearance.
- Set the hook high enough that you can comfortably walk under the lines while the robot is parked. If it is mounted too high, parking becomes very difficult, because precision gets exponentially worse near the ceiling.
- You can mount the hook outside that region if needed, but self parking is then not possible because the anchor cannot see the marker. The earlier guide described a printed AprilTag on a narrow shelf, mounted two inches below the gripper's fingers in the parked position, to aid self parking. The current guide no longer mentions it.
- To record the parking location: power the system on and manually pilot the gripper near the hook, run Half cal (2) to ensure a good position fix, drive into the hook and move downwards until the hook takes the weight, select Parking > Set Parking Location from the run menu and wait for movement to stop. Then select Unpark and confirm it gets out of the hook with no trouble, and test self parking by flying somewhere in the room and selecting Park. If self parking did not work well, repeat the recording. If it is still poor, the calibration of the room may not be good enough, or the lighting may be too poor for the anchor to see the marker during parking.
- You can also disconnect the gripper from the lines using the carabiners and run the debug command stow to reel in all the lines until some tension is felt. Before doing this, mark which hook was the power line hook, so you can re-attach everything the same way as during calibration. The earlier guide recommended parking by hand: move near the hook, hold the robot, power off the motors with the remote and hang it up.
- Eyelets made before October 2026 had a countersunk screw (cone-shaped head). If you have this type, do not overtighten it, or it can split the eyelet in half. Tighten only enough that the structure feels rigidly attached to the wall.
5.5 Power up and connect
Do this before tying the lines up, while everything is still reachable.
- Plug the gripper into the grey power line. The earlier guide said to lean the gripper against the wall near the grey power line from one anchor and plug its JST-ZH cable in at the top of the marker.
- Connect the 24 V 5 A supplies to the anchors and plug them into the wall through the supplied outlet remote.
- Always plug the barrel jack in before AC power, and plug in AC power (or turn on with the outlet remote) last. Anchors may be permanently damaged unless the barrel jack is plugged in before the AC power.
- Start the motion controller on the host machine (see the Usage Guide): pip install "nf_robot[host]", then run stringman-headless. It begins searching the network for components.
- Only one complete Stringman may be on the network during this step - turn any other one off, so discovery can tell which components belong to this robot.
- Power on all components with the outlet remote and hold up the wifi QR code for each camera if they are not yet provisioned.
- Confirm the control panel has discovered two anchors and one gripper. If not, power everything off and repeat.
- Guest networks will not work: they block clients from discovering each other.
- With everything connected, run Calibration and Maintenance > Update Firmware On Components and wait for confirmation from all three. Updates are never pushed automatically.
5.6 Tie up the lines
Four carabiners, four loops, no crossings.
- Power the whole system off.
- Place the gripper in the centre of the room and pull each of the four lines to the centre.
- Clip the black carabiners from the anchors onto the black bar and the silver carabiners from the eyelets onto the white corners of the marker, so the anchors always look at the marker face on. No lines should cross. The earlier guide (marker box) said to clip each carabiner onto the corresponding loop in the white marker box.
- Plug the gripper power in from the end of the grey line if it is not already connected.
- Power the system back on and wait for all components to be discovered in the control panel.
- Select Tension Lines (D-Left, or 2 on the keyboard) - all four lines should tighten.
- Hold E for a second or two to lift off the ground. Anything more complex needs full calibration first.
5.7 Run full calibration
Calibration locates the anchors and eyelets from four printed cards on the floor. Everything downstream - straight-line motion, swing cancellation, parking - depends on it.
- Lay the four large paper cards on the floor with the one labelled origin in the centre and the others around it, anywhere.
- The small plastic cards are not part of calibration - they label drop points during normal operation.
- Put the gripper near the centre of the room, touching the floor, then select Calibration and Maintenance > Full Calibration.
- Some lines going slack during calibration is normal and is how the eyelet positions are found.
- If any card moves, press STOP and start again.
- Judge the result three ways: the room shape in the UI should match what you installed, WASD should produce straight-line motion, and swing cancellation should damp the swing rather than amplify it.
- A lateral move forwards (W, or up on the left stick) should move the way the gripper's nose is facing, since gripper perspective is the default.
- If results are poor, move the calibration cards further apart and try again with the gripper on the floor near the centre.
- Remove stray AprilTag or ArUco markers from the room, including any on computer screens the cameras can see, and use the brightest lighting available.
- If there is too little overlap of the two cameras on the floor for you to place several cards in view of both, adjust the camera tilt. Remove the anchor cover and press either the top or bottom edge of the camera tilt mechanism to adjust it by one click at a time. Check for better overlap in the composite image by re-running calibration (slow) or by entering the known angle directly in the component context menu. Calibration automatically discovers the true angle of the camera.
- Anchors with the older fixed adapters (22, 26 or 30 degrees, shipped with 26 installed): remove the white cover, ground yourself to prevent static discharge and unscrew the camera mount from the side. Flip the camera up and remove the two screws that attach it to the mount. Fit the mount with the better angle, 30 degrees for tall skinny rooms or 22 degrees for wider rooms or short ceilings, press it into the notch on the frame and screw it back in from the side. The screw must be fully seated and the mount tight against the frame, or it may end up in an indeterminate orientation.