diff --git a/scripts/gdb/.python-version b/scripts/gdb/.python-version
new file mode 100644
index 0000000000..c8cfe39591
--- /dev/null
+++ b/scripts/gdb/.python-version
@@ -0,0 +1 @@
+3.10
diff --git a/scripts/gdb/README.md b/scripts/gdb/README.md
index 2f5eb59e85..8f0678649d 100644
--- a/scripts/gdb/README.md
+++ b/scripts/gdb/README.md
@@ -2,6 +2,23 @@
 
 lvglgdb is a GDB script for LVGL.
 
+# Installation
+
+```bash
+pip install lvglgdb
+```
+
+# Simple Usage
+
+In your GDB session, run:
+```bash
+py import lvglgdb
+
+dump obj
+dump cache image
+dump cache image_header
+```
+
 # Structure
 
 ```mermaid
diff --git a/scripts/gdb/pyproject.toml b/scripts/gdb/pyproject.toml
new file mode 100644
index 0000000000..307ab6275f
--- /dev/null
+++ b/scripts/gdb/pyproject.toml
@@ -0,0 +1,17 @@
+[project]
+name = "lvglgdb"
+version = "0.1.1"
+description = "LVGL GDB scripts"
+readme = "README.md"
+requires-python = ">=3.10"
+
+dependencies = [
+    "numpy~=2.2.6",
+    "Pillow~=11.3.0",
+    "prettytable~=3.16.0",
+]
+
+[project.urls]
+Homepage = "https://lvgl.io"
+Documentation = "https://docs.lvgl.io/master/details/debugging/gdb_plugin.html"
+Repository = "https://github.com/lvgl/lvgl"