From 09b6a832ee68d5082b6761734d2c34d222f66ca9 Mon Sep 17 00:00:00 2001
From: anti <samuel@securejump.cl>
Date: Tue, 16 Jun 2026 19:13:17 -0400
Subject: [PATCH] docs(readme): add logo banner + badges to header

---
 README.md              | 20 ++++++++++++++++++--
 assets/decnet-logo.svg |  6 ++++++
 2 files changed, 24 insertions(+), 2 deletions(-)
 create mode 100644 assets/decnet-logo.svg

diff --git a/README.md b/README.md
index 4898b65f..b1bf6937 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,25 @@
-# DECNET
+<div align="center">
 
-A honeypot deception network framework. Spin up a fleet of fake machines — called **deckies** — that appear as real, heterogeneous LAN hosts to anyone scanning the network. Each decky gets its own MAC address, IP, hostname, services, OS fingerprint, and log pipeline. Attackers probe the network, DECNET traps every interaction, and a full intelligence stack profiles, clusters, and attributes their behaviour.
+<img src="assets/decnet-logo.svg" alt="DECNET — Deception Network" width="560">
+
+**A honeypot deception network framework.**
+
+Spin up a fleet of fake machines — **deckies** — that look like real, heterogeneous LAN hosts to anyone scanning the network. Each decky gets its own MAC, IP, hostname, services, OS fingerprint, and log pipeline. Attackers probe; DECNET traps every interaction; a full intelligence stack profiles, clusters, and attributes their behaviour.
+
+<br>
+
+[![PyPI version](https://img.shields.io/pypi/v/decnet.svg)](https://pypi.org/project/decnet/)
+[![Python](https://img.shields.io/pypi/pyversions/decnet.svg)](https://pypi.org/project/decnet/)
+[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
+[![Ruff](https://img.shields.io/badge/lint-ruff-261230.svg?logo=ruff&logoColor=white)](https://github.com/astral-sh/ruff)
+[![Platform](https://img.shields.io/badge/platform-Linux-333.svg?logo=linux&logoColor=white)](#requirements)
+
+[Quick Start](#quick-start) · [Architecture](#architecture) · [REST API](#rest-api--web-dashboard) · [MazeNET](#mazenet-topology) · [Support](https://ko-fi.com/C0C31YDLB5)
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/C0C31YDLB5)
 
+</div>
+
 ---
 
 ## Table of Contents
diff --git a/assets/decnet-logo.svg b/assets/decnet-logo.svg
new file mode 100644
index 00000000..b1befbd3
--- /dev/null
+++ b/assets/decnet-logo.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-41.00 -108.00 579.00 226.00" width="579" height="226" fill="none">
+<defs>
+<filter id="gG" x="-60%" y="-60%" width="220%" height="220%"><feDropShadow dx="0" dy="0" stdDeviation="6" flood-color="#00ff41" flood-opacity="0.45"></feDropShadow></filter>
+<filter id="gV" x="-100%" y="-100%" width="300%" height="300%"><feDropShadow dx="0" dy="0" stdDeviation="7" flood-color="#ee82ee" flood-opacity="0.55"></feDropShadow></filter></defs>
+<g><path d="M17.70-51.60L17.70-10Q18.20-9.90 18.80-9.90Q19.40-9.90 19.90-9.90L19.90-9.90Q24.10-9.90 26.95-11.50Q29.80-13.10 31.55-15.90Q33.30-18.70 34.05-22.55Q34.80-26.40 34.80-31L34.80-31Q34.80-35 34.20-38.80Q33.60-42.60 32.10-45.50Q30.60-48.40 28-50.15Q25.40-51.90 21.30-51.90L21.30-51.90Q20.50-51.90 19.50-51.85Q18.50-51.80 17.70-51.60L17.70-51.60ZM47.30-31L47.30-31Q47.30-22.40 45.15-16.35Q43-10.30 39.20-6.50Q35.40-2.70 30.15-0.95Q24.90 0.80 18.60 0.80L18.60 0.80Q15.30 0.80 12.15 0.45Q9 0.10 5.40-0.70L5.40-0.70L5.40-61.10Q9.60-62 13.30-62.30Q17-62.60 20.20-62.60L20.20-62.60Q26.30-62.60 31.35-60.80Q36.40-59 39.90-55.15Q43.40-51.30 45.35-45.35Q47.30-39.40 47.30-31Z" fill="#00ff41" filter="url(#gG)"></path><path d="M120 0L80.30 0L80.30-61.90L117.80-61.90L117.80-51.70L92.60-51.70L92.60-37.80L114.50-37.80L114.50-27.60L92.60-27.60L92.60-10.20L120-10.20L120 0Z" fill="#00ff41" filter="url(#gG)"></path><path d="M177.60 1.30L177.60 1.30Q164.50 1.30 157.60-7.10Q150.70-15.50 150.70-31L150.70-31Q150.70-38.70 152.80-44.70Q154.90-50.70 158.65-54.85Q162.40-59 167.55-61.15Q172.70-63.30 178.80-63.30L178.80-63.30Q182.10-63.30 184.75-62.75Q187.40-62.20 189.40-61.50Q191.40-60.80 192.75-60Q194.10-59.20 194.80-58.80L194.80-58.80L191.60-49Q189.30-50.50 186.05-51.55Q182.80-52.60 178.60-52.60L178.60-52.60Q175.70-52.60 172.95-51.55Q170.20-50.50 168.05-48.05Q165.90-45.60 164.55-41.50Q163.20-37.40 163.20-31.30L163.20-31.30Q163.20-20.70 166.85-15.05Q170.50-9.40 178.80-9.40L178.80-9.40Q183.60-9.40 186.75-10.50Q189.90-11.60 191.80-12.70L191.80-12.70L194.90-3Q192.30-1.40 187.85-0.05Q183.40 1.30 177.60 1.30Z" fill="#00ff41" filter="url(#gG)"></path><path transform="translate(221.50,-31)" d="M0 0 H18 L24 -22 L32 20 L38 0 H54" stroke="#ee82ee" stroke-width="6" fill="none" stroke-linecap="round" stroke-linejoin="round" filter="url(#gV)"></path><path d="M341.40 0L331.50 0Q327.30-10.30 322.35-20.55Q317.40-30.80 311.70-41.10L311.70-41.10L311.70 0L300.60 0L300.60-61.90L310.50-61.90Q313.30-57.50 316.10-52.35Q318.90-47.20 321.55-42.10Q324.20-37 326.45-32.20Q328.70-27.40 330.30-23.80L330.30-23.80L330.30-61.90L341.40-61.90L341.40 0Z" fill="#ee82ee" filter="url(#gV)"></path><path d="M416 0L376.30 0L376.30-61.90L413.80-61.90L413.80-51.70L388.60-51.70L388.60-37.80L410.50-37.80L410.50-27.60L388.60-27.60L388.60-10.20L416-10.20L416 0Z" fill="#ee82ee" filter="url(#gV)"></path><path d="M446.50-61.90L491.50-61.90L491.50-51.70L475.20-51.70L475.20 0L462.80 0L462.80-51.70L446.50-51.70L446.50-61.90Z" fill="#ee82ee" filter="url(#gV)"></path><path d="M35.46 51.94L35.46 51.94Q35.46 54.18 34.90 55.74Q34.34 57.30 33.37 58.27Q32.39 59.25 31.05 59.69Q29.71 60.13 28.15 60.13L28.15 60.13Q26.54 60.13 24.90 59.74L24.90 59.74L24.90 44.14Q26.54 43.75 28.15 43.75L28.15 43.75Q29.71 43.75 31.05 44.19Q32.39 44.63 33.37 45.62Q34.34 46.61 34.90 48.17Q35.46 49.73 35.46 51.94ZM27.04 45.67L27.04 58.21Q27.69 58.28 28.36 58.28L28.36 58.28Q29.53 58.28 30.44 57.93Q31.35 57.58 31.98 56.81Q32.60 56.05 32.94 54.84Q33.28 53.63 33.28 51.94L33.28 51.94Q33.28 48.66 32.02 47.13Q30.75 45.60 28.28 45.60L28.28 45.60Q27.95 45.60 27.62 45.61Q27.30 45.62 27.04 45.67L27.04 45.67Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M60.46 60L50.87 60L50.87 43.91L59.89 43.91L59.89 45.73L53.00 45.73L53.00 50.67L59.03 50.67L59.03 52.49L53.00 52.49L53.00 58.18L60.46 58.18L60.46 60Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M84.89 57.56L85.46 59.32Q84.55 59.84 83.52 60.09Q82.50 60.34 81.33 60.34L81.33 60.34Q79.90 60.34 78.69 59.83Q77.48 59.32 76.59 58.30Q75.71 57.27 75.20 55.68Q74.70 54.10 74.70 51.94L74.70 51.94Q74.70 49.89 75.23 48.33Q75.76 46.77 76.67 45.70Q77.58 44.63 78.80 44.09Q80.03 43.54 81.40 43.54L81.40 43.54Q82.37 43.54 83.37 43.80Q84.37 44.06 85.33 44.66L85.33 44.66L84.71 46.43Q82.99 45.44 81.48 45.44L81.48 45.44Q80.42 45.44 79.57 45.89Q78.73 46.35 78.13 47.21Q77.53 48.07 77.20 49.26Q76.88 50.46 76.88 51.94L76.88 51.94Q76.88 53.60 77.23 54.83Q77.58 56.05 78.21 56.85Q78.83 57.66 79.70 58.05Q80.57 58.44 81.59 58.44L81.59 58.44Q82.34 58.44 83.17 58.24Q84.00 58.05 84.89 57.56L84.89 57.56Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M110.46 60L100.87 60L100.87 43.91L109.89 43.91L109.89 45.73L103.00 45.73L103.00 50.67L109.03 50.67L109.03 52.49L103.00 52.49L103.00 58.18L110.46 58.18L110.46 60Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M129.61 43.75L129.61 43.75Q131.04 43.75 132.12 44.11Q133.20 44.48 133.91 45.14Q134.63 45.80 134.98 46.71Q135.33 47.62 135.33 48.74L135.33 48.74Q135.33 51.26 133.85 52.63Q132.37 53.99 129.40 53.99L129.40 53.99L127.53 53.99L127.53 60L125.40 60L125.40 44.14Q125.87 44.04 126.42 43.96Q126.98 43.88 127.54 43.83Q128.10 43.78 128.63 43.76Q129.17 43.75 129.61 43.75ZM129.77 45.60L129.77 45.60Q129.09 45.60 128.47 45.61Q127.84 45.62 127.53 45.67L127.53 45.67L127.53 52.17L129.30 52.17Q131.25 52.17 132.20 51.39Q133.15 50.61 133.15 48.82L133.15 48.82Q133.15 45.60 129.77 45.60Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M149.51 43.91L160.49 43.91L160.49 45.73L156.07 45.73L156.07 60L153.93 60L153.93 45.73L149.51 45.73L149.51 43.91Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M184.19 45.73L181.07 45.73L181.07 58.18L184.19 58.18L184.19 60L175.81 60L175.81 58.18L178.93 58.18L178.93 45.73L175.81 45.73L175.81 43.91L184.19 43.91L184.19 45.73Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M199.25 51.94L199.25 51.94Q199.25 49.78 199.67 48.20Q200.09 46.61 200.84 45.58Q201.59 44.56 202.65 44.05Q203.70 43.54 205 43.54L205 43.54Q206.27 43.54 207.34 44.05Q208.41 44.56 209.16 45.58Q209.91 46.61 210.34 48.20Q210.77 49.78 210.77 51.94L210.77 51.94Q210.77 54.10 210.34 55.68Q209.91 57.27 209.16 58.31Q208.41 59.35 207.34 59.84Q206.27 60.34 205 60.34L205 60.34Q203.70 60.34 202.65 59.84Q201.59 59.35 200.84 58.31Q200.09 57.27 199.67 55.68Q199.25 54.10 199.25 51.94ZM201.44 51.94L201.44 51.94Q201.44 55.11 202.30 56.80Q203.15 58.49 204.95 58.49L204.95 58.49Q206.77 58.49 207.68 56.80Q208.59 55.11 208.59 51.94L208.59 51.94Q208.59 48.77 207.68 47.08Q206.77 45.39 204.95 45.39L204.95 45.39Q203.15 45.39 202.30 47.08Q201.44 48.77 201.44 51.94Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M235.07 60L232.89 60Q232.00 57.84 231.22 56.09Q230.44 54.33 229.73 52.80Q229.01 51.26 228.31 49.90Q227.61 48.53 226.88 47.16L226.88 47.16L226.88 60L224.93 60L224.93 43.91L227.11 43.91Q228.18 45.86 228.97 47.31Q229.77 48.77 230.43 50.13Q231.09 51.50 231.72 52.94Q232.34 54.38 233.12 56.28L233.12 56.28L233.12 43.91L235.07 43.91L235.07 60Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M310.07 60L307.89 60Q307.00 57.84 306.22 56.09Q305.44 54.33 304.73 52.80Q304.01 51.26 303.31 49.90Q302.61 48.53 301.88 47.16L301.88 47.16L301.88 60L299.93 60L299.93 43.91L302.11 43.91Q303.18 45.86 303.97 47.31Q304.77 48.77 305.43 50.13Q306.09 51.50 306.72 52.94Q307.34 54.38 308.12 56.28L308.12 56.28L308.12 43.91L310.07 43.91L310.07 60Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M335.46 60L325.87 60L325.87 43.91L334.89 43.91L334.89 45.73L328.00 45.73L328.00 50.67L334.03 50.67L334.03 52.49L328.00 52.49L328.00 58.18L335.46 58.18L335.46 60Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M349.51 43.91L360.49 43.91L360.49 45.73L356.07 45.73L356.07 60L353.93 60L353.93 45.73L349.51 45.73L349.51 43.91Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M379.97 51.99L377.48 60L375.48 60Q375.24 58.41 375.07 56.50Q374.90 54.59 374.76 52.51Q374.62 50.43 374.51 48.25Q374.41 46.06 374.33 43.91L374.33 43.91L376.41 43.91L376.70 57.35L379.04 50.02L380.91 50.02L383.30 57.35L383.59 43.91L385.67 43.91Q385.59 46.09 385.47 48.27Q385.36 50.46 385.20 52.52Q385.04 54.59 384.86 56.49Q384.68 58.39 384.47 60L384.47 60L382.50 60L379.97 51.99Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M399.25 51.94L399.25 51.94Q399.25 49.78 399.67 48.20Q400.09 46.61 400.84 45.58Q401.59 44.56 402.65 44.05Q403.70 43.54 405 43.54L405 43.54Q406.27 43.54 407.34 44.05Q408.41 44.56 409.16 45.58Q409.91 46.61 410.34 48.20Q410.77 49.78 410.77 51.94L410.77 51.94Q410.77 54.10 410.34 55.68Q409.91 57.27 409.16 58.31Q408.41 59.35 407.34 59.84Q406.27 60.34 405 60.34L405 60.34Q403.70 60.34 402.65 59.84Q401.59 59.35 400.84 58.31Q400.09 57.27 399.67 55.68Q399.25 54.10 399.25 51.94ZM401.44 51.94L401.44 51.94Q401.44 55.11 402.30 56.80Q403.15 58.49 404.95 58.49L404.95 58.49Q406.77 58.49 407.68 56.80Q408.59 55.11 408.59 51.94L408.59 51.94Q408.59 48.77 407.68 47.08Q406.77 45.39 404.95 45.39L404.95 45.39Q403.15 45.39 402.30 47.08Q401.44 48.77 401.44 51.94Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M434.71 48.82L434.71 48.82Q434.71 50.30 433.93 51.43Q433.15 52.56 431.82 53.19L431.82 53.19Q432.21 53.81 432.69 54.60Q433.17 55.40 433.67 56.30Q434.16 57.19 434.64 58.14Q435.12 59.09 435.54 60L435.54 60L433.25 60Q432.47 58.13 431.55 56.41Q430.62 54.70 429.77 53.63L429.77 53.63Q429.61 53.66 429.31 53.66Q429.01 53.66 428.91 53.66L428.91 53.66L427.09 53.66L427.09 60L424.93 60L424.93 44.14Q425.32 44.04 425.83 43.96Q426.33 43.88 426.87 43.84Q427.40 43.80 427.92 43.78Q428.44 43.75 428.86 43.75L428.86 43.75Q431.77 43.75 433.24 45.02Q434.71 46.30 434.71 48.82ZM429.04 45.60L429.04 45.60Q428.44 45.60 427.88 45.61Q427.32 45.62 427.09 45.67L427.09 45.67L427.09 51.89L428.47 51.89Q429.40 51.89 430.14 51.76Q430.88 51.63 431.42 51.28Q431.95 50.93 432.24 50.31Q432.52 49.70 432.52 48.72L432.52 48.72Q432.52 47.78 432.24 47.18Q431.95 46.58 431.48 46.23Q431.01 45.88 430.38 45.74Q429.74 45.60 429.04 45.60Z" fill="#00ff41" fill-opacity="0.55"></path><path d="M458.25 43.91L460.72 43.91Q459.45 45.80 457.93 47.68Q456.40 49.55 454.64 51.42L454.64 51.42Q455.47 52.12 456.40 53.06Q457.34 53.99 458.24 55.10Q459.13 56.20 459.93 57.45Q460.72 58.70 461.27 60L461.27 60L458.85 60Q458.20 58.80 457.44 57.66Q456.69 56.52 455.85 55.53Q455 54.54 454.10 53.72Q453.21 52.90 452.30 52.30L452.30 52.30L452.30 60L450.16 60L450.16 43.91L452.30 43.91L452.30 51.08Q453.99 49.34 455.53 47.44Q457.08 45.54 458.25 43.91L458.25 43.91Z" fill="#00ff41" fill-opacity="0.55"></path></g>
+</svg>
\ No newline at end of file