WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

RegisterExternalEvaluator   
✖
RegisterExternalEvaluator

Listing of External Evaluators »
Unsupported in Public Cloud[Experimental]

✖
RegisterExternalEvaluator[sys,evaluator]

registers the evaluator for use as an external evaluator with the language or system sys.

✖
RegisterExternalEvaluator[sys,evaluator,name]

registers the evaluator using the assigned name name.

Details

Examples

open allclose all

Basic Examples  (4)Summary of the most common use cases

Register a new NodeJS installation at the location "/usr/local/bin/node":

In[1]:=1
✖
https://wolfram.com/xid/0tqgb5oammhjtq-pjli07
Out[1]=1

Use FindExternalEvaluators to see that the NodeJS installation is registered:

In[2]:=2
✖
https://wolfram.com/xid/0tqgb5oammhjtq-k1jlj8
Out[2]=2

Register a Python installation found at the location "/usr/bin/python3":

In[1]:=1
✖
https://wolfram.com/xid/0tqgb5oammhjtq-js3j6u
Out[1]=1

Use the newly registered Python:

In[2]:=2
✖
https://wolfram.com/xid/0tqgb5oammhjtq-f38izt
Out[2]=2

Register a Python provisioned environment using a name:

In[1]:=1
✖
https://wolfram.com/xid/0tqgb5oammhjtq-j80han
Out[1]=1

Use the newly registered environment by referring to it by name:

In[2]:=2
✖
https://wolfram.com/xid/0tqgb5oammhjtq-v5gyco
Out[2]=2

Define a reference to a database using SQLite:

In[1]:=1
✖
https://wolfram.com/xid/0tqgb5oammhjtq-bjavwd
Out[1]=1

Register the database using RegisterExternalEvaluator:

In[2]:=2
✖
https://wolfram.com/xid/0tqgb5oammhjtq-yvd7sc
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0tqgb5oammhjtq-2mrpn7
Out[3]=3

When using ExternalEvaluate, "SQL" will use the most recently registered database:

In[4]:=4
✖
https://wolfram.com/xid/0tqgb5oammhjtq-dni65l
Out[4]=4

To unregister the database, use UnregisterExternalEvaluator:

In[5]:=5
✖
https://wolfram.com/xid/0tqgb5oammhjtq-cybb8t
Out[5]=5

Scope  (1)Survey of the scope of standard use cases

Register a Python installation using a name:

In[11]:=11
✖
https://wolfram.com/xid/0tqgb5oammhjtq-8g0c20
Out[11]=11

Use the newly registered environment:

In[4]:=4
✖
https://wolfram.com/xid/0tqgb5oammhjtq-fys2ta
Out[4]=4

The name can also be found when using FindExternalEvaluators:

In[12]:=12
✖
https://wolfram.com/xid/0tqgb5oammhjtq-mxqq9g
Out[12]=12

Properties & Relations  (1)Properties of the function, and connections to other functions

Unregister all external evaluators with UnregisterExternalEvaluator:

In[1]:=1
✖
https://wolfram.com/xid/0tqgb5oammhjtq-gctzql
Out[1]=1

ExternalEvaluate will attempt to provide an evaluator when you do not have registered evaluators anymore:

In[2]:=2
✖
https://wolfram.com/xid/0tqgb5oammhjtq-iaga6j
Out[2]=2

For the "Python" evaluator, a new installation is created under $UserBaseDirectory:

In[3]:=3
✖
https://wolfram.com/xid/0tqgb5oammhjtq-bcu12g
Out[3]=3

Possible Issues  (1)Common pitfalls and unexpected behavior

Register a Python installation using a name:

In[1]:=1
✖
https://wolfram.com/xid/0tqgb5oammhjtq-hi0twg
Out[1]=1

Registering a different Python installation using the same name will override the previous registration:

In[2]:=2
✖
https://wolfram.com/xid/0tqgb5oammhjtq-oy9ked
Out[2]=2

Only the latest installation is now registered:

In[3]:=3
✖
https://wolfram.com/xid/0tqgb5oammhjtq-s26j4k
Out[3]=3

Neat Examples  (1)Surprising or curious use cases

List all current external evaluators for a system:

In[1]:=1
✖
https://wolfram.com/xid/0tqgb5oammhjtq-g0gbdn
Out[1]=1

Unregister all external evaluators for a particular system:

In[2]:=2
✖
https://wolfram.com/xid/0tqgb5oammhjtq-r1nf44
Out[2]=2

All evaluators for Python are now unregistered:

In[3]:=3
✖
https://wolfram.com/xid/0tqgb5oammhjtq-hd6r1x
Out[3]=3

Register them all again:

In[4]:=4
✖
https://wolfram.com/xid/0tqgb5oammhjtq-b8r4id
Out[4]=4

All of the Python installations are now registered again:

In[5]:=5
✖
https://wolfram.com/xid/0tqgb5oammhjtq-48yk2u
Out[5]=5
Wolfram Research (2017), RegisterExternalEvaluator, Wolfram Language function, https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html (updated 2020).
✖
Wolfram Research (2017), RegisterExternalEvaluator, Wolfram Language function, https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html (updated 2020).

Text

Wolfram Research (2017), RegisterExternalEvaluator, Wolfram Language function, https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html (updated 2020).

✖
Wolfram Research (2017), RegisterExternalEvaluator, Wolfram Language function, https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html (updated 2020).

CMS

Wolfram Language. 2017. "RegisterExternalEvaluator." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html.

✖
Wolfram Language. 2017. "RegisterExternalEvaluator." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html.

APA

Wolfram Language. (2017). RegisterExternalEvaluator. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html

✖
Wolfram Language. (2017). RegisterExternalEvaluator. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html

BibTeX

@misc{reference.wolfram_2025_registerexternalevaluator, author="Wolfram Research", title="{RegisterExternalEvaluator}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html}", note=[Accessed: 19-May-2025 ]}

✖
@misc{reference.wolfram_2025_registerexternalevaluator, author="Wolfram Research", title="{RegisterExternalEvaluator}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html}", note=[Accessed: 19-May-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_registerexternalevaluator, organization={Wolfram Research}, title={RegisterExternalEvaluator}, year={2020}, url={https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html}, note=[Accessed: 19-May-2025 ]}

✖
@online{reference.wolfram_2025_registerexternalevaluator, organization={Wolfram Research}, title={RegisterExternalEvaluator}, year={2020}, url={https://reference.wolfram.com/language/ref/RegisterExternalEvaluator.html}, note=[Accessed: 19-May-2025 ]}