diff --git a/docs/img/social-preview.png b/docs/img/social-preview.png
new file mode 100644
index 0000000..93c66f0
Binary files /dev/null and b/docs/img/social-preview.png differ
diff --git a/docs/img/social-preview.svg b/docs/img/social-preview.svg
new file mode 100644
index 0000000..ed348e5
--- /dev/null
+++ b/docs/img/social-preview.svg
@@ -0,0 +1,63 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="640" viewBox="0 0 1280 640">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0d1117"/>
+      <stop offset="100%" style="stop-color:#161b22"/>
+    </linearGradient>
+    <linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#238636"/>
+      <stop offset="100%" style="stop-color:#2ea043"/>
+    </linearGradient>
+  </defs>
+  <rect width="1280" height="640" fill="url(#bg)"/>
+  <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
+    <path d="M 40 0 L 0 0 0 40" fill="none" stroke="#ffffff" stroke-width="0.15" stroke-opacity="0.05"/>
+  </pattern>
+  <rect width="1280" height="640" fill="url(#grid)"/>
+  <rect x="0" y="0" width="1280" height="4" fill="url(#accent)"/>
+  <ellipse cx="200" cy="300" rx="260" ry="220" fill="#238636" opacity="0.06"/>
+  <g transform="translate(20, 170) scale(0.13)">
+    <path transform="translate(0,0)" fill="rgb(1,1,1)" d="M 1175.6 14.4756 C 1239.21 15.254 1304.46 38.0917 1318.55 107.609 C 1331.2 117.036 1334.16 120.304 1334.64 136.16 C 1349.71 148.868 1358.82 162.794 1364.61 181.777 C 1372.68 207.743 1370.03 235.858 1357.25 259.857 C 1352.92 267.872 1338.33 290.756 1327.84 283.957 C 1325.94 278.933 1324.44 264.847 1323.64 258.843 C 1311.64 271.442 1300.75 275.619 1284.45 279.262 C 1269.14 321.568 1273.14 358.184 1274.68 402.496 C 1280.68 575.028 1143.25 725.765 974.897 748.892 C 952.55 751.961 923.416 750.412 900.083 750.378 L 780.776 750.474 L 577.674 1014.65 C 575.436 1017.52 573.07 1020.28 570.582 1022.94 C 543.879 1051.79 517.742 1054.51 481.261 1055.85 C 486.726 1045.96 497.601 1030.28 504.014 1019.85 L 558.508 930.918 L 604.821 855.704 C 612.854 842.791 623.219 825.162 632.148 813.409 C 612.077 824.289 591.637 834.475 570.865 843.951 C 585.095 819.476 604.273 790.926 619.672 765.987 L 730.409 585.739 L 827.291 427.611 C 843.788 400.656 860.365 373.102 877.137 346.339 C 885.394 333.162 905.09 316.916 916.524 305.289 C 936.701 284.773 953.358 266.548 968.724 242.045 C 980.989 222.081 991.207 200.93 999.223 178.913 C 1014.23 137.201 1020.37 99.8955 1053.53 65.9541 C 1088.89 29.7616 1126.87 16.5646 1175.6 14.4756 z" id="path2" />
+    <path transform="translate(0,0)" fill="rgb(139,213,25)" d="M 954.397 295.967 C 998.491 252.869 1017.4 195.883 1035.12 139.432 C 1050.4 90.7923 1095.38 47.6058 1146.05 39.5219 C 1159.99 37.2972 1176.71 34.9142 1191.11 36.8122 C 1233.75 39.3522 1283.18 60.6944 1296.61 104.784 C 1256.21 106.515 1240.94 143 1251.28 178.356 C 1240.6 208.054 1237.21 251.977 1263.46 274.799 C 1256.74 293.361 1252.43 307.305 1251.66 327.272 C 1252.05 401.249 1258.88 472.386 1223.29 540.605 C 1220.78 545.421 1212.14 564.795 1208.75 567.166 C 1204.04 577.779 1192.14 593.79 1184.83 602.942 C 1146.24 651.26 1095.33 688.262 1037.46 710.041 C 1021.65 716.103 994.513 723.918 977.491 725.65 C 962.77 728.201 943.163 728.001 928.032 727.994 L 851.494 727.853 C 836.992 727.831 816.468 727.299 802.483 729.015 C 826.1 717.571 856.79 698.759 880.849 690.373 C 882.16 688.525 900.659 679.759 904.515 677.851 L 965.703 647.138 C 1030.22 614.598 1068.55 589.682 1101.05 520.999 C 1139.87 438.969 1128.96 334.628 1035.16 298.335 C 1011.32 289.112 978.625 286.86 954.397 295.967 z" id="path3" />
+    <path transform="translate(0,0)" fill="rgb(245,193,18)" d="M 1191.11 36.8122 C 1233.75 39.3522 1283.18 60.6944 1296.61 104.784 C 1256.21 106.515 1240.94 143 1251.28 178.356 C 1240.6 208.054 1237.21 251.977 1263.46 274.799 C 1256.74 293.361 1252.43 307.305 1251.66 327.272 C 1249.9 330.062 1250.59 341.113 1250.67 345.075 L 1237.49 345.181 C 1176.77 344.996 1109.93 305.113 1121.76 236.381 C 1098.02 222.344 1079.7 201.95 1083.1 172.093 C 1084.83 156.284 1092.99 141.883 1105.66 132.27 C 1125.43 117.022 1144.35 117.402 1167.5 120.556 C 1170.98 112.602 1172.84 110.79 1179.91 105.69 C 1177.19 103.151 1171.27 92.1006 1170.13 88.4101 C 1164.13 68.9818 1167.21 54.4605 1175.55 37.0787 L 1191.11 36.8122 z" id="path4" />
+    <path transform="translate(0,0)" fill="rgb(1,1,1)" d="M 1179.91 105.69 C 1194.43 102.829 1209.67 105.575 1212.38 122.702 C 1213.38 129.042 1211.74 135.518 1207.84 140.612 C 1194.88 157.835 1168.74 148.821 1167.29 127.494 C 1167.14 125.18 1167.21 122.857 1167.5 120.556 C 1170.98 112.602 1172.84 110.79 1179.91 105.69 z" id="path5" />
+    <path transform="translate(0,0)" fill="rgb(162,227,48)" d="M 1250.67 345.075 C 1250.59 341.113 1249.9 330.062 1251.66 327.272 C 1252.05 401.249 1258.88 472.386 1223.29 540.605 C 1220.78 545.421 1212.14 564.795 1208.75 567.166 C 1207.58 562.56 1231.55 515.644 1233.96 508.474 C 1236.11 502.037 1236.11 496.046 1238.19 489.495 C 1243.18 473.774 1244.87 457.939 1245.85 441.602 C 1246.38 432.851 1248.57 423.232 1248.84 414.115 C 1249.39 396.116 1248.99 378.873 1246.89 361.024 C 1246.4 356.909 1247.87 348.911 1246.62 346.492 L 1237.49 345.181 L 1250.67 345.075 z" id="path6" />
+    <path transform="translate(0,0)" fill="rgb(162,227,48)" d="M 802.483 729.015 C 826.1 717.571 856.79 698.759 880.849 690.373 C 876.257 697.471 856.397 704.088 849.124 708.817 C 839.587 715.018 844.772 715.986 831.734 718.697 L 833.598 718.943 L 833.741 720.301 C 828.464 724.474 824.536 719.51 823.485 724.135 C 834.909 723.954 976.185 725.167 977.491 725.65 C 962.77 728.201 943.163 728.001 928.032 727.994 L 851.494 727.853 C 836.992 727.831 816.468 727.299 802.483 729.015 z" id="path7" />
+    <path transform="translate(0,0)" fill="rgb(139,213,25)" d="M 974.353 312.338 C 991.065 311.198 1002.46 311.571 1018.77 316.397 C 1047.99 324.866 1072.52 344.818 1086.76 371.693 C 1105.37 406.387 1102.02 448.605 1091.26 485.148 C 1078.61 528.127 1048.37 571.438 1011.3 596.638 C 995.659 607.272 975.458 617.722 958.58 626.649 C 975.261 603.68 996.619 566.688 1011.64 542.019 C 1003.19 542.14 994.567 542.06 986.1 542.073 C 977.314 556.356 928.643 638.119 920.858 644.068 C 913.437 649.738 903.479 653.657 895.104 657.847 C 879.191 665.684 863.368 673.702 847.637 681.9 C 856.956 669.722 869.567 648.652 878.158 635.109 L 936.839 541.975 L 910.177 542.054 C 891.396 572.541 872.413 602.901 853.227 633.135 C 839.618 654.507 824.608 677.092 812.198 699.054 C 794.609 709.525 766.614 722.855 747.686 732.461 L 736.187 738.034 C 746.369 725.758 766.109 692.422 775.305 678.097 C 804.129 633.201 831.613 586.893 860.405 541.924 L 834.358 542.269 C 789.753 609.78 748.192 684.274 702.931 751.672 C 698.94 757.614 640.65 785.138 629.946 790.48 C 636.418 782.554 645.959 765.751 651.674 756.31 L 683.549 704.32 L 836.69 455.113 C 848.717 435.649 860.562 416.073 872.223 396.388 C 880.08 383.2 889.242 366.575 898.701 354.856 C 917.367 331.729 944.562 315.414 974.353 312.338 z" id="path8" />
+    <path transform="translate(0,0)" fill="rgb(139,213,25)" d="M 523.18 1029.42 C 556.08 976.829 588.694 924.061 621.023 871.118 C 627.99 859.619 661.514 799.872 669.483 795.517 C 690.88 783.822 727.106 766.326 749.943 755.103 C 722.394 791.012 686.335 841.017 657.283 874.796 L 656.346 876.784 C 634.512 904.728 612.857 932.811 591.382 961.032 C 568.14 991.332 557.812 1011.64 523.18 1029.42 z" id="path9" />
+    <path transform="translate(0,0)" fill="rgb(253,144,16)" d="M 1323.9 154.915 L 1325.47 155.256 C 1331.7 160.057 1340.06 172.964 1342.69 180.248 C 1351.86 205.651 1350.16 227.593 1339.8 251.778 C 1334.23 238.386 1331.99 234.279 1319.97 224.856 C 1291.89 208.844 1290.68 214.502 1267.49 187.859 C 1285.06 176.466 1303.51 168.662 1323.9 154.915 z" id="path10" />
+    <path transform="translate(0,0)" fill="rgb(8,183,189)" d="M 1292.47 123.142 C 1298.18 122.562 1318.49 122.675 1315.18 135.203 C 1313.13 142.916 1290.79 154.186 1282.81 158.877 L 1266.65 167.263 C 1266.89 144.18 1270.19 132.493 1292.47 123.142 z" id="path11" />
+    <path transform="translate(0,0)" fill="rgb(253,144,16)" d="M 1264.11 211.807 C 1281.17 227.061 1292.71 232.962 1313.54 241.512 C 1309.67 245.334 1307.15 247.364 1302.81 250.678 C 1265.2 273.776 1263.65 241.072 1264.11 211.807 z" id="path12" />
+  </g>
+
+  <text x="310" y="220" font-family="'Segoe UI', system-ui, -apple-system, sans-serif" font-size="100" font-weight="700" fill="#f0f6fc" letter-spacing="-3">Parakeet</text>
+  <text x="312" y="275" font-family="'Segoe UI', system-ui, -apple-system, sans-serif" font-size="28" font-weight="400" fill="#8b949e">High-performance ASR server written in Go</text>
+  <text x="312" y="315" font-family="'Segoe UI', system-ui, -apple-system, sans-serif" font-size="24" font-weight="400" fill="#6e7681">OpenAI Whisper-compatible API</text>
+  <rect x="312" y="345" width="700" height="2" fill="#238636" opacity="0.4" rx="1"/>
+  <text x="314" y="382" font-family="'Segoe UI', system-ui, -apple-system, sans-serif" font-size="22" fill="#6e7681">github.com/achetronic/parakeet</text>
+
+  <!-- Row 1 pills -->
+  <rect x="312" y="430" width="280" height="40" rx="20" fill="#238636" opacity="0.18" stroke="#238636" stroke-width="1"/>
+  <text x="452" y="456" font-family="'Segoe UI', system-ui, sans-serif" font-size="15" font-weight="600" fill="#2ea043" text-anchor="middle">NVIDIA Parakeet TDT 0.6B</text>
+
+  <rect x="606" y="430" width="180" height="40" rx="20" fill="#1f6feb" opacity="0.15" stroke="#1f6feb" stroke-width="1"/>
+  <text x="696" y="456" font-family="'Segoe UI', system-ui, sans-serif" font-size="15" font-weight="600" fill="#58a6ff" text-anchor="middle">ONNX Runtime</text>
+
+  <rect x="800" y="430" width="160" height="40" rx="20" fill="#6e40c9" opacity="0.15" stroke="#6e40c9" stroke-width="1"/>
+  <text x="880" y="456" font-family="'Segoe UI', system-ui, sans-serif" font-size="15" font-weight="600" fill="#a371f7" text-anchor="middle">25+ languages</text>
+
+  <!-- Row 2 pills -->
+  <rect x="312" y="486" width="180" height="40" rx="20" fill="#1f6feb" opacity="0.15" stroke="#1f6feb" stroke-width="1"/>
+  <text x="402" y="512" font-family="'Segoe UI', system-ui, sans-serif" font-size="15" font-weight="600" fill="#58a6ff" text-anchor="middle">JSON · SRT · VTT</text>
+
+  <rect x="506" y="486" width="160" height="40" rx="20" fill="#238636" opacity="0.18" stroke="#238636" stroke-width="1"/>
+  <g transform="translate(541, 496) scale(0.833)">
+    <path fill="#2ea043" d="M13.983 11.078h2.119a.186.186 0 0 0 .186-.185V9.006a.186.186 0 0 0-.186-.186h-2.119a.185.185 0 0 0-.185.185v1.888c0 .102.083.185.185.185m-2.954-5.43h2.118a.186.186 0 0 0 .186-.186V3.574a.186.186 0 0 0-.186-.185h-2.118a.185.185 0 0 0-.185.185v1.888c0 .102.082.185.185.185m0 2.716h2.118a.187.187 0 0 0 .186-.186V6.29a.186.186 0 0 0-.186-.185h-2.118a.185.185 0 0 0-.185.185v1.887c0 .102.082.185.185.186m-2.93 0h2.12a.186.186 0 0 0 .184-.186V6.29a.185.185 0 0 0-.185-.185H8.1a.185.185 0 0 0-.185.185v1.887c0 .102.083.185.185.186m-2.964 0h2.119a.186.186 0 0 0 .185-.186V6.29a.185.185 0 0 0-.185-.185H5.136a.186.186 0 0 0-.186.185v1.887c0 .102.084.185.186.186m5.893 2.715h2.118a.186.186 0 0 0 .186-.185V9.006a.186.186 0 0 0-.186-.186h-2.118a.185.185 0 0 0-.185.185v1.888c0 .102.082.185.185.185m-2.93 0h2.12a.185.185 0 0 0 .184-.185V9.006a.185.185 0 0 0-.184-.186h-2.12a.185.185 0 0 0-.184.185v1.888c0 .102.083.185.185.185m-2.964 0h2.119a.185.185 0 0 0 .185-.185V9.006a.185.185 0 0 0-.184-.186h-2.12a.186.186 0 0 0-.186.186v1.887c0 .102.084.185.186.185m-2.92 0h2.12a.185.185 0 0 0 .184-.185V9.006a.185.185 0 0 0-.184-.186h-2.12a.185.185 0 0 0-.184.185v1.888c0 .102.082.185.185.185M23.763 9.89c-.065-.051-.672-.51-1.954-.51c-.338.001-.676.03-1.01.087c-.248-1.7-1.653-2.53-1.716-2.566l-.344-.199l-.226.327c-.284.438-.49.922-.612 1.43c-.23.97-.09 1.882.403 2.661c-.595.332-1.55.413-1.744.42H.751a.751.751 0 0 0-.75.748a11.376 11.376 0 0 0 .692 4.062c.545 1.428 1.355 2.48 2.41 3.124c1.18.723 3.1 1.137 5.275 1.137a15.74 15.74 0 0 0 2.93-.266a12.248 12.248 0 0 0 3.823-1.389a10.51 10.51 0 0 0 2.61-2.136c1.252-1.418 1.998-2.997 2.553-4.4h.221c1.372 0 2.215-.549 2.68-1.009c.309-.293.55-.65.707-1.046l.098-.288Z"/>
+  </g>
+  <text x="568" y="512" font-family="'Segoe UI', system-ui, sans-serif" font-size="15" font-weight="600" fill="#2ea043" text-anchor="start">Docker</text>
+
+  <rect x="680" y="486" width="240" height="40" rx="20" fill="#b08800" opacity="0.15" stroke="#b08800" stroke-width="1"/>
+  <text x="800" y="512" font-family="'Segoe UI', system-ui, sans-serif" font-size="15" font-weight="600" fill="#e3b341" text-anchor="middle">INT8 (CPU) · FP32 (GPU)</text>
+
+  <rect x="0" y="636" width="1280" height="4" fill="#21262d"/>
+</svg>
\ No newline at end of file