git404hub

what is mac-dev-setup fr?

nicolashery/mac-dev-setup — explained in plain English

Analysis updated 2026-06-26

5,748ShellAudience · developerComplexity · 1/5Setup · easy

tl;dr

A step-by-step written guide for setting up a full programming environment on a Mac from scratch, covering Homebrew, Git, VS Code, Python, Node.js, and databases, explained for beginners.

vibe map

mindmap
  root((Mac Dev Setup))
    Steps
      System preferences
      Security settings
      Terminal setup
    Core tools
      Homebrew
      Git
      VS Code
    Languages
      Python with pyenv
      Node.js
      Ruby
    Databases
      PostgreSQL
      Redis
      Elasticsearch

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Set up a Mac from scratch with all the tools needed for web or Python development.

VIBE 2

Install and configure Homebrew, Git, and VS Code in one guided session.

VIBE 3

Set up pyenv to manage multiple Python versions without conflicts.

VIBE 4

Get PostgreSQL and Redis running locally for backend app development.

what's the stack?

ShellHomebrewGitPythonNode.js

how it stacks up fr

nicolashery/mac-dev-setuptensorchord/awesome-llmopsgliderlabs/docker-alpine
Stars5,7485,7795,705
LanguageShellShellShell
Setup difficultyeasyeasyeasy
Complexity1/51/51/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 1h+

This is a manual step-by-step guide, not an automated install script, plan for an hour or more to work through it.

in plain english

This repository is a written guide for setting up a programming environment on a Mac from scratch. It was originally written for friends who were new to programming on macOS and has grown into a personal reference document that the author keeps updated. The guide walks through the process step by step: updating the operating system, adjusting system preferences, enabling basic security settings like full-disk encryption, and then installing the tools a developer typically needs. It starts with iTerm2 (a terminal application with more features than the default one), then moves through Homebrew (a package manager that makes installing software from the terminal much easier), Git (for version control), Visual Studio Code, Python, Node.js, Ruby, PostgreSQL, Redis, and Elasticsearch. For each tool, the guide explains what it is in plain terms, then gives the actual commands to run or steps to follow. It also covers smaller quality-of-life details: setting up a more readable terminal prompt with colors, creating useful command shortcuts called aliases, and using a tool called pyenv to manage multiple Python versions without them conflicting. The guide is a document, not an automated script. You follow it manually rather than running a single install command. This means you understand what each step does and can skip anything you do not need. The author notes that not every tool listed is necessary for every project, but having them set up tends to be useful eventually. The steps were originally tested on macOS High Sierra and the author notes they should work on more recent versions. The repository also includes shell configuration files (.bash_profile.bash_prompt.aliases) that can be downloaded as a starting point for your own terminal setup.

prompts (copy fr)

prompt 1
I just got a new Mac and want to set up a Python dev environment. Walk me through installing Homebrew, pyenv, and the latest Python version.
prompt 2
Show me how to configure iTerm2 with a colorful prompt and useful shell aliases, following the mac-dev-setup guide.
prompt 3
How do I install and run PostgreSQL locally on a Mac using Homebrew? Give me the commands and how to connect to it.
prompt 4
What .bash_profile and alias settings from mac-dev-setup are most useful for a JavaScript developer working with Node.js?

Frequently asked questions

what is mac-dev-setup fr?

A step-by-step written guide for setting up a full programming environment on a Mac from scratch, covering Homebrew, Git, VS Code, Python, Node.js, and databases, explained for beginners.

What language is mac-dev-setup written in?

Mainly Shell. The stack also includes Shell, Homebrew, Git.

How hard is mac-dev-setup to set up?

Setup difficulty is rated easy, with roughly 1h+ to a first successful run.

Who is mac-dev-setup for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.