souleyez 2.40.0__py3-none-any.whl → 2.43.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,10 +1,10 @@
1
- souleyez/__init__.py,sha256=-qi6XRXjceUpTfjO4JLvLjKSTgaNt3Ti2MT9eP6nrcs,24
1
+ souleyez/__init__.py,sha256=hQfhNFZmys4vpRUV0tekkwul1bHV-z9AHclh8q4E4WQ,24
2
2
  souleyez/config.py,sha256=av357I3GYRWAklv8Dto-9-5Db699Wq5znez7zo7241Q,11595
3
3
  souleyez/devtools.py,sha256=rptmUY4a5eVvYjdEc6273MSagL-D9xibPOFgohVqUno,3508
4
4
  souleyez/feature_flags.py,sha256=mo6YAq07lc6sR3lEFKmIwTKxXZ2JPxwa5X97uR_mu50,4642
5
5
  souleyez/history.py,sha256=gzs5I_j-3OigIP6yfmBChdqxaFmyUIxvTpzWUPe_Q6c,2853
6
6
  souleyez/log_config.py,sha256=MMhPAJOqgXDfuE-xm5g0RxAfWndcmbhFHvIEMm1a_Wo,5830
7
- souleyez/main.py,sha256=opU2XK_1z401XuT5Ifz0YKN970aTGEl7jA971M025UI,129100
7
+ souleyez/main.py,sha256=eQpWyYeCz8IvNFBJmqOqFv6x05FT8gOtUC62M_a-0UI,129100
8
8
  souleyez/scanner.py,sha256=U3IWHRrJ5aQ32dSHiVAHB60w1R_z0E0QxfM99msYNlw,3124
9
9
  souleyez/security.py,sha256=S84m1QmnKz_6NgH2I6IBIAorMHxRPNYVFSnks5xjihQ,2479
10
10
  souleyez/ui.py,sha256=15pfsqoDPnojAqr5S0TZHJE2ZkSHzkHpNVfVvsRj66A,34301
@@ -41,7 +41,7 @@ souleyez/commands/audit.py,sha256=KviKaLv8Ry09H2S-j9dFGLrkzYOnyeWRErm1bvoo5dE,73
41
41
  souleyez/commands/auth.py,sha256=4ed0zeWQqLbZOJ6MKd5iMWxt6wOQoNDKzRbMhNg3A00,4942
42
42
  souleyez/commands/deliverables.py,sha256=qlIW9q3PmOoegYMB64zICHlWsgG-dZ5Y0eDYDqjl2kU,7766
43
43
  souleyez/commands/engagement.py,sha256=KigGwjCtt8g7CDtRjS2pSeuT52JSBZEl0X3ZhuQuPf8,6337
44
- souleyez/commands/license.py,sha256=FQbEduw7Xo0E8qbFr9IoSJ3T89SE0hdN5rLhmi7luG4,6077
44
+ souleyez/commands/license.py,sha256=0Mz6WYHnAR-VpAxIU-NIsJY1mITTuPoybh-5V_vX1EE,6091
45
45
  souleyez/commands/screenshots.py,sha256=EqTp56Zcow6JLqc7rsqAqhbOPw8-jznlN5QPZJi8sdg,5190
46
46
  souleyez/commands/user.py,sha256=u2ogSLnzxY95xmPiWLgK9OdrrNyIDv_V33DYVJMYags,12008
47
47
  souleyez/core/__init__.py,sha256=_WzKeywShaf_uQknBk-_d5LDqRKHoV5de6ZYP-JizKQ,109
@@ -104,15 +104,15 @@ souleyez/detection/__init__.py,sha256=QIhvXjFdjrquQ6A0VQ7GZQkK_EXB59t8Dv9PKXhEUe
104
104
  souleyez/detection/attack_signatures.py,sha256=akgWwiIkh6WYnghCuLhRV0y6FS0SQ0caGF8tZUc49oA,6965
105
105
  souleyez/detection/mitre_mappings.py,sha256=xejE80YK-g8kKaeQoo-vBl8P3t8RTTItbfN0NaVZw6s,20558
106
106
  souleyez/detection/validator.py,sha256=-AJ7QSJ3-6jFKLnPG_Rc34IXyF4JPyI82BFUgTA9zw0,15641
107
- souleyez/docs/README.md,sha256=okKQkinANzeCzah1aSpizlVUisZqO5iPs14C_yY8HP0,7183
107
+ souleyez/docs/README.md,sha256=yY6yvWMHZZXVEQC2JeQ8Tui0TyXKbWNabPlh0X5BdO8,7187
108
108
  souleyez/docs/api-reference/cli-commands.md,sha256=lTLFnILN3YRVdqCaag7WgsYXfDGglb1TuPexkxDsVdE,12917
109
109
  souleyez/docs/api-reference/engagement-api.md,sha256=nd-EvQMtiJrobg2bzFEADp853HP1Uhb9dmgok0_-neE,11672
110
110
  souleyez/docs/api-reference/integration-guide.md,sha256=c96uX79ukHyYotLa54wZ20Kx-EUZnrKegTeGkfLD-pw,16285
111
111
  souleyez/docs/api-reference/parser-formats.md,sha256=DRyASQ0O6ZWGgyrYKqMPC9XFYL5dwvWjuG_q0WRjY8k,15367
112
- souleyez/docs/architecture/overview.md,sha256=3sCuGjR7sk1qh8GtcFj4Qn8P93yCxRgOO5CmAXSGghk,43312
112
+ souleyez/docs/architecture/overview.md,sha256=gYqXTSV_abXbAFz8Mv_RIJto-spNR--ft7Rdwdvy8tg,43402
113
113
  souleyez/docs/architecture/decisions/000-template.md,sha256=Db8xSIOogP1qdJ5SgBVEJZUh2un4EtCEwfs53-XGDvY,4467
114
- souleyez/docs/architecture/decisions/001-local-llm-over-cloud.md,sha256=wrQ0fO9cyB-IBU6Rbhp3umvrYHdyaAdN-DuXm8eGIMA,14570
115
- souleyez/docs/architecture/decisions/002-master-password-approach.md,sha256=QBhTkJDrf8RGgggh6JjZerJSL4TZoUn8f4OBJ4Na-KE,14762
114
+ souleyez/docs/architecture/decisions/001-local-llm-over-cloud.md,sha256=LXf2d05ucnidl0vZrTL6vndPNKSnoRMR_CLt10pnLt0,14562
115
+ souleyez/docs/architecture/decisions/002-master-password-approach.md,sha256=8HZii9ROyst87HQiFF5sBlCrBX81ZR2JAEa-U9BMxP8,14781
116
116
  souleyez/docs/architecture/decisions/003-database-schema-design.md,sha256=fUxsbVkpibVyZR4982J2Oeqx92a8oP9GQWr6jpuMjMY,20469
117
117
  souleyez/docs/database/MIGRATIONS.md,sha256=bO92DEQxcl921T5Cd7QeEH4aEB1OexPccmtW-wrLosg,10584
118
118
  souleyez/docs/database/SCHEMA.md,sha256=7k57iKslqEYAkwdf7McIqy_ME1rY30d5X7g-lyb0KO8,10590
@@ -121,24 +121,24 @@ souleyez/docs/developer-guide/test_coverage_plan.md,sha256=5m6p8iki89cb6u9WWhFkT
121
121
  souleyez/docs/developer-guide/ui-design-system.md,sha256=xzznuNmwzU-mTRwG496TgKlFOa9K3fsAJbzT8qmvLu0,22327
122
122
  souleyez/docs/images/README.md,sha256=Wek2mbJnGtLOCURvCmSGP2bS182OLgTbvxoC0b25gRo,4535
123
123
  souleyez/docs/security/best-practices.md,sha256=cy9jy6zDMcUbPithoNv9qd4ur9WrIQPNUyeJhH5IB5g,18240
124
- souleyez/docs/security/credential-encryption.md,sha256=6OUIRnSPFkXx7RRUwY_jsfIJ-gLj9ofAALoy0wrrYio,18448
124
+ souleyez/docs/security/credential-encryption.md,sha256=shjNq8I9ycOohPTQ0U5LgEJk9vTmdiKat9X7VzGbsYQ,19060
125
125
  souleyez/docs/security/password-protected-commands.md,sha256=ubTrZeLSCGKUsY3NW5ZP1w1SqGvtW27yTIojIdsX6CM,5878
126
126
  souleyez/docs/security/secure-defaults.md,sha256=IEH0lTrThNokDCY8jMOWW5AEpqDd8T8p1NxCPS1jaXU,16605
127
- souleyez/docs/security/threat-model.md,sha256=JcR5AR-l977-7HTe5O2LULBikaxJovcxHE6ZNqUTlC4,13576
127
+ souleyez/docs/security/threat-model.md,sha256=vwJ0k4EDi_MZNKFwzr6E3tfDr__dJCANpRAvp_mdE9Q,13594
128
128
  souleyez/docs/user-guide/ai-integration.md,sha256=erC3Svg6XosKhT1BoHRQ98PUp71OdNQ6bkJIh7shN_Y,8859
129
129
  souleyez/docs/user-guide/attack-surface.md,sha256=9QabVuuPkCNNDgAXx_Yerbtmnk61lPkU8Gjl_M6-rG8,12924
130
130
  souleyez/docs/user-guide/auto-chaining.md,sha256=UjQ8J8rBgukQIikIrH3U7XoX0WF8EHO_a9i3qDomsXg,21144
131
- souleyez/docs/user-guide/configuration.md,sha256=PT01AWD0AINtXmh12Qh-Md0FXkSvXo2Yo6BZInZ3fMo,14650
131
+ souleyez/docs/user-guide/configuration.md,sha256=igWZgm18fdVv5oMJTi-N_IDC_01nfrzPamcQd3cVWH8,14650
132
132
  souleyez/docs/user-guide/deliverables-screenshots.md,sha256=D5ATXKZRhwXu8OsGMEEUzbXW3hJl-qTh4wsUPx8gNUA,15148
133
- souleyez/docs/user-guide/dependencies.md,sha256=WOPilg0W0U3KnsdGREkM5_gAG7Rr5P10oco7qDKkJEY,7475
133
+ souleyez/docs/user-guide/dependencies.md,sha256=O7_YjUK19D8npNBHG2diqtm8zUPjtc3NObspG3xcsrs,7470
134
134
  souleyez/docs/user-guide/evidence-vault.md,sha256=PNg7cIUlVXr41iMJTi66j4qUV2fkrPATljunx0pD5sI,9454
135
135
  souleyez/docs/user-guide/exploit-suggestions.md,sha256=Qv9CPwDe9ypKoeUG3XAL6dtg4YA5PmlE5DA6JVHK4Nk,17971
136
- souleyez/docs/user-guide/getting-started.md,sha256=4QfZiQlYnReORAUpsy2gWzKe1uFHOePZyzDSz8zldgc,20932
137
- souleyez/docs/user-guide/installation.md,sha256=uM_qBpgG5YjkxSf8u6gUJh0TGYtPlo4pbn_wEXJHX0Q,14431
136
+ souleyez/docs/user-guide/getting-started.md,sha256=_2jLTstG6hqjnQGCgu8jMPDRDLunJg-PZWLsWRUdvpQ,21074
137
+ souleyez/docs/user-guide/installation.md,sha256=45aWFh3MeZvzSXs8y-vN1C2nJAdt3D-ponnlqlQYkis,14243
138
138
  souleyez/docs/user-guide/metasploit-integration.md,sha256=kSCai2PO4kiv3BEUSXa6mIC3vCdqIA70GyLVQH_Kaj4,10026
139
- souleyez/docs/user-guide/rbac.md,sha256=ULY5IbTCoNGOnvRrT1oH5XayCqD10PKoUwRDBRzpK2g,21055
139
+ souleyez/docs/user-guide/rbac.md,sha256=DBILwrok4Qfeal9E49XgqJz88GPIdjMwDBpMDTtkWTc,21071
140
140
  souleyez/docs/user-guide/report-generation.md,sha256=7Qe47jfPxmZ4U1uuM3kggPLQ6JM7_TCOOhYIvYen4Ao,20754
141
- souleyez/docs/user-guide/scope-management.md,sha256=rj1ZWeK93MdSxVUP50Iy4DcPGpAJkCapGdlCXiNhyBQ,18527
141
+ souleyez/docs/user-guide/scope-management.md,sha256=rKE7CcumYRHDdZrxXvIs51CqVCdNA90glp-a1I-uZFs,18529
142
142
  souleyez/docs/user-guide/siem-integration.md,sha256=RX9Bg6nZx4negxbnwFAm-qGikJLSVghWCTyvLUBQuEk,27141
143
143
  souleyez/docs/user-guide/tools-reference.md,sha256=-Acl9OKlAJ1mF0heADTjK8jNvg2vWbS8zdWWj5On1OE,18334
144
144
  souleyez/docs/user-guide/troubleshooting.md,sha256=SBBL5nqvVxLGUlUnCs2DKarCcg9k5autaQOqB8-V_YM,14063
@@ -188,7 +188,7 @@ souleyez/intelligence/service_parser.py,sha256=_RkpiI-EV8Maf5YAqM7mKB_7hqA7bZ2dn
188
188
  souleyez/intelligence/surface_analyzer.py,sha256=uJbNeEQbjCBs4N2-l95Gee9GS5qEvDgJ0UdMBPicchw,25315
189
189
  souleyez/intelligence/target_parser.py,sha256=3PaA_mj5WIs4hylKzJG6yI5KpP9OlID7gmB_GHhh0nM,11929
190
190
  souleyez/licensing/__init__.py,sha256=YAp7FS8NMHEKxUsJUY8hzMYI8Wyl_yOSXwfMcr-77a4,524
191
- souleyez/licensing/validator.py,sha256=vwiRde9l1YyTV3U7QiKWzELTggk16_uXtolt4hqnAVk,11335
191
+ souleyez/licensing/validator.py,sha256=yDQ-tqm1wdA2FgJWofciRxGtwcQRtmYDMClmMInAtvo,11633
192
192
  souleyez/migrations/__init__.py,sha256=S4ZorUykM6txYkZHuQ64QbzHWeNQ3QDFP-PvgMPbpsc,94
193
193
  souleyez/migrations/fix_job_counter.py,sha256=-NSm7TQaGln5ut2vYVyJ7fPFOliX2rD7lPUQngPx04w,2423
194
194
  souleyez/parsers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -268,7 +268,7 @@ souleyez/reporting/charts.py,sha256=INz5CConGLyXG9JrMGVfUZmr1xjg4Jz2LKBVgGNAIt8,
268
268
  souleyez/reporting/compliance_mappings.py,sha256=S94wjiHw8BlGf7XYE7-I1czmF0Z_UU2FyxHp8J13az4,11176
269
269
  souleyez/reporting/detection_report.py,sha256=huS3iQ2yrSx5_hrJmOCErFmnCh1BaBiy5pplz-5JJuE,32396
270
270
  souleyez/reporting/formatters.py,sha256=g8b5JXbTClISX7zDX1fvwgZygoFfyZgZfIz1CHDvoyw,146591
271
- souleyez/reporting/generator.py,sha256=jUR7JsmMjccfx8nksIEHe5_GRkEepci0btRmJYznnvo,41904
271
+ souleyez/reporting/generator.py,sha256=0ANK_GbrHTTgzubZ2atn7ZrgE88lS8XCsdzCK7APM9M,41918
272
272
  souleyez/reporting/metrics.py,sha256=uBVma0HhES-lCuZZ0FAuz-k9oTm1UBmMYkzV7FCwfjM,5604
273
273
  souleyez/security/__init__.py,sha256=vDjPumWj259BuzPoDJLOfOHalajNsCFdZw5fA1B-Tkc,4621
274
274
  souleyez/security/scope_validator.py,sha256=wh-DxVTcc1Z8PORKfdgxH2VKqOBnkKbGDfYPTBz3PjU,20258
@@ -347,7 +347,7 @@ souleyez/ui/export_view.py,sha256=0nQvVsKk7FU4uRzSfJ_qBZh_Lfn8hgGA2rbJ5bNg5-Y,65
347
347
  souleyez/ui/gap_analysis_view.py,sha256=AytAOEBq010wwo9hne1TE-uJpY_xicjLrFANbvN3r3w,30727
348
348
  souleyez/ui/help_system.py,sha256=nKGxLaMi-TKYs6xudTyw_tZqBb1cGFEuYYh6N-MAsJE,16648
349
349
  souleyez/ui/intelligence_view.py,sha256=VeAQ-3mANRnLIVpRqocL3JV0HUmJtADdxDeC5lzQhE0,32168
350
- souleyez/ui/interactive.py,sha256=dkyIys13Q6_OsDO84-sg1DNQvVTttVOBHjIZV2sSM7w,1406611
350
+ souleyez/ui/interactive.py,sha256=RxfZ3yOfCnpWV0K1ta5Op3hP82eYGN0UYV8ME-41fuY,1406653
351
351
  souleyez/ui/interactive_selector.py,sha256=6A51fgmFRnemBY0aCPHIhK2Rpba16NjSGKLzC0Q5vI8,16407
352
352
  souleyez/ui/log_formatter.py,sha256=akhIkYoO_cCaKxS1V5N3iPmIrHzgsU7pmsedx70s9TI,3845
353
353
  souleyez/ui/menu_components.py,sha256=N8zq2QXGmfaLJ08l53MMYt1y-5LRWgpZH6r8nXHonj8,3519
@@ -364,15 +364,15 @@ souleyez/ui/team_dashboard.py,sha256=ejM_44nbJbEIPxxxdEK7SCPcqQtcuJLjoO-C53qED2Y
364
364
  souleyez/ui/template_selector.py,sha256=qQJkFNnVjYctb-toeYlupP_U1asGrJWYi5-HR89Ab9g,19103
365
365
  souleyez/ui/terminal.py,sha256=Sw9ma1-DZclJE1sENjTZ3Q7r-Ct1NiB3Lpmv-RZW5tE,2372
366
366
  souleyez/ui/timeline_view.py,sha256=Ze8Mev9VE4_ECdNFEJwZK2V42EBguR83uCCdwAbJqmc,11111
367
- souleyez/ui/tool_setup.py,sha256=8lAYppHamAfUdxBAxZIvwq7LEgR4YKFGDOC4jzSdTgM,32885
368
- souleyez/ui/tutorial.py,sha256=GGbBsze0ioL00WBWKEwPKy1ikegP1eusI2REDVMx4gY,14262
367
+ souleyez/ui/tool_setup.py,sha256=HkRTjzN7FHUs_XKtNYnphkdXb5kC4P6ghpI8TeCuEjU,36375
368
+ souleyez/ui/tutorial.py,sha256=XxF06vNVbuzHjkbHbft6fDPj6RSH0tqr4FZ3K8DPSrY,14800
369
369
  souleyez/ui/tutorial_state.py,sha256=Thf7_qCj4VKjG7UqgJqa9kjIqiFUU-7Q7kG4v-u2B4A,8123
370
370
  souleyez/ui/wazuh_vulns_view.py,sha256=3vJJEmrjgS2wD6EDB7ZV7WxgytBHTm-1WqNDjp7lVEI,21830
371
371
  souleyez/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
372
- souleyez/utils/tool_checker.py,sha256=kQcXJVY5NiO-orQAUnpHhpQvR5UOBNHJ0PaT0fBxYoQ,30782
373
- souleyez-2.40.0.dist-info/licenses/LICENSE,sha256=J7vDD5QMF4w2oSDm35eBgosATE70ah1M40u9W4EpTZs,1090
374
- souleyez-2.40.0.dist-info/METADATA,sha256=SNeLnrJmSFHHxRY66Sjzh-PaRQoFNxaDxwwFGNxuWtA,9434
375
- souleyez-2.40.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
376
- souleyez-2.40.0.dist-info/entry_points.txt,sha256=bN5W1dhjDZJl3TKclMjRpfQvGPmyrJLwwDuCj_X39HE,48
377
- souleyez-2.40.0.dist-info/top_level.txt,sha256=afAMzS9p4lcdBNxhGo6jl3ipQE9HUvvNIPOdjtPjr_Q,9
378
- souleyez-2.40.0.dist-info/RECORD,,
372
+ souleyez/utils/tool_checker.py,sha256=YZjEeHudjglvJk_MA-iQLzqEItFybhCy6PfaPoBANtE,30830
373
+ souleyez-2.43.3.dist-info/licenses/LICENSE,sha256=J7vDD5QMF4w2oSDm35eBgosATE70ah1M40u9W4EpTZs,1090
374
+ souleyez-2.43.3.dist-info/METADATA,sha256=SgqKTr7vd8TI_8YKA8yOHU1-QJez9VJH8HlFr9cAJvU,10425
375
+ souleyez-2.43.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
376
+ souleyez-2.43.3.dist-info/entry_points.txt,sha256=bN5W1dhjDZJl3TKclMjRpfQvGPmyrJLwwDuCj_X39HE,48
377
+ souleyez-2.43.3.dist-info/top_level.txt,sha256=afAMzS9p4lcdBNxhGo6jl3ipQE9HUvvNIPOdjtPjr_Q,9
378
+ souleyez-2.43.3.dist-info/RECORD,,
@@ -1,265 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: souleyez
3
- Version: 2.40.0
4
- Summary: AI-Powered Penetration Testing Platform with 40+ integrated tools
5
- Author-email: CyberSoul Security <contact@cybersoulsecurity.com>
6
- Maintainer-email: CyberSoul Security <contact@cybersoulsecurity.com>
7
- License: MIT
8
- Project-URL: Homepage, https://github.com/cyber-soul-security/SoulEyez
9
- Project-URL: Documentation, https://github.com/cyber-soul-security/SoulEyez#readme
10
- Project-URL: Repository, https://github.com/cyber-soul-security/SoulEyez.git
11
- Project-URL: Issues, https://github.com/cyber-soul-security/SoulEyez/issues
12
- Keywords: pentesting,security,hacking,penetration-testing,cybersecurity,nmap,metasploit
13
- Classifier: Development Status :: 4 - Beta
14
- Classifier: Environment :: Console
15
- Classifier: Environment :: Console :: Curses
16
- Classifier: Intended Audience :: Developers
17
- Classifier: Intended Audience :: Information Technology
18
- Classifier: Intended Audience :: System Administrators
19
- Classifier: License :: OSI Approved :: MIT License
20
- Classifier: Operating System :: POSIX :: Linux
21
- Classifier: Operating System :: MacOS
22
- Classifier: Programming Language :: Python :: 3
23
- Classifier: Programming Language :: Python :: 3.8
24
- Classifier: Programming Language :: Python :: 3.9
25
- Classifier: Programming Language :: Python :: 3.10
26
- Classifier: Programming Language :: Python :: 3.11
27
- Classifier: Programming Language :: Python :: 3.12
28
- Classifier: Programming Language :: Python :: 3.13
29
- Classifier: Topic :: Security
30
- Classifier: Topic :: System :: Networking
31
- Requires-Python: >=3.8
32
- Description-Content-Type: text/markdown
33
- License-File: LICENSE
34
- Requires-Dist: anthropic>=0.40.0
35
- Requires-Dist: click>=8.0.0
36
- Requires-Dist: cryptography>=3.4.0
37
- Requires-Dist: defusedxml>=0.7.0
38
- Requires-Dist: impacket>=0.11.0
39
- Requires-Dist: markdown>=3.4.0
40
- Requires-Dist: msgpack>=1.0.0
41
- Requires-Dist: ollama>=0.1.0
42
- Requires-Dist: psycopg2-binary>=2.9.0
43
- Requires-Dist: psutil>=5.9.0
44
- Requires-Dist: python-json-logger>=2.0.0
45
- Requires-Dist: requests>=2.28.0
46
- Requires-Dist: rich>=10.0.0
47
- Requires-Dist: wcwidth>=0.2.0
48
- Provides-Extra: dev
49
- Requires-Dist: pytest>=7.0.0; extra == "dev"
50
- Dynamic: license-file
51
-
52
- # SoulEyez — AI-Powered Penetration Testing Platform
53
-
54
- [![CI](https://github.com/cyber-soul-security/souleyez/actions/workflows/python-ci.yml/badge.svg)](https://github.com/cyber-soul-security/souleyez/actions/workflows/python-ci.yml)
55
- [![codecov](https://codecov.io/gh/cyber-soul-security/souleyez/branch/main/graph/badge.svg)](https://codecov.io/gh/cyber-soul-security/souleyez)
56
- [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
57
- [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
58
- [![Security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)
59
-
60
- **LEGAL NOTICE — Use Responsibly**
61
- Only use SoulEyez on systems you own or have explicit written permission to test.
62
- Unauthorized scanning or exploitation is illegal. The authors are not responsible for misuse.
63
-
64
- ---
65
-
66
- ## Features
67
-
68
- ### Core Capabilities
69
- - 🎯 **Interactive Dashboard** - Real-time engagement monitoring with live updates
70
- - 🔗 **Smart Tool Chaining** - Automatic follow-up scans based on discoveries
71
- - 📊 **Findings Management** - Track and categorize vulnerabilities by severity
72
- - 🔑 **Credential Vault** - Encrypted storage for discovered credentials
73
- - 🌐 **Network Mapping** - Host discovery and service enumeration
74
- - 📈 **Progress Tracking** - Monitor scan completion and tool execution
75
- - 💾 **SQLite Storage** - Local database for all engagement data
76
- - 🔄 **Background Jobs** - Queue-based tool execution with status monitoring
77
-
78
- ### Integrated Tools (40+)
79
- - **Reconnaissance**: nmap, masscan, theHarvester, whois, dnsrecon
80
- - **Web Testing**: nikto, gobuster, ffuf, sqlmap, nuclei, wpscan
81
- - **Enumeration**: enum4linux-ng, smbmap, crackmapexec, snmpwalk
82
- - **Exploitation**: Metasploit integration, searchsploit
83
- - **Password Attacks**: hydra, hashcat, john
84
- - **Post-Exploitation**: impacket suite, bloodhound
85
-
86
- ### Pentest Workflow & Intelligence
87
- - 📁 **Evidence Vault** - Unified artifact collection organized by PTES phases
88
- - 🎯 **Attack Surface Dashboard** - Track what's exploited vs pending with priority scoring
89
- - 💣 **Exploit Suggestions** - Automatic CVE/Metasploit recommendations for discovered services
90
- - 🔗 **Correlation Engine** - Cross-phase attack tracking and gap analysis
91
- - 📝 **Report Generator** - Professional reports in Markdown/HTML/PDF formats
92
- - ✅ **Deliverable Tracking** - Manage testing requirements and acceptance criteria
93
- - 📸 **Screenshot Management** - Organized visual evidence by methodology phase
94
-
95
- ### Purple Team / SIEM Integration
96
- - 🛡️ **Wazuh Integration** - Connect to Wazuh Manager for detection validation
97
- - 📊 **Splunk Integration** - Query Splunk for alerts and vulnerability data
98
- - ✓ **Detection Validation** - Verify if your attacks triggered SIEM alerts
99
- - 🔍 **Vulnerability Management** - View CVEs from Wazuh agents synced to Splunk
100
- - ⚖️ **Gap Analysis** - Compare passive (SIEM) vs active (scan) findings
101
- - 🗺️ **MITRE ATT&CK Reports** - Detection coverage heatmaps by technique
102
- - 📡 **Real-time Alerts** - Monitor SIEM alerts during live engagements
103
-
104
- ---
105
-
106
- ## 🔐 Security & Data Protection
107
-
108
- ### Credential Encryption
109
-
110
- SoulEyez encrypts all stored credentials using Fernet (AES-128-CBC + HMAC-SHA256) with PBKDF2 key derivation (600k iterations).
111
-
112
- ```bash
113
- # Enable encryption with master password
114
- souleyez db encrypt
115
-
116
- # Add credentials (automatically encrypted)
117
- souleyez creds add --username admin --password secret123 --service ssh --host 10.0.0.82
118
-
119
- # View credentials (requires master password)
120
- souleyez creds list
121
- ```
122
-
123
- **Key Points:**
124
- - Master password is never stored (cannot be recovered if lost)
125
- - Credentials encrypted at rest with industry-standard cryptography
126
- - Dashboard shows masked values (••••••••) until explicitly revealed
127
- - Each user should maintain their own database
128
-
129
- ### Data Masking
130
-
131
- Sensitive data is automatically masked in the UI:
132
- - Passwords: `Su***********3!`
133
- - Credit card numbers: `45**************34`
134
- - Access warning prompts before viewing sensitive data
135
-
136
- See [SECURITY.md](SECURITY.md) for complete security guidelines.
137
-
138
- ---
139
-
140
- ## 📝 Configuration
141
-
142
- SoulEyez uses a flexible configuration system:
143
-
144
- 1. **Environment Variables** - `SOULEYEZ_*` prefix (highest priority)
145
- 2. **Config File** - `~/.souleyez/config.json` (auto-created)
146
- 3. **Default Values** - Built-in safe defaults
147
-
148
- ```bash
149
- # Edit config file
150
- nano ~/.souleyez/config.json
151
-
152
- # Or use environment variables
153
- export SOULEYEZ_DATABASE_PATH=/custom/path/souleyez.db
154
- export SOULEYEZ_LOGGING_LEVEL=DEBUG
155
- ```
156
-
157
- See [docs/CONFIG.md](souleyez/docs/CONFIG.md) for complete configuration options.
158
-
159
- ---
160
-
161
- ## Supported Operating Systems
162
-
163
- | OS | Status | Notes |
164
- |----|--------|-------|
165
- | **Kali Linux** | ✅ Recommended | All pentesting tools pre-installed |
166
- | **Ubuntu 22.04+** | ✅ Supported | Tools installed via `souleyez setup` |
167
- | **Parrot OS** | ✅ Supported | Security-focused distro |
168
- | **Debian 12+** | ✅ Supported | Stable base system |
169
- | **Other Linux** | ⚠️ Unofficial | Manual testing required |
170
- | **macOS/Windows** | ❌ Not Supported | Use Linux in a VM |
171
-
172
- **Architectures:** AMD64, ARM64
173
-
174
- ---
175
-
176
- ## System Requirements
177
-
178
- | Component | Minimum | Recommended |
179
- |-----------|---------|-------------|
180
- | **CPU** | 2 cores | 4+ cores |
181
- | **RAM** | 4GB | 8GB+ |
182
- | **Disk** | 10GB | 50GB+ |
183
- | **GPU** | None | Optional (for hashcat) |
184
-
185
- ---
186
-
187
- ## Installation
188
-
189
- ```bash
190
- # Install pipx if needed
191
- sudo apt install pipx
192
- pipx ensurepath
193
- source ~/.bashrc # Kali Linux: use 'source ~/.zshrc' instead
194
-
195
- # Install SoulEyez
196
- pipx install souleyez
197
-
198
- # Install pentesting tools
199
- souleyez setup
200
- ```
201
-
202
- > **Kali Linux users:** Kali uses zsh by default. Use `source ~/.zshrc` instead of `source ~/.bashrc`
203
-
204
- See [docs/user-guide/installation.md](souleyez/docs/user-guide/installation.md) for detailed instructions.
205
-
206
- ---
207
-
208
- ## Usage
209
-
210
- ### Interactive Mode (Recommended)
211
-
212
- ```bash
213
- souleyez interactive
214
- ```
215
-
216
- Menu-driven interface with guided workflows, tool selection by phase, and integrated help.
217
-
218
- ### Dashboard
219
-
220
- ```bash
221
- souleyez dashboard
222
- ```
223
-
224
- Real-time monitoring with hotkeys: `[h]` Help, `[a]` Auto-chain, `[m]` Menu, `[q]` Quit
225
-
226
- ### Command Line
227
-
228
- ```bash
229
- # Engagement management
230
- souleyez workspace create <name>
231
- souleyez workspace use <name>
232
-
233
- # Run scans
234
- souleyez run nmap <target>
235
- souleyez run gobuster <target>
236
-
237
- # View results
238
- souleyez findings list
239
- souleyez creds list
240
- ```
241
-
242
- ---
243
-
244
- ## Documentation
245
-
246
- - **[Installation Guide](souleyez/docs/user-guide/installation.md)** - Setup instructions
247
- - **[Getting Started](souleyez/docs/user-guide/getting-started.md)** - Quick start guide
248
- - **[Workflows](souleyez/docs/user-guide/workflows.md)** - Complete pentesting workflows
249
- - **[Evidence Vault](souleyez/docs/user-guide/evidence-vault.md)** - Artifact collection
250
- - **[Report Generation](souleyez/docs/user-guide/report-generation.md)** - Professional reports
251
- - **[SECURITY.md](SECURITY.md)** - Security best practices
252
- - **[AUTO_CHAINING_GUIDE.md](AUTO_CHAINING_GUIDE.md)** - Automated workflows
253
-
254
- ---
255
-
256
- ## Support
257
-
258
- - **GitHub Issues**: https://github.com/cyber-soul-security/SoulEyez/issues
259
- - **Security Issues**: Report privately (see SECURITY.md)
260
-
261
- ---
262
-
263
- ## License
264
-
265
- See [LICENSE](LICENSE) for details.