diff --git a/README.md b/README.md
new file mode 100644
index 0000000..93b7dab
--- /dev/null
+++ b/README.md
@@ -0,0 +1,101 @@
+<h1 align="center">Pico 2W Computer Power Controller</h1>
+
+<p align="center">
+    <img alt="Stars" src="https://img.shields.io/github/stars/Gabi-Zar/Pico-2W-Computer-Management?style=flat&color=magenta">
+    <img alt="Forks" src="https://img.shields.io/github/forks/Gabi-Zar/Pico-2W-Computer-Management?style=flat&color=purple">
+    <img alt="License" src="https://img.shields.io/github/license/Gabi-Zar/Pico-2W-Computer-Management?style=flat&color=BB0000">
+    <br>
+    <a href="https://github.com/Gabi-Zar">
+        <img title="Developer" src="https://img.shields.io/badge/developer-GabiZar-yellow">
+    </a>
+    <img alt="Written In" src="https://img.shields.io/badge/Written%20In-MicroPython-blue?logo=python">
+</p>
+
+---
+
+A lightweight MicroPython application for the Raspberry Pi Pico 2W that allows you to remotely power your computer on or off through a secure HTTPS web interface.
+
+## Features
+
+- HTTPS web server
+- Password authentication using HMAC-SHA256
+- Password is never transmitted over the network
+- Replay attack protection using one-time nonces
+- Direct connection to the motherboard's power switch (PW+ / PW−)
+- Automatic Wi-Fi reconnection
+- Lightweight and asynchronous implementation using `uasyncio`
+
+## Required Hardware
+
+- Raspberry Pi Pico 2W (Pico W should also work, but has not been tested)
+- PC817 optocoupler (or equivalent)
+- 220 Ω, 330 Ω or 470 Ω resistor
+- Jumper wires
+
+## Wiring
+
+<p align="center">
+    <img src="diagram.png">
+</p>
+
+The original power button from your computer case can remain connected in parallel with the Pico on PW+ and PW−.
+
+## Setup
+
+### 1. Install MicroPython
+
+Flash the latest MicroPython firmware onto your Pico following the official documentation:
+
+https://www.raspberrypi.com/documentation/microcontrollers/micropython.html
+
+### 2. Generate a self-signed HTTPS certificate
+
+```bash
+openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 3650 -nodes
+openssl x509 -in cert.pem -outform DER -out cert.der
+openssl rsa -in key.pem -outform DER -out key.der
+```
+
+### 3. Configure the project
+
+Create a `config.py` file using `config.example.py` as a template.
+
+### 4. Upload the files
+
+```bash
+mpremote fs cp main.py :main.py
+mpremote fs cp config.py :config.py
+mpremote fs cp cert.der :cert.der
+mpremote fs cp key.der :key.der
+mpremote reset
+```
+
+### 5. View logs
+
+```bash
+mpremote resume
+```
+
+The web interface is now accessible from your local network using the Pico's IP address.
+
+To access it from outside your network, you can configure port forwarding or place it behind a reverse proxy.
+
+## Security
+
+The web interface is protected using several mechanisms:
+
+- HTTPS encryption
+- HMAC-SHA256 authentication
+- One-time nonces to prevent replay attacks
+- Constant-time HMAC comparison
+- Request size limitation
+
+The password is never sent to the Pico. Instead, the browser computes an HMAC of a server-generated nonce using the password as the secret key.
+
+## License
+
+This project is licensed under the [GPL-3.0 license](LICENSE).
+
+---
+
+<p align="center">If you like this app, consider giving it a star on GitHub!</p>
diff --git a/config.exemple.py b/config.exemple.py
new file mode 100644
index 0000000..033d398
--- /dev/null
+++ b/config.exemple.py
@@ -0,0 +1,3 @@
+WIFI_SSID     = "Your wifi ssid"
+WIFI_PASSWORD = "Your wifi password"
+PASSWORD = "Secret code"
\ No newline at end of file
diff --git a/diagram.png b/diagram.png
new file mode 100644
index 0000000..0b1eb84
Binary files /dev/null and b/diagram.png differ