---
# System prepended metadata

title: 'Part 1: Installing Atom IDE'
tags: [PyCom, ESP32, TA Stuff ESP32, Heltec]

---

# Part 1: Installing Atom IDE
###### tags: `TA Stuff ESP32` `PyCom` `Heltec` `ESP32`

In this tutorial, we walk you through the basic installation of the development environment, if you choose to use Atom as your development IDE, you should follow this tutorial. 
You will:
* install Node js (needed for the plugin)
* install the Atom IDE 
* add the **Pymakr** plugin to your Atom

We'll continuously update this walkthrough. **Is there anything missing or unclear, or have you experienced some issue? Please add a comment.** You do this by highlighting the text and then you can write a comment on the highlighted part. You need to log in/create an account on HackMD first.  

## 0. Prerequisites
To finish this tutorial you need:
* Your computer (Windows, Linux, or Mac)
* Internet connection  

:::info
**Depending on your operating system follow one of the following sections.**
:::  

### [Windows](#Windows-OS)
### [Mac](#Mac-OS)
### [Linux](#Linux-OS-(Ubuntu-22.04))

## Windows OS
Follow these steps:
+ **Step 1:** Download and install [**Node js (here)**](https://nodejs.org/en/).
+ **Step 2:** Download and install [**Atom (here)**](https://atom.io/).
+ **Step 3:** Open Atom and the package manager from: `File >> Settings >> Install`.
+ **Step 4:** Look for **Pymakr** and Install it. (It takes a while; wait until shows it is successfully installed) 
![](https://i.imgur.com/7hNyP8q.png)  

:::success
You are now ready to move to the next tutorial to update your device firmware and try a simple example.
:::
## Mac OS
Follow these steps:
+ **Step 1:** Download and install [**Node js (here)**](https://nodejs.org/en/).
+ **Step 2:** Download and install [**Atom (here)**](https://atom.io/).
![](https://i.imgur.com/FAT0fXu.png =200x)
+ **Step 3:** Open Atom and the package manager from: `Atom >> Preferences >> Install`.
+ **Step 4:** Look for **Pymakr** and Install it. (It takes a while; wait until shows it is successfully installed) 
![](https://i.imgur.com/7hNyP8q.png)  


:::success
You are now ready to move to the next tutorial to update your device firmware and try a simple example.
:::

## Linux OS (Ubuntu 22.04)
Follow these steps:
+ **Step 1:** Open `Terminal` and execute these commands:
```shell=
sudo apt -y update
sudo apt -y upgrade
sudo apt install -y npm
```
+ **Step 2:** Download [**.deb file (here)**](https://atom.io/) and install **Atom** by right-clicking on the download file and choosing `Open with other application` then in the newly opened window choose `Software Install` after a while it opens a new window and you should press `Install` button to start installing at the end it shows you a success message. It should look like these screenshots: 
<br>
![](https://i.imgur.com/zPTXuu8.jpg) 
<Br>
![](https://i.imgur.com/n4CB2qq.jpg) 
<br>
![](https://i.imgur.com/5hbuH3M.jpg) 
<br><br>
+ **Step 3:** Open Atom and the package manager from: `File >> Settings >> Install`.
+ **Step 4:** Look for **Pymakr** and Install it. (It takes a while; wait until shows it is successfully installed) 
![](https://i.imgur.com/7hNyP8q.png)  
:::success
You are now ready to move to the next tutorial to update your device firmware and try a simple example.
:::


<style>

.markdown-body code{
    font-size: 1em !important;
}
.markdown-body .a{
    font-size: 5em !important;
}
.markdown-body pre {
    background-color: #333;
    border: 1px solid #333 !important;
    color: #dfdfdf;
    font-weight: 600;
}
.token.operator, .token.entity,
.token.url, .language-css .token.string,
.style .token.string {
    background: #000;
}
.markdown-body table {
    display: table;
    padding: 1em;
    width: 100%;
}
.markdown-body table th,
.markdown-body table td,
.markdown-body table tr {
    border: none !important;
}
.markdown-body table tr {
    background-color: transparent !important;
    border-bottom: 1px solid rgba(0, 0, 0, 0.2) !important;
}
</style>


