diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0a3eede
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# musicbot-js
+
+Bot Discord de musique auto-hébergé, en Node.js et discord.js v14.
+
+## Stack
+
+- Node.js, discord.js v14
+- @discordjs/voice et FFmpeg pour l'audio
+- File d'attente persistante par serveur
+
+## Installation
+
+```
+npm install
+cp .env.example .env   # renseigner DISCORD_TOKEN
+node bot.js
+```
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..b2e61a6
--- /dev/null
+++ b/package.json
@@ -0,0 +1,18 @@
+{
+  "name": "musicbot-js",
+  "version": "1.0.0",
+  "description": "Discord music bot",
+  "main": "bot.js",
+  "type": "module",
+  "scripts": {
+    "start": "node bot.js"
+  },
+  "dependencies": {
+    "@discordjs/opus": "^0.9.0",
+    "@discordjs/voice": "^0.19.2",
+    "@noble/ciphers": "^2.2.0",
+    "discord.js": "^14.16.3",
+    "dotenv": "^16.4.5",
+    "libsodium-wrappers": "^0.7.15"
+  }
+}