Troubleshooting
“MediapipePosedetection TurboModule is not available”
Section titled ““MediapipePosedetection TurboModule is not available””The native module isn’t in your build, or the New Architecture is off.
- Confirm the New Architecture is enabled (
newArchEnabled=trueon Android; default on React Native 0.76+ and Expo SDK 52+). - If you’re on Expo, make sure you’re running a development build, not Expo Go.
- Do a clean native rebuild:
npx expo prebuild --cleanon Expo, orcd ios && pod installpluscd android && ./gradlew cleanon bare React Native.
“Failed to initialize posedetection plugin”
Section titled ““Failed to initialize posedetection plugin””The VisionCamera frame processor plugin couldn’t be registered. Usually one of:
react-native-worklets-coreisn’t installed, or its Babel plugin is missing frombabel.config.js.- Metro is serving an old bundle. Restart with
npx expo start --clearornpx react-native start --reset-cache.
“Failed to create detector”
Section titled ““Failed to create detector””MediaPipe couldn’t load the model.
- Check the file name you pass matches the bundled file exactly, including
.task. - Check the file is actually in the build. See Model files.
- On Expo, re-run
npx expo prebuild --cleanafter adding a model. - Make sure it’s a pose landmarker model, not a different MediaPipe task.
Camera shows but onResults never fires
Section titled “Camera shows but onResults never fires”- Did you attach the frame processor? With your own
<Camera>, passframeProcessor={solution.frameProcessor}. - If you use your own
<Camera>, setpixelFormat="rgb", which is whatMediapipeCamerauses and what the library is tested with. - Check that camera permission was granted.
- Add an
onErrorcallback and log what it receives.
Landmarks are offset or flipped
Section titled “Landmarks are offset or flipped”You’re probably drawing normalized coordinates directly. Convert them with the ViewCoordinator passed to onResults, and wire up all the camera handlers. See Drawing a skeleton overlay.
Memory warnings or crashes during long sessions
Section titled “Memory warnings or crashes during long sessions”- Update to the latest version.
- Set
fpsModeto 10–15. - Keep
numPoses: 1andshouldOutputSegmentationMasks: false. - Try
Delegate.CPUon devices with limited GPU memory.
Upgrading from an old-architecture version
Section titled “Upgrading from an old-architecture version”The JavaScript API is the same. Upgrade React Native to 0.74+, enable the New Architecture, and do a full clean rebuild of both platforms.
Still stuck?
Section titled “Still stuck?”Open an issue with your React Native / Expo version, platform, device and the full error.