A Micronaut configuration that integrates your app with an existing Jupyter installation.
A special Micronaut kernel is provided to Jupyter that can be used to run notebooks. This kernel can:
- Execute Groovy code
- Do anything the BeakerX Groovy kernel can
- Import classes on your Micronaut app's classpath
Ensure the following repositories are added to your gradle build:
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
Add the following dependency to your gradle build:
dependencies {
implementation "ai.stainless:micronaut-jupyter"
}
Ensure that your app can write to a directory where Jupyter will search for kernels.
The default directory is /usr/local/share/jupyter/kernels
, so the following
is sufficient:
chmod 777 /usr/local/share/jupyter/kernels
Create a separate directory, say at /opt/jupyter-alt/kernels
, that your app
can write to. Then, configure Jupyter to search this directory using
JUPYTER_PATH.
Lastly, add the following config to your application.yml:
jupyter:
kernel:
location: /opt/jupyter-alt/kernels
When your app starts up, this configuration will make any necessary configurations to Jupyter. Once both your app and Jupyter are running, login to Jupyter to start using the features.
See the /examples directory for example apps that use this configuration along with sample Jupyter notebooks that take advantage of the available features.
./gradlew test
./gradlew build
- Import classes on app classpath in Jupyter script
- Access GORM methods in Jupyter scripts
- Access beans in Jupyter script
- Ability to add custom methods and properties to scope of Jupyter script
- Access GORM Data Services from Jupyter script
- Access Micronaut Data repositories from Jupyter script