🏠 Dotfiles for Data Science

Personal configuration files and setup automation for macOS, optimized for data science workflows with Databricks, Azure, and Python development.

🚀 Quick Startotfiles

Personal configuration files and setup automation for macOS.

🚀 Quick Start

Automated Setup (Recommended)

# 1. Clone this repository
git clone https://github.com/serin-varghese/dotfiles.git ~/dotfiles
cd ~/dotfiles

# 2. Run the setup script
./setup.sh

# 3. Edit your local secrets
vim ~/.zshrc_local

# 4. Restart your shell
exec zsh

### Homebrew / Brewfile notes

- The `Brewfile` no longer includes explicit taps for `homebrew/bundle`, `homebrew/cask`, or `homebrew/core` — modern Homebrew provides bundle and cask functionality from core. This prevents tap-related errors you may see on newer Homebrew installations.
- The `setup.sh` script runs `brew bundle --file="$DOTFILES_DIR/Brewfile" --verbose` and captures output for easier diagnostics. If `brew bundle` fails, the script prints a helpful excerpt and exits with instructions.
- Some casks require user interaction or post-install setup (for example, Docker often needs you to open Docker.app and grant permissions). To skip such casks during an automated run, set `SKIP_CASKS` when running the script. Example:

```zsh
# Skip Docker during an automated run to avoid interactive prompts
SKIP_CASKS="docker" ./setup.sh

• To debug failures manually, run:

cd ~/dotfiles
brew update
brew bundle --file="$PWD/Brewfile" --verbose

Inspect the verbose output for missing taps, permission prompts, or license acceptance steps and share it if you want help fixing a specific failing item.

### Manual Setup

If you prefer to set things up manually:

#### 1. Install Xcode Command Line Tools

```bash
xcode-select --install

2. Install Homebrew

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

For Apple Silicon Macs, add Homebrew to PATH:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

3. Install packages

brew bundle

4. Install Zsh plugins

mkdir -p ~/.zsh
git clone https://github.com/zsh-users/zsh-autosuggestions ~/.zsh/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting ~/.zsh/zsh-syntax-highlighting

5. Create symlinks

# Zsh
	ln -sf ~/dotfiles/zsh/.zshrc ~/.zshrc
	cp ~/dotfiles/zsh/.zshrc_local.template ~/.zshrc_local

# Git
	ln -sf ~/dotfiles/git/.gitconfig ~/.gitconfig
	ln -sf ~/dotfiles/git/.gitconfig_mac ~/.gitconfig_mac
	ln -sf ~/dotfiles/git/.gitignore_global ~/.gitignore_global

# VSCode
	ln -sf ~/dotfiles/vscode/settings.json ~/Library/Application\ Support/Code/User/settings.json

6. Configure pip (Python package manager)

# Create pip config directory
mkdir -p ~/.config/pip

# Copy pip template and edit with your credentials
	cp ~/dotfiles/pip/pip.conf.template ~/.config/pip/pip.conf
vim ~/.config/pip/pip.conf

# Replace placeholders:
# <JFROG_USERNAME> - Your JFrog/Artifactory username
# <JFROG_TOKEN>    - Your JFrog/Artifactory API token

7. Configure secrets

Edit ~/.zshrc_local to add your:

• Proxy credentials (if needed)
• API keys
• Machine-specific configurations

---

📁 Structure

.
├── git/                         # Git configuration
│   ├── .gitconfig              # Main Git config
│   ├── .gitconfig_mac          # Mac-specific Git config
│   └── .gitignore_global       # Global gitignore
├── vscode/                      # VSCode settings
│   ├── settings.json           # Editor settings
│   └── extensions.json         # Recommended extensions
├── zsh/                         # Zsh configuration
│   ├── .zshrc                  # Main Zsh config
│   └── .zshrc_local.template   # Template for local secrets
├── pip/                         # Python pip configuration
│   └── pip.conf.template       # Template for pip settings (JFrog, proxies)
├── databricks/                  # Databricks configuration
│   └── .databrickscfg.template # Databricks CLI profiles
├── templates/                   # Project templates
│   ├── .env.template           # Environment variables (Azure, Databricks)
│   └── pyproject.toml          # Python project configuration
├── ubuntu/                      # Ubuntu-specific configs
│   └── .inputrc
├── .gitignore                   # Excludes secrets from git
├── .gitattributes               # Git attributes for data science files
├── .editorconfig                # Cross-editor coding style
├── .pre-commit-config.yaml      # Pre-commit hooks for code quality
├── Brewfile                     # Homebrew packages for data science
├── setup.sh                     # Automated setup script
└── README.md

---

🛠️ Tools Included

Shell & Terminal

• Zsh - Default shell
• Starship - Cross-shell prompt
• zsh-autosuggestions - Fish-like autosuggestions
• zsh-syntax-highlighting - Fish-like syntax highlighting

Modern CLI Tools

• eza - Modern replacement for ls with colors and icons
• bat - cat clone with syntax highlighting
• fd - Modern replacement for find
• ripgrep - Fast grep alternative
• fzf - Fuzzy finder

Development

• Git - Version control
• VSCode - Code editor
• Docker - Containerization
• Azure CLI - Azure command-line interface

Productivity

• Rectangle - Window management
• 1Password - Password manager
• iTerm2 - Terminal emulator

---

⚙️ Configuration Details

Zsh Features

• ✨ Modern prompt with Starship
• 🔍 History search with arrow keys
• � Fish-like autosuggestions
• 🎨 Syntax highlighting
• 📚 Persistent history across sessions

Custom Aliases

ll    # Detailed list (eza -la)
cc    # Go up one directory (cd ..)
alert # Play sound when command finishes

---

🔒 Security

Important: Never commit secrets to this repository!

• .zshrc_local is gitignored (contains secrets)
• pip/pip.conf is gitignored (contains JFrog credentials)
• Use .zshrc_local.template and pip/pip.conf.template as references
• Sensitive data should only exist in your local config files
• Always replace <PLACEHOLDERS> with actual values locally

---

🔄 Updating

Update Brewfile from current system

cd ~/dotfiles
brew bundle dump --force

Pull latest dotfiles

cd ~/dotfiles
git pull

Apply updates

# Re-run setup if needed
./setup.sh

# Or manually update specific configs
source ~/.zshrc

---

� Customization

1. Add more Homebrew packages: Edit Brewfile
2. Modify Zsh config: Edit zsh/.zshrc
3. Add local customizations: Edit ~/.zshrc_local
4. Update VSCode settings: Edit vscode/settings.json

---

🐛 Troubleshooting

Zsh plugins not working

# Reinstall plugins
rm -rf ~/.zsh/zsh-autosuggestions ~/.zsh/zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-autosuggestions ~/.zsh/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting ~/.zsh/zsh-syntax-highlighting
exec zsh

Homebrew issues

# Update Homebrew
brew update
brew doctor

Symlink conflicts

The setup.sh script automatically backs up existing files with a timestamp. Check for .backup.* files in your home directory.

---

Happy configuring! 🎉