Skip to content

Commit ff7e996

Browse files
committed
update nextflow
1 parent 8842def commit ff7e996

1 file changed

Lines changed: 34 additions & 23 deletions

File tree

‎src/content/docs/guide/nextflow.mdx‎

Lines changed: 34 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -33,11 +33,10 @@ curl -s https://get.nextflow.io | bash
3333
chmod +x nextflow
3434
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc
3535

36-
# nf-core tools (in a Python venv)
37-
module load python
38-
python -m venv $HOME/venvs/nf-core
39-
source $HOME/venvs/nf-core/bin/activate
40-
pip install --upgrade pip nf-core
36+
# nf-core tools (via the conda module — Negishi's system python3 is 3.6, too old)
37+
module load conda
38+
conda create -n nf-core -c bioconda -c conda-forge nf-core -y
39+
conda activate nf-core
4140
```
4241

4342
Then copy the [minimal Negishi config](#a-minimal-working-config-for-negishi)
@@ -107,38 +106,39 @@ downloading, linting, and launching nf-core pipelines. It is separate from
107106
Nextflow itself — you do not strictly need it to run a pipeline, but it makes
108107
the common tasks much easier.
109108

110-
We recommend installing it into a dedicated Python virtual environment so it
111-
does not interact with other projects.
109+
nf-core tools requires **Python 3.8 or newer**. Negishi's system `python3` is
110+
3.6.8 (too old), but loading the `conda` module gives you conda itself plus a
111+
recent Python (3.12). Use it to create a dedicated conda environment for
112+
nf-core tools.
112113

113114
<Steps>
114115

115-
1. **Load a recent Python**
116+
1. **Load the `conda` module**
116117

117118
```bash frame="none"
118119
module --force purge
119-
module load python
120-
python --version
120+
module load conda
121121
```
122122

123-
nf-core tools require Python 3.8 or newer.
124-
125-
2. **Create and activate a virtual environment**
123+
Verify that you have a recent Python on `PATH`:
126124

127125
```bash frame="none"
128-
python -m venv $HOME/venvs/nf-core
129-
source $HOME/venvs/nf-core/bin/activate
126+
python3 --version
130127
```
131128

132-
3. **Install `nf-core`**
129+
2. **Create a dedicated environment for nf-core tools**
133130

134131
```bash frame="none"
135-
pip install --upgrade pip
136-
pip install nf-core
132+
conda create -n nf-core -c bioconda -c conda-forge nf-core -y
137133
```
138134

139-
4. **Verify the installation**
135+
This pulls `nf-core` from the bioconda channel and resolves all its
136+
Python dependencies in one shot.
137+
138+
3. **Activate the environment and verify**
140139

141140
```bash frame="none"
141+
conda activate nf-core
142142
nf-core --version
143143
nf-core pipelines list
144144
```
@@ -149,10 +149,21 @@ does not interact with other projects.
149149
</Steps>
150150

151151
<Aside type="note">
152-
Whenever you open a new shell to work with nf-core tools, reactivate the
153-
environment with `source $HOME/venvs/nf-core/bin/activate`. You do **not** need
154-
the venv active to run a pipeline with `nextflow run nf-core/<pipeline>` — only
155-
for the `nf-core` CLI itself.
152+
In a new shell, reload the module and then reactivate the environment:
153+
`module load conda && conda activate nf-core`. You do **not** need the
154+
environment active to run a pipeline with `nextflow run nf-core/<pipeline>`
155+
— only for the `nf-core` tooling itself.
156+
</Aside>
157+
158+
<Aside type="tip">
159+
By default, conda writes environments to `$HOME/.conda/envs/`, which can
160+
quickly exhaust your home quota. Point `envs_dirs` at scratch **before**
161+
creating the environment:
162+
163+
```bash frame="none"
164+
mkdir -p $RCAC_SCRATCH/conda_envs
165+
conda config --add envs_dirs $RCAC_SCRATCH/conda_envs
166+
```
156167
</Aside>
157168

158169
## A minimal working config for Negishi

0 commit comments

Comments
 (0)