---
orphan: true
---

# How-to guides

Task-oriented guides for specific use cases.

::::{grid} 1 1 2 2
:gutter: 3

:::{grid-item-card} {octicon}`file-code` Run scripts
:link: run-scripts
:link-type: doc

Run Python scripts with inline dependency metadata.
:::

:::{grid-item-card} {octicon}`database` Manage cache
:link: manage-cache
:link-type: doc

Control the conda-exec package cache.
:::

:::{grid-item-card} {octicon}`package` Use custom channels
:link: use-channels
:link-type: doc

Search bioconda, defaults, or other channels for packages.
:::

:::{grid-item-card} {octicon}`zap` Use activation mode
:link: use-activation
:link-type: doc

Apply full conda activation for tools that need CONDA_PREFIX.
:::

:::{grid-item-card} {octicon}`pin` Pin package versions
:link: version-constraints
:link-type: doc

Constrain tool versions using match specs.
:::

:::{grid-item-card} {octicon}`server` Use in CI/CD pipelines
:link: ci-cd
:link-type: doc

Run tools ephemerally in CI without permanent installation.
:::

:::{grid-item-card} {octicon}`tools` Troubleshoot common issues
:link: troubleshooting
:link-type: doc

Fix errors with installation, caching, and tool discovery.
:::

::::