Seqera AI CLI

AI-powered assistant for bioinformatics workflows and Seqera Platform.

Get started

1. Install the Seqera AI CLI:

   npm install -g seqera

   See Installation for a comprehensive installation guide.

2. Log in to your Seqera account:

   seqera login

   See Authentication for a comprehensive authentication guide.

3. Start Seqera AI:

   seqera ai

4. Run your first prompt:

   List my recent workflows

   See Use cases for a comprehensive list of use cases.

Use cases

Seqera AI is an intelligent command-line assistant that helps you build, run, and manage bioinformatics workflows. The following sections describe several common use cases.

Work with Nextflow

Seqera AI helps you develop, debug, and understand Nextflow pipelines with AI-powered analysis and code generation.

Understand your pipeline structure:

> Show me the structure of main.nf

> What processes are defined in this pipeline?

Generate a nextflow.config file:

> Generate a nextflow.config for my pipeline

Debug your pipeline:

> Why is my pipeline failing?

> Run nextflow lint on my pipeline

Generate a schema (nextflow_schema.json) file:

> Generate a nextflow_schema.json for my pipeline

Convert scripts to Nextflow:

> Convert my Python script to a Nextflow process

Build containers with Wave

Seqera AI can create containerized environments using Wave, without requiring you to write Dockerfiles.

Create a container with conda packages:

> Create a container with samtools and bwa from bioconda

Create a container with pip packages:

> Build a container with pandas, numpy, and scikit-learn

Get a container for a specific tool:

> I need a container with FastQC version 0.12.1

Note: The assistant will generate a Wave container URL that you can use directly in your Nextflow pipelines or pull with Docker.

Customize your session

Customize your session with command-line options.

Start in a specific directory:

seqera ai -w /path/to/project

Set approval mode for local commands:

seqera ai -a full

Exit the assistant

End your Seqera AI session when done.

To end your session:

• Type /exit or /quit
• Press Ctrl+C

Note: Your conversation history is preserved for the session but not stored permanently.

Use slash commands

Seqera AI includes built-in slash commands for common workflows.

Type / to see all available commands:

| Command | Description | |---------|-------------| | /help (or ?) | Show available commands | | /exit (/quit, /q) | Exit the application | | /clear | Clear conversation history | | /thinking | Toggle thinking display | | /scroll | Toggle auto-scroll | | /org | Show current organization | | /session | Show current session ID | | /sessions | Browse and switch sessions | | /lsp | Show LSP server status | | /status | Show system status | | /credits | Show credit balance and usage | | /approval [mode] | Show or set approval mode (always/default/suggest) | | /update | Check CLI updates and next steps | | /feedback | Open feedback form | | /help-community | Open community help | | /stickers | Get Seqera stickers |

Work with data

Seqera AI helps you manage data through Platform data links and access reference datasets.

Browse data links:

> List my data links

> Show me the contents of my S3 data link

Download and upload files:

> Generate a download URL for results/final_report.html

> Upload my local results to the data link

Access reference data:

> Find the human reference genome GRCh38

> Search for RNA-Seq test data

Work with local files

Seqera AI can interact with files in your current working directory.

Start the assistant from your project folder:

cd /path/to/your/project
seqera ai

Then, ask the assistant to help with local tasks:

> Show me the structure of main.nf

> Add a new process to handle quality control

Note: Local file operations are controlled by approval modes. By default, the assistant will ask for your approval before making changes outside your working directory or running potentially dangerous commands.

Work with nf-core modules

Seqera AI provides access to over 1,000 nf-core modules for common bioinformatics tasks.

Search for modules:

> Find nf-core modules for sequence alignment

> What modules are available for variant calling?

Get module details:

> Show me how to use the nf-core/bwa/mem module

Run a module:

> Run FastQC on my FASTQ files

Note: The assistant can generate the exact Nextflow command with proper parameters for your data.

Work with Seqera Platform

Use Seqera Platform capabilities to run and manage workflows at scale with AI assistance.

List your workflows:

> List my recent workflows

Launch a pipeline:

> Launch the nf-core/rnaseq pipeline with the test profile

Debug failed runs:

> Why did my last workflow fail?

> Get the logs for the failed task in my last run

Learn more

• Installation: Detailed installation instructions
• Authentication: Log in, log out, and session management
• Command approval: Control which commands run automatically
• Use cases: Seqera AI CLI use cases
• Troubleshooting: Troubleshoot common errors