Miniconda es la distribución más pequeña de Conda, un administrador multiplataforma de paquetes y un sistema de administración de entornos de código abierto (independiente del lenguaje). Constituye la distribución mínima, en contraste con Anaconda, que sería la más completa.

Introducción

Miniconda es el instalador mínimo de los componentes necesarios para conda. Una pequeña versión de arranque (de Anaconda) que incluye conda y sus componentes básicos, pero que son menos, muchos menos que si uno instalara todo Anaconda.

Mediante el comando de instalación (conda install) se pueden agregar más de 720 paquetes adicionales desde el repositorio Anaconda. Lo que queda a gusto de cada quien.

Estas notas recopilan la experiencia de uso de distintas versiones, favoreciendo las más recientes, y han sido organizadas por sistema operativo en cuanto a su instalación, mantenimiento y desinstalación. Para versiones anteriores, consultar el historial de la página (buscar al final de la sección de Referencias).

macOS

Durante la vigencia de macOS 15 («Sequoia«), hubo cambios en la forma en que se ofrecía la instalación de Miniconda, lo que llevó a distinguir en los apartados siguientes. Se presentaron más cambios en «Tahoe», por lo que fue necesario realizar el apartado correspondiente.

Instalación

Instalación en macOS «Tahoe»

Durante la vigencia de «Tahoe«, dejó de ofrecerse el instalador gráfico para Mac Intel⁸. Adicionalmente, se señala que esta opción utiliza /opt/miniconda3 como destino de instalación, se sugiere usar la opción de instalación desde la línea de comando si se necesita más control o hay más usuarios.

Yo había optado por dejarlo en $HOME/Applications, como una instalación local para el usuario no administrador que uso, pero la creación de una cuenta para una labor profesional de desarrollo me hizo ver que necesitaba duplicar la instalación o dejarla en una «ruta común».

Instalación en macOS «Sequoia»

En «Sequoia» me encontré con cambios en las alternativas ofrecidas por el desarrollador. La alternativa para hacer uso de un instalador ya no existe y, tanto para Windows, macOS y Linux la instalación se limita a la descarga de un script vía curl o wget desde la línea de comando y, al parecer, tampoco se está considerando ya la opción de hacer la instalación en una ruta alterna.

Instalación en macOS «Sonoma» y versiones anteriores

La instalación de Miniconda, al igual que con Anaconda, es simple. Descargar el instalador, ejecutar y listo. En la página de Miniconda, se ofrecen varias opciones, según el sistema operativo. Para el caso de macOS, al 2019.10.06 se contaban con instaladores por script de BASH o de paquete macOS tanto para Python 2.7 como 3.7. Hoy sólo se ofrece la instalación con Python 3 para procesadores intel o Apple Silicon.

A raíz de la incorporación del SIP (System Integrity Protection) hay algunas consideraciones a tener en cuenta, ya que parece haber ciertas restricciones sobre rutas usualmente disponibles para el usuario pero que es mejor no dar por hecho que uno podrá escribir en ellas, como es el caso de /user/local.

Personal y tradicionalmente he hecho uso del instalador basado en el «formato de paquete nativo» de macOS. Conviene anotar que, si se selecciona la instalación sólo para el usuario desde donde se corre el proceso de instalación, Miniconda se instalará en $HOME/opt/miniconda3, sin posibilidad de cambiar esta ruta. Si se selecciona la opción de ser instalado para todos los usuarios en el equipo, se preguntará por un folder destino y ahí se creará el mencionado directorio miniconda3.

Tipos de instalación

Una instalación general es aquella en la que se instala miniConda para estar disponible para todos los usuarios del equipo. Para el caso de macOS, esto implica que la instalación se hace en /Applications. Sin embargo, ya puede leerse en la página de Miniconda la recomendación sobre la instalación local, que se lleva a cabo únicamente para el usuario que la realiza y sólo para él queda disponible la versión de miniConda instalada en el directorio $HOME/Applications. La forma en la que esto último se logra es indicando el destino de la instalación, indicando el path o señalando la opción a elegir a través del instalador o script de instalación.

Mantenimiento

Cambio de una instalación local a una general

Ya sea que una instalación general se haya hecho o se contemple para hacerse posteriormente, este cambio implica: a) conservar o eliminar los ambientes ya creados, y b) eliminar la instalación local. Para el primer punto, si no se buscará conservar los entornos ya creados, bastará eliminar $HOME/.conda. Para el segundo punto, seguir las instrucciones de la sección «Desinstalación«.

Finalmente, si no se ha hecho, proceder con el ajuste de la variable PATH en el .bash_profile. La ruta, que seguramente apuntaba a $HOME/Application/miniconda3, deberá ser ajustada para que ahora sea /Application/miniconda3.

Actualización de conda y del entorno base

El mismo conda, mediante conda update --all, podría indicar que existe una actualización, por ejemplo:

==> WARNING: A newer version of conda exists. <==
  current version: 22.9.0
  latest version: 24.3.0

y sugerir el comando conda update -n base -c defaults conda. Sin embargo, al menos con la versión reportada en el warning, el comando no parece tener efecto (salvo que los paquetes de actualización se reportan ya descargados). Para lograr la actualización se usó:

$ conda update -n base -c defaults conda --repodata-fn=repodata.json

La versión de Python del entorno base

La instalación de Miniconda incluye una distribución de Python. La actualización del entorno base parece no tomarlo en cuenta y, de hecho, hay algunas personas que indican (según ellos la misma documentación de conda lo señala pero no he podido encontrar explicitamente la advertencia) no meterse con ésta. Aunque parece factible también poder actualizarla, lo cierto es que tiene más sentido no hacerlo (ya que de hecho uno puede crear cualquier otro entorno con la versión que uno quiera) al considerar que el mismo conda pudiera tener una cierta dependencia de distribución con la versión de conda que se incluyó con la instalación. De necesitar actualizarla, mi recomendación es proceder con una desinstalación y reinstalar nuevamente.

Desinstalación

La desinstalación de miniConda no es diferente al de Anaconda, sin embargo, puntualmente tenemos:

Dado que miniConda no es una aplicación de macOS (es decir no es un bundle de componentes de software como el caso de aquellas que se instalan en /Applications o en $HOME/Applications) a través del Package Installer, debe tenerse especial cuidado si se va a emplear un desinstalador.
miniConda es una aplicación de tipo unix. Un desinstalador puede llegar a considerar que componentes que miniConda administra (como Python 2.7) deben ser desinstalados y esto puede comprometer la integridad del sistema operativo (válido para versiones anteriores a macOS 12.3). Cualquiera que haya sido la opción tomada, conviene revisar algunas otras localidades para eliminar algunos residuos^3,4.

Con esto en consideración, conviene leer a detalle las instrucciones de desinstalación que el desarrollador incluye en su documentación, antes de proceder con lo que que se indica en las siguientes secciones, de acuerdo al tipo de desinstalación que se llevará a cabo.

Desinstalación asistida

Si se opta por la opción de hacer uso de un script, opción o aplicación que deshaga la instalación de miniConda, considerar:

Cuidado a tener por no desinstalar Python 2.7 en versiones anteriores a macOS 12.3.
Si se opta por hacer uso del paquete de desinstalación de conda^1,2, éste lleva a generar un respaldo de varios elementos. Si se está desinstalando por hacerse de espacio, el respaldo generado por el desinstalador actuará en nuestra contra.

Para usar el paquete de desinstalación de conda, éste debe decargarse primero y luego ejecutarse:

$ conda install anaconda-clean
$ anaconda-clean

Desinstalación manual

Si se opta por remover manualmente a miniConda se puede proceder por hacerlo via el Finder

Remover el directorio creado; e.g. para la versión 3 en un entorno unix^1,2.

$ rm -rf <path>/miniconda3

Para el caso de macOS, la documentación (que por cierto hace referencia a una instalación local y no general) de Conda (que aplica tanto para Anaconda o Miniconda) indica que deben borrarse cuatro directorios (el de instalación, más los abajo señalados), los cuales no necesariamente se crearán⁵ todos ellos.
En ~/.conda se mantiene la información de los ambientes (environments) creados. Si todos o alguno de éstos se necesitarán posteriormente, conviene conservarlos en un respaldo.

$ rm -rf ~/.condarc ~/.conda ~/.continuum ~/.anaconda

Adicionalmente:

se recomienda que los profiles sean editados para manualmente retirar lo que la instalación de conda agregó en ellos y, en general, se debe proceder con cuidado en ello (abajo se listas los posibles profiles tocados en la instalación, seleccionar el adecuado).

$ cd $HOME
$ vi .bash_profile .tcshrc .xonshrc .zshrc .config/fish/config.fish

Y el directorio .local debe ser revisado para selectivamente borrar elementos y conservar lo que se necesite.

Finalmente, se eliminan los posibles directorios que pudieron ser creados:

$ cd $HOME
$ rm -rf opt/miniconda3 Applications/miniconda3 Applications/opt/miniconda3 Library/Receipts/io.continuum* /Applications/miniconda3 /Applications/opt/miniconda3 /opt/miniconda3

Y, por cualquier cosa, se reinicia al equipo.

Linux

Instalación

Se hace una instalación local para el usuario que la realiza y sólo para él queda disponible en el directorio $HOME/. La forma en la que esto se logra es indicando el destino de la instalación, indicando el path o señalando la opción a elegir a través del instalador o script de instalación.

Windows

En general, existen dos opciones para realizar la instalación de MIniconda en Windows: con un instalador o desde la línea de comando. Algunas consideraciones pueden aplicar por el entorno en el que se ejecuta Windows.

Para ambas opciones, la descarga de lo necesario se hará desde la correspondiente página del producto. Puede resultar algo confuso el que se muestre instaladores para diferentes plataformas bajo un encabezado de «latest» y que más abajo aparezcan varios otros instaladores para estas plataformas. Estos últimos se ofrecen por si alguien desea tener una instalación base con una versión específica de Python. De éstos, la versión más reciente que ahí aparezca, corresponde a la que se ofrece en «latest«.

Parallels

Para el caso de un Windows 11 en máquina virtual corriendo en Parallels, la instalación se llevó a cabo usando un instalador.

Instalación

Abajo se muestran las imágenes del proceso de instalación (clic) para hacer zoom en ellas. Se muestra: a) el instalador descargado, b–k) el proceso de instalación. Un punto a cuidar es el de revisar si la ruta de instalación propuesta (e) es la adecuada (y de no hacerlo, hacer el ajuste adecuado, f y g); de las opciones de instalación, las que se dan por defecto son las adecuadas (h), y al finalizar el proceso de instalación, si no están seleccionados los atajos (k), marcarlos.

Desinstalación

Para desinstalar en Windows, basta buscar en donde se instaló Miniconda, el archivo Uninstall-Miniconda3.exe, ejecutarlo y seguir las indicaciones del desinstalador.

Azure Virtual Desktop

Azure Virtual Desktop (AVD), anteriormente conocido como Windows Virtual Desktop (WVD), es un sistema basado en Microsoft Azure para la virtualización de sistemas operativos Windows que proporciona escritorios y aplicaciones virtualizados de forma segura en la nube (a través de Internet) mediante el protocolo de escritorio remoto (RDP). Está dirigido a clientes empresariales en lugar de a usuarios particulares.

Instalación

Aquí se muestra el proceso seguido en la instalación de Miniconda en un entorno virtualizado en la nube de Microsoft haciendo uso de la aternativa de línea de comando. Si bien no deberían haber diferencias en lo que al sistema operativo se refiere, las políticas de seguridad en un entorno empresarial pueden imponer algunas dificultades.

… en desarrollo

Uso

Un prontuario de comandos y buenas prácticas.

Actualización de la instalación

Hay que distinguir entre la actualización de conda y la actualización de los entornos creados con éste⁷. Para actualizar a conda usar:

$ conda update -n base conda

Para actualizar un entorno, esto puede ser porque se debe actualizar un paquete:

$ conda update -n <entorno> <paquete>

o para actualizar a todo el entorno:

$ conda update -n <entorno> --all -y

Troubleshooting

Esta es una relación de diversas dificultades, acciones de corrección, soluciones o alternativas.

Dificultades para crear entornos virtuales en una plataforma empresarial

Para el caso de un entorno Windows 11 Enterprise (version 23H2) en AVD, al intentar crear un entorno de Conda en Command Prompt, se obtuvieron los mensaje de error que se muestran a continuación:

...
(base) C:\Users\erodrig1\Documents\Model2>conda create -n sdv python=3.10
Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1032)'))': /pkgs/main/terms.json

Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1032)'))': /pkgs/main/terms.json

...

ERROR conda.notices.fetch:get_channel_notice_response(72): Request error <HTTPSConnectionPool(host='repo.anaconda.com', port=443): Max retries exceeded with url: /pkgs/r/notices.json (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1032)')))> for channel: defaults url: https://repo.anaconda.com/pkgs/r/notices.json
failed

CondaError: KeyboardInterrupt

Terminate batch job (Y/N)? y

(base) C:\Users\erodrig1\Documents\Model2>

En la determinacoión de las posibles causas del problema, se ha procedido primero a revisar si no hay un proxy de por medio y si HTTPS funciona bien.

(base) C:\Users\erodrig1\Documents\Model2>set | findstr -i proxy

(base) C:\Users\erodrig1\Documents\Model2>netsh winhttp show proxy

Current WinHTTP proxy settings:

    Direct access (no proxy server).


(base) C:\Users\erodrig1\Documents\Model2>curl https://repo.anaconda.com/pkgs/main/terms.json
{
  "version": "2025-07-15T11:00:00Z",
  "text": "ANACONDA TERMS OF SERVICE\nEffective Date: July 15, 2025\n\nSee https://anaconda.com/legal/terms/terms-of-service",
  "support": "https://support.anaconda.com/"
}

Los resultados muestran que no hay un proxy y que no se trata de un problema por un certificado faltante. Un segundo paso es verificar cualquier posible dificultad de Conda con SS., revisando su estado de uso y probando desactivándolo, que es lo que en este caso funcionó:

...
(base) C:\Users\erodrig1\Documents\Model2>conda config --show ssl_verify
ssl_verify: True

(base) C:\Users\erodrig1\Documents\Model2>conda config --set ssl_verify false

(base) C:\Users\erodrig1\Documents\Model2>conda create -n sdv python=3.10
Retrieving notices: / C:\Users\erodrig1\AppData\Local\miniconda3\Lib\site-packages\urllib3\connectionpool.py:1097: InsecureRequestWarning: Unverified HTTPS request is being made to host 'repo.anaconda.com'. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/latest/advanced-usage.html#tls-warnings
  warnings.warn(
\ C:\Users\erodrig1\AppData\Local\miniconda3\Lib\site-packages\urllib3\connectionpool.py:1097: InsecureRequestWarning: Unverified HTTPS request is being made to host 'repo.anaconda.com'. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/latest/advanced-usage.html#tls-warnings
  warnings.warn(
/ C:\Users\erodrig1\AppData\Local\miniconda3\Lib\site-packages\urllib3\connectionpool.py:1097: InsecureRequestWarning: Unverified HTTPS request is being made to host 'repo.anaconda.com'. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/latest/advanced-usage.html#tls-warnings
  warnings.warn(
done
Channels:
 - defaults
Platform: win-64
Collecting package metadata (repodata.json): | C:\Users\erodrig1\AppData\Local\miniconda3\Lib\site-packages\urllib3\cons
  warnings.warn(
C:\Users\erodrig1\AppData\Local\miniconda3\Lib\site-packages\urllib3\connectionpool.py:1097: InsecureRequestWarning: Uns
  warnings.warn(
| C:\Users\erodrig1\AppData\Local\miniconda3\Lib\site-packages\urllib3\connectionpool.py:1097: InsecureRequestWarning: s
  warnings.warn(
C:\Users\erodrig1\AppData\Local\miniconda3\Lib\site-packages\urllib3\connectionpool.py:1097: InsecureRequestWarning: Uns
  warnings.warn(
/ C:\Users\erodrig1\AppData\Local\miniconda3\Lib\site-packages\urllib3\connectionpool.py:1097: InsecureRequestWarning: s
  warnings.warn(
C:\Users\erodrig1\AppData\Local\miniconda3\Lib\site-packages\urllib3\connectionpool.py:1097: InsecureRequestWarning: Uns
  warnings.warn(
done
Solving environment: done


==> WARNING: A newer version of conda exists. <==
    current version: 26.3.2
    latest version: 26.5.3

Please update conda by running

    $ conda update -n base -c defaults conda



## Package Plan ##

  environment location: C:\Users\erodrig1\AppData\Local\miniconda3\envs\sdv

  added / updated specs:
    - python=3.10


The following packages will be downloaded:

    package                    |            build
    ---------------------------|-----------------
    ca-certificates-2026.5.14  |       haa95532_0         107 KB
    libexpat-2.8.2             |       hd7fb8db_1         125 KB
    libffi-3.4.8               |       h42d73b9_3         118 KB
    libzlib-1.3.2              |       h1c6eee0_0          63 KB
    openssl-3.5.7              |       hbb43b14_0         8.9 MB
    packaging-26.0             |  py310haa95532_0         166 KB
    pip-26.1.2                 |     pyhc872135_0         1.1 MB
    python-3.10.20             |       hb00fc5c_1        15.3 MB
    setuptools-82.0.1          |  py310haa95532_0         1.2 MB
    sqlite-3.53.2              |       hee5a0db_0         944 KB
    tzdata-2026b               |       he532380_0         118 KB
    vc-14.3                    |      h2df5915_12          16 KB
    vc14_runtime-14.44.35208   |      h4927774_12         664 KB
    vs2015_runtime-14.44.35208 |      ha6b5a95_12          16 KB
    wheel-0.47.0               |  py310haa95532_0          81 KB
    zlib-1.3.2                 |       h1c6eee0_0         828 KB
    ------------------------------------------------------------
                                           Total:        29.8 MB

The following NEW packages will be INSTALLED:

  bzip2              pkgs/main/win-64::bzip2-1.0.8-h2bbff1b_6
  ca-certificates    pkgs/main/win-64::ca-certificates-2026.5.14-haa95532_0
  libexpat           pkgs/main/win-64::libexpat-2.8.2-hd7fb8db_1
  libffi             pkgs/main/win-64::libffi-3.4.8-h42d73b9_3
  libzlib            pkgs/main/win-64::libzlib-1.3.2-h1c6eee0_0
  openssl            pkgs/main/win-64::openssl-3.5.7-hbb43b14_0
  packaging          pkgs/main/win-64::packaging-26.0-py310haa95532_0
  pip                pkgs/main/noarch::pip-26.1.2-pyhc872135_0
  python             pkgs/main/win-64::python-3.10.20-hb00fc5c_1
  setuptools         pkgs/main/win-64::setuptools-82.0.1-py310haa95532_0
  sqlite             pkgs/main/win-64::sqlite-3.53.2-hee5a0db_0
  tk                 pkgs/main/win-64::tk-8.6.15-hf199647_0
  tzdata             pkgs/main/noarch::tzdata-2026b-he532380_0
  ucrt               pkgs/main/win-64::ucrt-10.0.22621.0-haa95532_0
  vc                 pkgs/main/win-64::vc-14.3-h2df5915_12
  vc14_runtime       pkgs/main/win-64::vc14_runtime-14.44.35208-h4927774_12
  vs2015_runtime     pkgs/main/win-64::vs2015_runtime-14.44.35208-ha6b5a95_12
  wheel              pkgs/main/win-64::wheel-0.47.0-py310haa95532_0
  xz                 pkgs/main/win-64::xz-5.8.2-h53af0af_0
  zlib               pkgs/main/win-64::zlib-1.3.2-h1c6eee0_0


Proceed ([y]/n)? y


Downloading and Extracting Packages:

Preparing transaction: done
Verifying transaction: done
Executing transaction: done
#
# To activate this environment, use
#
#     $ conda activate sdv
#
# To deactivate an active environment, use
#
#     $ conda deactivate


Channel "defaults" has the following notices:
  [info] -- Tue Jun  9 00:00:00 2026
  PyTorch 2.12 with CUDA support is now available to install with your current channel (Anaconda Main). Learn more: htts

(base) C:\Users\erodrig1\Documents\Model2>conda config --set ssl_verify true

Referencias

«Uninstalling Anaconda«, Continuum Analytics, Anaconda Documentation, web. Published: 2017; Consulted: 2019.07.06. URL: http://docs.continuum.io/anaconda/install/uninstall/.
«Uninstalling Anaconda or Miniconda«, Continuum Analytics, web. Published: 2017; Consulted: 2019.07.06. URL: https://docs.conda.io/projects/conda/en/latest/user-guide/install/linux.html.
«How to uninstall mini conda?«, StackOverflow, web. Asked: 2015.04.13, Asked: 2015.04.13, Visited: 2019.07.06. URL: https://stackoverflow.com/questions/29596350/how-to-uninstall-mini-conda-python.
«How does one uninstall miniconda?«, Quora, web. Answered: 2019.09.18, Visited: 2019.07.06. URL: https://www.quora.com/How-does-one-uninstall-miniconda.
«Installing on macOS«, Conda, web. Visited: 2021.03.02. URL: https://conda.io/projects/conda/en/latest/user-guide/install/macos.html.
«Do I need to update conda?«, Anaconda Community, web forum. Asked: 2023.04.26; answered: 2023.08.31; visited: 2024.03.29. URL: https://community.anaconda.cloud/t/do-i-need-to-update-conda/54664
«Updating conda and Anaconda«, Anaconda Documentation, web. Visited: 2024.07.06. URL: https://docs.anaconda.com/anaconda/install/update-version/
«Installing Miniconda«, anaconda.com, web. Visited: 2026.04.30. URL: https://www.anaconda.com/docs/getting-started/miniconda/install/overview.

Archivo

Historial de la página

Creación: 2019.06.09
Última actualización: 2026.07.06
Footer: v3.03.01

El contenido de este sitio puede ser copiado y reproducido libremente, siempre que no se altere y se cite su origen. Las marcas y productos registrados se citan como referencia, sin fines de lucro ni dolo. Todas las opiniones son a título personal del o de los autores y, salvo que se exprese lo contrario, deben considerarse un registro y una expresión de la experiencia de uso de aquello sobre lo que tratan. Para conocer más sobre la posición de privacidad y responsabilidad respecto de lo que se presenta en este sitio web y de cómo se ha obtenido, consulte la declaración correspondiente.

Dr. Edu

Sitio web de un informático y amante de la ciencia en general

Miniconda

Introducción

macOS

Instalación

Instalación en macOS «Tahoe»

Instalación en macOS «Sequoia»

Instalación en macOS «Sonoma» y versiones anteriores

Tipos de instalación

Mantenimiento

Cambio de una instalación local a una general

Actualización de conda y del entorno base

La versión de Python del entorno base

Desinstalación

Desinstalación asistida

Desinstalación manual

Linux

Instalación

Windows

Parallels

Instalación

Desinstalación

Azure Virtual Desktop

Instalación

Uso

Actualización de la instalación

Troubleshooting

Dificultades para crear entornos virtuales en una plataforma empresarial

Referencias

Archivo