# Introduction

Welcome to gitutor. This tool will get you up and running using Git in the shortest time possible while learning on the go.

Gitutor is a command line application that wraps Git and provides beginner friendly versions of git's commands. It makes git easy.

In this tutorial you'll learn how tu use git with the aid of gitutor. Once you feel comfortable using git this way, read what is going on behind gitutor's commands on the last chapters.

The command line includes a summarized version of this tutorial so you'll always have it at hand. To access it run:

$ gt lesson 

Don't worry, if you forget how to use a command you just need to run

$ gt <command> --help

and a useful guide will be displayed.

If you have any problems please send us an email at support@gitutor.io or open an issue in our repo, we usually answer in less than a day.

# Installation guide

NOTE: pipx and gitutor work with Python3.6+

In order to use gitutor without any dependencies version conflicts we recommend installing it using pipx. Pipx creates a virtual environment for your package and exposes its entry point so you can run gitutor from anywhere.

To install pipx and configure the $PATH run the following commands

For Windows:

$ python -m pip install pipx
$ python -m pipx ensurepath

For MacOS use:

$ brew install pipx

For Linux use:

$ python3 -m pip install pipx
$ python3 -m pipx ensurepath

NOTE: You may need to restart your terminal for the path updates to take effect.

Once pipx is installed, run the following to install gitutor:

$ pipx install gitutor

And to upgrade gitutor to its latest version you only need to run:

$ pipx upgrade gitutor

To install gitutor without using pipx just run:

$ pip install gitutor

# Additional notes

Before using gitutor you need to have Git and Python 3.6 or higher available in your computer. You can check Git's installation guide here and Python's installation guide here.

It's also recommended to store your GitHub credentials so you won't have to authenticate everytime you realize a push or pull. You can do this by running:

$ git config --global credential.helper store

This will store your credentials in a plain-text file (.git-gredentials) under your project directory. If you don't like this you can use any of the following approaches:

On Mac OS X you can use its native keystore with:

$ git config --global credential.helper oskeychain

For Windows you can install a helper called Git Credential Manager for Windows and then run:

$ git config --global credential.helper manager