Mi Configuración de MAC

Ultima actualización 15 / Abr / 2026

Este post es un documento vivo: refleja mi configuración actual de MAC, y se actualiza con el tiempo a medida que cambio herramientas o flujos de trabajo.

Introducción

Esta es la guía que utilizo para configurar una MAC desde cero para mi trabajo en proyectos de programación, ciencia de datos, machine learning e inteligencia artificial con Python. El proceso está dividido en dos grandes etapas: primero se instalan las herramientas base de desarrollo de software y luego las herramientas específicas para desarrollar con Python.

1. Instalar BREW

Homebrew es el gestor de paquetes para macOS. Permite instalar, actualizar y desinstalar software desde la terminal de forma sencilla.

Abrir el Terminal y ejecutar los siguientes comandos:

xcode-select --install

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

La terminal pedirá la clave de la MAC para completar la instalación.

Al terminar la instalación, el instalador muestra en pantalla un comando que se debe ejecutar para agregar brew al PATH (para que la terminal sepa dónde está el programa). Este comando es diferente en cada MAC, así que hay que copiar exactamente lo que aparece en la terminal y pegarlo para ejecutarlo.

2. Instalar iTerm2 con Oh My Zsh

iTerm2 es un emulador de terminal para macOS con muchas mejoras sobre el Terminal por defecto. Oh My Zsh es un framework para gestionar la configuración de Zsh que añade temas, plugins y autocompletado.

Yo utilizo Ghostty Terminal, que es una alternativa moderna a iTerm2, pero siempre configuro iTerm2 primero para tenerlo como base con Zsh

brew install --cask iterm2

Cerrar todo el terminal actual con la combinación de teclas (⌘ + Q) , abrir iTerm2 y ejecutar:

chsh -s /bin/zsh

Para hacer iTerm2 el terminal por defecto, seguir las instrucciones de: https://stackoverflow.com/questions/60210024/how-can-i-use-iterm-as-default-terminal-on-macos

Instalar Oh My Zsh para mejorar la experiencia de terminal con temas, plugins y autocompletado:

Abrir un nuevo terminal (debe abrir iTerm2) e instalar Oh My Zsh:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

3. Instalar herramientas para desarrollo en Python

UV es una herramienta moderna para gestionar versiones de Python, instalar paquetes y mantenerlos en ambientes virtuales aislados por proyecto.

brew update
brew install uv readline xz

Cerrar todo el terminal con (⌘ + Q) y volver a abrirlo.

4. Instalar versiones de Python

Instalar la versión (o versiones) de Python que se usarán en los proyectos. Con UV se pueden instalar múltiples versiones sin conflictos:

uv python install 3.12
uv python install 3.13

Cerrar todo el terminal con ⌘ + Q, abrirlo nuevamente y definir la versión de Python global por defecto (por ejemplo, Python 3.12):

uv python install --default 3.12
uv python update shell

5. Configurar Git

Git es el sistema de control de versiones estándar para el desarrollo de software.

Cerrar todo el terminal con ⌘ + Q, abrir iTerm2 y ejecutar:

brew install git

Configurar el nombre y correo que aparecerán en los commits:

git config --global user.name "Tu nombre"
git config --global user.email "micorreo@emailhost.com"
git config --global color.ui auto

Ejecutar este comando para evitar problemas al instalar hooks de pre-commit en ambientes virtuales:

git config --global --unset-all core.hooksPath

Aplicaciones Base

Aplicaciones Base que uso :

Ghostty Terminal (terminal alternativo moderno):
```
brew install --cask ghostty
```
Visual Studio Code — editor de código y notebooks Jupyter: Seguir las instrucciones en https://code.visualstudio.com/docs/setup/mac
Rectangle — para organizar las ventanas en la pantalla:
```
brew install --cask rectangle
```

Limpiar espacio en disco

Cada vez que Luego de varios meses de uso, es recomendable hacer una limpieza del espacio en disco ejecutando desde la terminal:

Homebrew

brew autoremove && brew cleanup --prune=all

UV
```
uv cache clean
```
Pre-commit
```
pre-commit clean
```
Docker
```
docker system prune -a
```

Si se usa Hugging Face para descargar modelos de machine learning:

Hugging Face
```
hf cache clear
```

Si usas poetry para gestionar proyectos de Python, se recomienda migrar a UV. Si aún lo usas, puedes limpiar su cache con:

poetry cache clear --all ""