---
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}`tools` Run command-line tools
:link: run-tools
:link-type: doc

Run conda-packaged commands without permanent installs.
:::

:::{grid-item-card} {octicon}`package` Use PyPI dependencies
:link: use-pypi-dependencies
:link-type: doc

Resolve PEP 723 PyPI dependencies through conda-pypi.
:::

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

Control the conda-exec package cache.
:::

:::{grid-item-card} {octicon}`database` Configure cleanup
:link: configure-cleanup
:link-type: doc

Tune automatic cache cleanup for workstations and CI runners.
:::

:::{grid-item-card} {octicon}`lock` Lock scripts
:link: lock-scripts
:link-type: doc

Generate sidecar or embedded lock data for reproducible scripts.
:::

:::{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 conda activation environment variables 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}`arrow-switch` Migrate from classic conda-exec
:link: migrate-from-classic-conda-exec
:link-type: doc

Switch from the historical conda-forge package to modern conda-exec.
:::

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

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

::::