Skip to content
All guides

Guide

Set up GitHub, Git, and a code editor

Step-by-step setup for beginners: create a GitHub account, turn on two-factor authentication, install Git, and choose a code editor.

You need three things before your first contribution: a GitHub account, Git on your computer, and a code editor. This guide walks through each one. None of them cost anything.

1. Create your GitHub account

  • Go to github.com and choose Sign up. Pick a username you are happy to show employers; it appears on everything you contribute.
  • Verify your email address.
  • Add a profile picture or avatar, your name, and one line about what you are learning. A short, honest profile is better than an empty one.

2. Turn on two-factor authentication

Two-factor authentication (2FA) asks for a second code when you sign in, so a leaked password is not enough to take over your account. Many projects require it. In GitHub, open Settings, then Password and authentication, and enable two-factor authentication with an authenticator app. Save your recovery codes somewhere safe and offline.

3. Install Git

Git records changes to files on your own computer. Install it from git-scm.com, then tell Git who you are so your commits carry your name. In a terminal, run git config --global user.name followed by your name in quotes, and git config --global user.email followed by the email you use on GitHub.

4. Choose a code editor

A code editor is where you read and change code. Visual Studio Code is free and widely used, and it has built-in Git support. Any editor you are comfortable with is fine.

Gentler options

  • GitHub Desktop: a free app that lets you clone, commit, and push with buttons instead of terminal commands.
  • GitHub Codespaces: a ready-made editor in your browser, so you do not have to install a project on your own computer.

When all of this works, you are ready to make a change and propose it. Next: your first pull request.