01-first-steps.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# First Steps\n",
    "\n",
    "Notes from @audreyfeldroy / @ProfessorTerrence walkthrough Friday, 2023-10-06.\n",
    "\n",
    "## Introducing the Terminal\n",
    "\n",
    "The terminal is a text-based interface to your computer. It is a program that takes commands from the keyboard and gives them to the operating system to perform.\n",
    "\n",
    "Coders use it to:\n",
    "\n",
    "* Install tools like Homebrew, Python, FFmpeg, and Git\n",
    "* Run scripts and programs\n",
    "\n",
    "Sometimes it is called the command line, or the shell, or the command prompt. All of these are referring to the same thing.\n",
    "\n",
    "Let's practice using the terminal by opening it and running some commands.\n",
    "\n",
    "## Opening the Terminal\n",
    "\n",
    "### Mac\n",
    "\n",
    "Open the Terminal app by searching for it in Spotlight.\n",
    "\n",
    "### Windows\n",
    "\n",
    "Open the Git Bash app by searching for it in the Start Menu.\n",
    "\n",
    "### Linux\n",
    "\n",
    "Open the Terminal app by searching for it in the Applications menu."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Running Commands\n",
    "\n",
    "Try running the following commands in the terminal to see what they do:\n",
    "\n",
    "```bash\n",
    "ls -asl\n",
    "```\n",
    "\n",
    "```bash\n",
    "pwd\n",
    "```\n",
    "\n",
    "```bash\n",
    "cd data/\n",
    "```\n",
    "\n",
    "Then paste the command and output into your chat LLM and ask what happened."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Install Homebrew\n",
    "\n",
    "### Mac\n",
    "\n",
    "First install the Homebrew package manager by following the instructions at [brew.sh](https://brew.sh/).\n",
    "\n",
    "It will ask you to run a command in the terminal. Copy and paste the command into the terminal and press enter.\n",
    "\n",
    "If you're curious what this command does, you can paste it into [explainshell.com](https://explainshell.com/) or a chat LLM to learn more. Try it, it's fun!\n",
    "\n",
    "You may be asked to enter your password. If so, enter your password and press enter. You won't see anything appear on the screen as you type your password. This is normal.\n",
    "\n",
    "You may be asked to install the Xcode Command Line Tools. If so, click Install.\n",
    "\n",
    "## Install Python 3\n",
    "\n",
    "Then install Python 3 by running the following command in the terminal:\n",
    "\n",
    "```bash\n",
    "brew install python\n",
    "```\n",
    "\n",
    "Check that Python 3 is installed by running the following command in the terminal:\n",
    "\n",
    "```bash\n",
    "python3 --version\n",
    "```\n",
    "\n",
    "Try running the interactive Python 3 interpreter by running the following command in the terminal:\n",
    "\n",
    "```bash\n",
    "python3\n",
    "```\n",
    "\n",
    "You will see the prompt change to >>>. This means you are in the interactive Python 3 interpreter. You can type Python 3 code here and it will be executed immediately. Try executing these little Python code snippets:\n",
    "\n",
    "```python\n",
    "2 + 2\n",
    "```\n",
    "\n",
    "```python\n",
    "print('Hello, world!')\n",
    "```\n",
    "\n",
    "```python\n",
    "print(3 + 5)\n",
    "```\n",
    "\n",
    "To exit the interactive Python 3 interpreter, type exit() and press enter.\n",
    "\n",
    "If any of these steps failed, ask for help:\n",
    "* First, try telling an LLM like Poe.com or [Open Assistant](https://open-assistant.io/) what you tried and what happened.\n",
    "* If that doesn't work, ask for help in the #help channel in Discord"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": ".venv",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.11.4"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}