tfjs does not work with hermes engine
System information
- Have I written custom code (as opposed to using a stock example script provided in TensorFlow.js): No
- OS Platform and Distribution (e.g., Linux Ubuntu 16.04): MacOS 12.2.1 (21D62), M1
- Mobile device (e.g. iPhone 8, Pixel 2, Samsung Galaxy) if the issue happens on mobile device: NA
- TensorFlow.js installed from (npm or script link): npm
- TensorFlow.js version (use command below): 3.18.0
- Browser version: NA
- Tensorflow.js Converter Version: NA
Describe the current behavior
When using tfjs for React Native, tfjs does not work when using hermes JavaScript engine. It works with the default jsc engine.
It fails at instanceof Tensor assertion, even though the constructor is correctly identified as Tensor:

Describe the expected behavior
tfjs should run without errors when using hermes engine.
Standalone code to reproduce the issue
Minimum reproduction repo: https://github.com/paradite/tfjs-hermes-bug
From the repo, running npm run test:hermes throws an error:
tensor.js:1:1: error: class declaration exports are unsupported
This means that probably the original code was transformed by babel/typescript before reaching hermes and caused the instance of assertion to fail.
I should raise an issue in https://github.com/facebook/hermes, but it is hard to reproduce the exact issue when tfjs uses a lot of import across different files (hermes-cli needs to take input of all files being imported).
On the other hand, the fix for this issue on tfjs side is easy:
Other info / logs
I have tried a hacky fix and it seems to work:
Instead of using
if (x instanceof Tensor) {
assertDtype(parseAsDtype, x.dtype, argName, functionName);
return x;
}
, use
if (x instanceof Tensor || x.constructor.name === 'Tensor') {
assertDtype(parseAsDtype, x.dtype, argName, functionName);
return x;
}
Did you get chance to check similar issue here https://github.com/tensorflow/tfjs/issues/5972 ?
Did you get chance to check similar issue here #5972 ?
I haven't and I should have. It seems to be the same problem as one comment noted, tfjs doesn't work together with hermes.
I will leave it to you to decide if this should be fixed on tfjs side or hermes.
What I can contribute is the reproduction code above prove that hermes doesn't support export class by default, and the incompatibility might lie in interaction between build tools like babel or typescript and hermes.
@mattsoulanille could you please help with this issue , if we can support hermes from tfjs ?
Same here, cannot get TFJS to work with React Native and Hermes JS engine enabled. The checkInputs method keeps throwing. Exactly the same build works fine with JSC.
Having had to disable hermes, too, is there any update on the matter or maybe another board where progress could be tracked @mattsoulanille? Cheers! :)
Has there been any progress on this? Now that React Native uses Hermes by default, it would be great to figure out how tfjs can support it.
Sorry for the lack of updates. We would like to support Hermes, if possible, but it's not at the top of our priority list right now.
Looking at the error message, this seems to be a case of having multiple versions of the Tensor class, possibly due to importing Tensor from @tensorflow/tfjs-core, which points to a rollup bundle, and from @tensorflow/tfjs-core/dist/tensor, which points to a file. If you . In the future, we may add an exports field to the package.json file, which should prevent these kinds of imports by only allowing a set of imports we specify. ~~I expect this change will fix the issue here or at least reveal what's causing it.~~
I took a quick look at the reproduction (thanks for posting one!), and it seems like it's not using tfjs (It has its own tensor class). I don't think Hermes supports exporting classes yet, but the example might work if it's compiled down to use prototypes instead of classes (es5 I think).
I also tried getting hermes to import @tensorflow/tfjs. Here are a few fixes we need to make in tfjs to make this happen:
- Use
globalThisas the global variable in getGlobalNamespace (For my test, I replacedglobalwithglobalThisinnode_modules/@tensorflow/tfjs/dist/tf.jsbundle) - Use
printinstead ofconsole.log- We should probably add a log function to the Platform interface (For my test, I just string-replaced console.log with print innode_modules/@tensorflow/tfjs/dist/tf.js). - Make tfjs backends work.
After these changes, the following test code works (on my linux machine):
// index.js
import { Tensor } from './node_modules/@tensorflow/tfjs/dist/tf.js';
const tensor = new Tensor([1,2,3]);
print(tensor.size);
yarn add @tensorflow/tfjs
./hermes -commonjs index.js node_modules/@tensorflow/tfjs/dist/tf.js
However, I'm not able to load any tfjs backends, so all I can do is print the size.
Edit: Actually, I'm able to load the CPU backend, but it seems as though the weak map that holds tensor data is losing the data too early when I try to run readSync.
Please leave this issue open so I can take another look when I have some time.
@mattsoulanille thanks for taking a look.
I want to share a walkaround that I found to be working for my use case:
- Patch the tfjs code directly at
node_modules/@tensorflow/tfjs/dist/tf.node.js
function convertToTensor(x, argName, functionName, parseAsDtype = 'numeric') {
- if (x instanceof Tensor) {
+ if (x instanceof Tensor || x.constructor.name === 'Tensor') {
assertDtype(parseAsDtype, x.dtype, argName, functionName);
return x;
}
- Use https://github.com/ds300/patch-package to generate a patch inside the repo
npx patch-package @tensorflow/tfjs
- Follow https://github.com/ds300/patch-package instructions for adding a postinstall hook after
npm i/yarn
I am using yarn v1 so I ran
yarn add patch-package postinstall-postinstall
The additional setup in package.json looks like this:
{
"scripts": {
"postinstall": "patch-package"
},
"dependencies": {
"patch-package": "^6.4.7",
"postinstall-postinstall": "^2.1.0"
}
}
I did also spent a few hours digging into this issue but did not make much progress. Some findings:
-
@tensorflow/tfjs-react-nativepackage does not matter. the issue happens with or without it - the issue gets trigger when a
Tensorwas returned by some operation and then theTensorinstance chains other operations such asargMaxormul, which leads togetGlobalTensorClasscall:
getGlobalTensorClass().prototype.argMax = function (axis) {
this.throwIfDisposed();
return argMax(this, axis);
};
getGlobalTensorClass().prototype.mul = function (b) {
this.throwIfDisposed();
return mul(this, b);
};
- Rewriting chained operation
tensor.argMax(-1)intotf.argMax(tensor, -1)seems to solve the issue for that particular instance, as I was getting different errors after the rewrite -
Tensorobject from@tensorflow/tfjs,@tensorflow/tfjs/dist/tf.nodeand@tensorflow/tfjs-core/dist/tf-core.nodeappear to be identical on Hermes in my testing:
import * as tf from '@tensorflow/tfjs';
import * as tfnode from '@tensorflow/tfjs/dist/tf.node';
import * as tfcorenode from '@tensorflow/tfjs-core/dist/tf-core.node';
console.log('tf.Tensor === tfnode.Tensor', tf.Tensor === tfnode.Tensor);
console.log(
'tfcorenode.Tensor === tfnode.Tensor',
tfcorenode.Tensor === tfnode.Tensor
);
// true
// true
@paradite 's patch package worked for us, there were a few more places that needed the same fix (adding || x.constructor.name === 'Tensor' ) so don't give up if that patch doesnt work for you straight away
Hi @rthadur @gaikwadrahul8 @mattsoulanille
After playing with metro, hermes and tfjs-platform-react-native for a bit, I have managed to come up with a minimal reproduction repo:
https://github.com/paradite/tfjs-hermes-bug
It is now easy to reproduce this issue by just running yarn and npm run tfjs:buildrun:
I am willing to work on a PR to fix this issue since it is affecting more people: #5972 #7056
I could follow the suggest in https://github.com/tensorflow/tfjs/issues/5972#issuecomment-1107360396 to:
- replace
instanceof Tensorwithinstanceof getGlobalTensorClass() - verify that it works
- and submit a PR
Let me know what you think. Thanks!
Hey @paradite , I'm wondering if this issue ever got resolved? I seem to be facing this issue still where I have to switch to jsc. However, the issue with jsc is that it doesn't seem to be compatible with expo 49.
Hey @paradite , I'm wondering if this issue ever got resolved? I seem to be facing this issue still where I have to switch to jsc. However, the issue with jsc is that it doesn't seem to be compatible with expo 49.
I have sent a PR #7947 but seems like it's stuck in review.
Oh okay thanks!