diff --git a/README.md b/README.md
index 0349dda..f7bc6b4 100644
--- a/README.md
+++ b/README.md
@@ -55,13 +55,31 @@ Built in collaboration: [@Letícia Sampietro](https://github.com/lesampietro) an
 
 ## 📂 How to Run
 
-### Clone the repository:
+### Prerequisites:
+Before building the project, make sure you have the readline library installed:
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get update
+sudo apt-get install libreadline-dev
+```
+
+**macOS:**
+```bash
+brew install readline
 ```
-bash
+
+### Clone and build:
+```bash
 git clone https://github.com/LilianMS/MiniShell.git
-cd minishell
+cd MiniShell
 make
 ```
+
+### Run the shell:
+```bash
+./minishell
+```
 ---
 <p align="right">
   <a href="#-minishell">🇺🇸</a> | <a href="#-minishell-em-português">🇧🇷</a>
@@ -116,10 +134,28 @@ Desenvolvido em colaboração: [@Letícia Sampietro](https://github.com/lesampie
 
 ## 📂 Como executar
 
-### Clonar o repositório:
+### Pré-requisitos:
+Antes de compilar o projeto, certifique-se de ter a biblioteca readline instalada:
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get update
+sudo apt-get install libreadline-dev
+```
+
+**macOS:**
+```bash
+brew install readline
 ```
-bash
+
+### Clonar e compilar:
+```bash
 git clone https://github.com/LilianMS/MiniShell.git
-cd minishell
+cd MiniShell
 make
 ```
+
+### Executar o shell:
+```bash
+./minishell
+```