Python CLI · Conda · Cross-platform

Make Conda environment operations beautiful, safe, and repeatable.

conda-helper wraps frequent environment tasks into readable one-liners, adds safer defaults, and turns common Conda failures into actionable hints for research, data science, and local development workflows.

Get started View source @wellkilo

8+CLI commands

3platform families

MITopen source

workflow.sh

$ conda-helper ls
NAME                     SIZE  PREFIX
base                   4.2 GB  /opt/miniconda3
vision-lab             9.8 GB  /envs/vision-lab

$ conda-helper ls --no-size
NAME                     SIZE  PREFIX
base                       -   /opt/miniconda3
vision-lab                 -   /envs/vision-lab

$ conda-helper backup vision-lab --from-history
backup written: vision-lab-20260601-101530-history.yml

$ conda-helper pack vision-lab -o ./dist
archive ready: dist/vision-lab-20260601-101630.tar.gz

Backup Restore Clone Pack Clean Doctor Panel

Feature map

Everything you need for daily Conda environment operations.

Designed for users who manage many local environments and want a safer, more memorable interface on top of native Conda.

Versioned backups

Export environments to timestamped YAML files, with history-only mode for portable migrations.

Restore and rename

Rebuild from any backup and override the target environment name during restore.

One-command cloning

Wrap native conda create --clone into a compact, easy-to-remember command.

Offline archives

Prefer conda-pack for relocatable archives and fall back to metadata-rich tarballs.

Safe cleanup

Batch-remove stale environments and preview cache cleanup with dry-run support.

Friendly diagnostics

Run health checks and translate network, disk, channel, and permission problems into practical hints.

Workflow design

A CLI that follows how environments actually move.

conda-helper organizes Conda operations around a repeatable lifecycle: inspect, preserve, move, deploy, and clean. Each command has clear output and conservative behavior by default.

Inspectconda-helper ls shows size and prefix; --no-size skips scanning for fast checks.

Preservebackup --from-history keeps migrations portable.

Moverestore, clone, and pack cover common transfer paths.

Recoverdoctor and friendly errors guide next actions.

Technical design

Small modules, testable boundaries, native Conda underneath.

Click-based interface

The command layer provides ergonomic flags, aliases, validation, and terminal-friendly output.

Command service layer

High-level operations return plain Python data so core behavior can be unit-tested independently.

Conda wrapper

A focused adapter delegates to the real Conda executable instead of reimplementing package logic.

Actionable error model

Known Conda failure patterns are mapped to friendly explanations and next-step suggestions.

Install

Start from PyPI or source.

Requires Python 3.8+ and an available Conda installation.

pip install conda-helper
conda-helper doctor

# or install from source
git clone https://github.com/wellkilo/conda-helper.git
cd conda-helper
pip install -e .