Summary

A Nextflow plugin that restores @Grab (Groovy Grape) dependency resolution for Groovy classes in the lib/ directory.

Starting with Nextflow 24.04.7-edge, Apache Ivy was removed from the Nextflow distribution. This broke the @Grab annotation, which relies on Ivy to resolve and download Maven dependencies at compile time.

This plugin brings @Grab back by bundling Ivy and injecting a working GrapeEngine into Groovy's Grape singleton before lib/ files are compiled.

Get Started

Installation

Add the plugin to your nextflow.config:

plugins {
    id 'nf-itdepends@VERSION'
}

Replace VERSION with the latest release.

Requirements

• Nextflow 24.04.0 or later
• Java 17 or later

Configuration

By default, the plugin resolves dependencies from Maven Central. Additional resolvers can be configured using @GrabResolver in your Groovy code:

@GrabResolver(name='sonatype', root='https://oss.sonatype.org/content/repositories/releases/')
@Grab('some.group:some-artifact:1.0')
import some.group.SomeClass

Dependencies are cached in ~/.groovy/grapes/ (the standard Grape cache directory).

Examples

Use @Grab in your lib/ Groovy files as before:

// lib/MyHelper.groovy
@Grab('commons-lang:commons-lang:2.6')
import org.apache.commons.lang.StringUtils

class MyHelper {
    static String capitalize(String input) {
        return StringUtils.capitalize(input)
    }
}

// main.nf
process EXAMPLE {
    output: stdout
    script:
    """
    echo "${MyHelper.capitalize('hello world')}"
    """
}

workflow {
    EXAMPLE() | view
}

License

MIT

Copyright (c) 2026 Fulcrum Genomics LLC