mundix-cli 0.7.0__tar.gz

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.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 MundiX (mundix.com.br)
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,3 @@
1
+ include README.md
2
+ include LICENSE
3
+ include requirements.txt
@@ -0,0 +1,202 @@
1
+ Metadata-Version: 2.4
2
+ Name: mundix-cli
3
+ Version: 0.7.0
4
+ Summary: AI-Powered Cybersecurity Copilot for Kali Linux — Think Claude Code, but built for hackers.
5
+ Home-page: https://github.com/k0k4/mundix-cli
6
+ Author: MundiX
7
+ Author-email: MundiX <contato@mundix.com.br>
8
+ License: MIT
9
+ Project-URL: Homepage, https://chat.mundix.dev
10
+ Project-URL: Documentation, https://chat.mundix.dev
11
+ Project-URL: Repository, https://github.com/k0k4/mundix-cli
12
+ Project-URL: Bug Tracker, https://github.com/k0k4/mundix-cli/issues
13
+ Project-URL: Buy Credits, https://chat.mundix.dev/billing
14
+ Keywords: cybersecurity,pentesting,kali-linux,ai,cli,hacking,red-team,security,copilot,terminal
15
+ Classifier: Development Status :: 4 - Beta
16
+ Classifier: Intended Audience :: Developers
17
+ Classifier: Intended Audience :: Information Technology
18
+ Classifier: Intended Audience :: Science/Research
19
+ Classifier: Topic :: Security
20
+ Classifier: Topic :: System :: Networking
21
+ Classifier: License :: OSI Approved :: MIT License
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: Operating System :: POSIX :: Linux
30
+ Classifier: Environment :: Console
31
+ Requires-Python: >=3.8
32
+ Description-Content-Type: text/markdown
33
+ License-File: LICENSE
34
+ Requires-Dist: openai>=1.0.0
35
+ Requires-Dist: rich>=13.0.0
36
+ Requires-Dist: prompt_toolkit>=3.0.0
37
+ Requires-Dist: requests>=2.28.0
38
+ Requires-Dist: packaging>=21.0
39
+ Dynamic: author
40
+ Dynamic: home-page
41
+ Dynamic: license-file
42
+ Dynamic: requires-python
43
+
44
+ # MundiX CLI
45
+
46
+ **AI-Powered Cybersecurity Copilot for Kali Linux**
47
+
48
+ MundiX CLI is an intelligent terminal assistant designed for penetration testers, red teamers, and security researchers. It connects to specialized cybersecurity AI models (DeepHat, WhiteRabbitNeo) via HuggingFace, and features a collective memory system that learns from all users.
49
+
50
+ Think of it as **Claude Code or GitHub Copilot, but built specifically for hackers.**
51
+
52
+ ---
53
+
54
+ ## Features
55
+
56
+ | Feature | Description |
57
+ | :--- | :--- |
58
+ | **AI Chat** | Interactive conversation with uncensored cybersecurity AI models |
59
+ | **Command Execution** | Extract and execute commands directly from AI responses |
60
+ | **Collective Memory** | Local + shared memory that improves with every user interaction |
61
+ | **Multi-Model** | Switch between DeepHat, WhiteRabbitNeo, and other models |
62
+ | **System Awareness** | AI knows your OS, tools, and current directory |
63
+ | **Safety Checks** | Dangerous commands are flagged before execution |
64
+ | **Streaming** | Real-time token streaming for fast responses |
65
+ | **One-Shot Mode** | Quick queries without entering interactive mode |
66
+
67
+ ---
68
+
69
+ ## Quick Install (Kali Linux)
70
+
71
+ ```bash
72
+ curl -sSL https://raw.githubusercontent.com/k0k4/mundix-cli/main/install.sh | bash
73
+ ```
74
+
75
+ ### Manual Install
76
+
77
+ ```bash
78
+ git clone https://github.com/k0k4/mundix-cli.git
79
+ cd mundix-cli
80
+ pip3 install -r requirements.txt
81
+ export HF_TOKEN="your_huggingface_token"
82
+ python3 mundix_cli.py
83
+ ```
84
+
85
+ ### Install via pip
86
+
87
+ ```bash
88
+ pip3 install -e .
89
+ mundix
90
+ ```
91
+
92
+ Get your free HuggingFace token at: https://huggingface.co/settings/tokens
93
+
94
+ ---
95
+
96
+ ## Usage
97
+
98
+ ### Interactive Mode
99
+ ```bash
100
+ mundix
101
+ ```
102
+
103
+ ### One-Shot Query
104
+ ```bash
105
+ mundix "how to scan for open ports on 10.0.0.1"
106
+ ```
107
+
108
+ ### Execute and Analyze
109
+ ```bash
110
+ mundix --exec "nmap -sV 10.0.0.1"
111
+ ```
112
+
113
+ ### Choose a Model
114
+ ```bash
115
+ mundix --model wrn-qwen-7b
116
+ ```
117
+
118
+ ---
119
+
120
+ ## Available Models
121
+
122
+ | Key | Model | Description |
123
+ | :--- | :--- | :--- |
124
+ | `deephat-7b` | DeepHat V1 7B | Cybersecurity & DevOps specialist (default) |
125
+ | `wrn-qwen-7b` | WhiteRabbitNeo 2.5 Qwen 7B | Offensive/Defensive cybersecurity |
126
+ | `wrn-llama-8b` | WhiteRabbitNeo Llama 8B v2 | General cybersecurity assistant |
127
+
128
+ ---
129
+
130
+ ## CLI Commands
131
+
132
+ Inside the interactive shell, use these slash commands:
133
+
134
+ | Command | Description |
135
+ | :--- | :--- |
136
+ | `/help` | Show help message |
137
+ | `/models` | List available AI models |
138
+ | `/model <name>` | Switch to a different model |
139
+ | `/memory` | Show memory statistics |
140
+ | `/sync` | Sync collective memory |
141
+ | `/clear` | Clear conversation history |
142
+ | `/system` | Show system information |
143
+ | `/history` | Show command execution history |
144
+ | `/exec <cmd>` | Execute a command directly |
145
+ | `/analyze` | Send last command output to AI |
146
+ | `/exit` | Exit MundiX CLI |
147
+
148
+ ---
149
+
150
+ ## Collective Memory
151
+
152
+ MundiX CLI features a unique **collective memory** system:
153
+
154
+ **How it works:** Every useful interaction (questions, commands, solutions) is saved locally. High-quality entries (upvoted by the user) are anonymized and shared with the MundiX collective memory. When you ask a question, the CLI first searches the collective memory for similar past solutions before querying the AI model, saving tokens and leveraging community knowledge.
155
+
156
+ **Privacy:** Only anonymized command patterns and solutions are shared. No personal data, IPs, or target information is ever transmitted.
157
+
158
+ ---
159
+
160
+ ## Project Structure
161
+
162
+ ```
163
+ mundix-cli/
164
+ mundix_cli.py # Main CLI application (REPL, UI, slash commands)
165
+ ai_provider.py # HuggingFace API integration (OpenAI-compatible)
166
+ memory.py # Collective memory system (local + sync)
167
+ system_integrator.py # Command execution and system interaction
168
+ install.sh # Quick installer for Kali Linux
169
+ requirements.txt # Python dependencies
170
+ setup.py # pip install support
171
+ test_modules.py # Module test suite
172
+ LICENSE # MIT License
173
+ ```
174
+
175
+ ---
176
+
177
+ ## Requirements
178
+
179
+ - Python 3.8+
180
+ - Linux (optimized for Kali Linux)
181
+ - HuggingFace API token (free tier works)
182
+
183
+ ---
184
+
185
+ ## Roadmap
186
+
187
+ - [ ] TUI dashboard with Rich panels (scan results, AI chat side by side)
188
+ - [ ] Plugin system for custom tools integration
189
+ - [ ] Collective memory API server for real-time community sync
190
+ - [ ] Voice input/output for hands-free operation
191
+ - [ ] Auto-reconnaissance mode (full automated recon pipeline)
192
+ - [ ] Integration with Metasploit RPC and Burp Suite API
193
+
194
+ ---
195
+
196
+ ## License
197
+
198
+ MIT License - [MundiX](https://mundix.com.br)
199
+
200
+ ---
201
+
202
+ **Built with purpose by MundiX. Happy Hacking.**
@@ -0,0 +1,159 @@
1
+ # MundiX CLI
2
+
3
+ **AI-Powered Cybersecurity Copilot for Kali Linux**
4
+
5
+ MundiX CLI is an intelligent terminal assistant designed for penetration testers, red teamers, and security researchers. It connects to specialized cybersecurity AI models (DeepHat, WhiteRabbitNeo) via HuggingFace, and features a collective memory system that learns from all users.
6
+
7
+ Think of it as **Claude Code or GitHub Copilot, but built specifically for hackers.**
8
+
9
+ ---
10
+
11
+ ## Features
12
+
13
+ | Feature | Description |
14
+ | :--- | :--- |
15
+ | **AI Chat** | Interactive conversation with uncensored cybersecurity AI models |
16
+ | **Command Execution** | Extract and execute commands directly from AI responses |
17
+ | **Collective Memory** | Local + shared memory that improves with every user interaction |
18
+ | **Multi-Model** | Switch between DeepHat, WhiteRabbitNeo, and other models |
19
+ | **System Awareness** | AI knows your OS, tools, and current directory |
20
+ | **Safety Checks** | Dangerous commands are flagged before execution |
21
+ | **Streaming** | Real-time token streaming for fast responses |
22
+ | **One-Shot Mode** | Quick queries without entering interactive mode |
23
+
24
+ ---
25
+
26
+ ## Quick Install (Kali Linux)
27
+
28
+ ```bash
29
+ curl -sSL https://raw.githubusercontent.com/k0k4/mundix-cli/main/install.sh | bash
30
+ ```
31
+
32
+ ### Manual Install
33
+
34
+ ```bash
35
+ git clone https://github.com/k0k4/mundix-cli.git
36
+ cd mundix-cli
37
+ pip3 install -r requirements.txt
38
+ export HF_TOKEN="your_huggingface_token"
39
+ python3 mundix_cli.py
40
+ ```
41
+
42
+ ### Install via pip
43
+
44
+ ```bash
45
+ pip3 install -e .
46
+ mundix
47
+ ```
48
+
49
+ Get your free HuggingFace token at: https://huggingface.co/settings/tokens
50
+
51
+ ---
52
+
53
+ ## Usage
54
+
55
+ ### Interactive Mode
56
+ ```bash
57
+ mundix
58
+ ```
59
+
60
+ ### One-Shot Query
61
+ ```bash
62
+ mundix "how to scan for open ports on 10.0.0.1"
63
+ ```
64
+
65
+ ### Execute and Analyze
66
+ ```bash
67
+ mundix --exec "nmap -sV 10.0.0.1"
68
+ ```
69
+
70
+ ### Choose a Model
71
+ ```bash
72
+ mundix --model wrn-qwen-7b
73
+ ```
74
+
75
+ ---
76
+
77
+ ## Available Models
78
+
79
+ | Key | Model | Description |
80
+ | :--- | :--- | :--- |
81
+ | `deephat-7b` | DeepHat V1 7B | Cybersecurity & DevOps specialist (default) |
82
+ | `wrn-qwen-7b` | WhiteRabbitNeo 2.5 Qwen 7B | Offensive/Defensive cybersecurity |
83
+ | `wrn-llama-8b` | WhiteRabbitNeo Llama 8B v2 | General cybersecurity assistant |
84
+
85
+ ---
86
+
87
+ ## CLI Commands
88
+
89
+ Inside the interactive shell, use these slash commands:
90
+
91
+ | Command | Description |
92
+ | :--- | :--- |
93
+ | `/help` | Show help message |
94
+ | `/models` | List available AI models |
95
+ | `/model <name>` | Switch to a different model |
96
+ | `/memory` | Show memory statistics |
97
+ | `/sync` | Sync collective memory |
98
+ | `/clear` | Clear conversation history |
99
+ | `/system` | Show system information |
100
+ | `/history` | Show command execution history |
101
+ | `/exec <cmd>` | Execute a command directly |
102
+ | `/analyze` | Send last command output to AI |
103
+ | `/exit` | Exit MundiX CLI |
104
+
105
+ ---
106
+
107
+ ## Collective Memory
108
+
109
+ MundiX CLI features a unique **collective memory** system:
110
+
111
+ **How it works:** Every useful interaction (questions, commands, solutions) is saved locally. High-quality entries (upvoted by the user) are anonymized and shared with the MundiX collective memory. When you ask a question, the CLI first searches the collective memory for similar past solutions before querying the AI model, saving tokens and leveraging community knowledge.
112
+
113
+ **Privacy:** Only anonymized command patterns and solutions are shared. No personal data, IPs, or target information is ever transmitted.
114
+
115
+ ---
116
+
117
+ ## Project Structure
118
+
119
+ ```
120
+ mundix-cli/
121
+ mundix_cli.py # Main CLI application (REPL, UI, slash commands)
122
+ ai_provider.py # HuggingFace API integration (OpenAI-compatible)
123
+ memory.py # Collective memory system (local + sync)
124
+ system_integrator.py # Command execution and system interaction
125
+ install.sh # Quick installer for Kali Linux
126
+ requirements.txt # Python dependencies
127
+ setup.py # pip install support
128
+ test_modules.py # Module test suite
129
+ LICENSE # MIT License
130
+ ```
131
+
132
+ ---
133
+
134
+ ## Requirements
135
+
136
+ - Python 3.8+
137
+ - Linux (optimized for Kali Linux)
138
+ - HuggingFace API token (free tier works)
139
+
140
+ ---
141
+
142
+ ## Roadmap
143
+
144
+ - [ ] TUI dashboard with Rich panels (scan results, AI chat side by side)
145
+ - [ ] Plugin system for custom tools integration
146
+ - [ ] Collective memory API server for real-time community sync
147
+ - [ ] Voice input/output for hands-free operation
148
+ - [ ] Auto-reconnaissance mode (full automated recon pipeline)
149
+ - [ ] Integration with Metasploit RPC and Burp Suite API
150
+
151
+ ---
152
+
153
+ ## License
154
+
155
+ MIT License - [MundiX](https://mundix.com.br)
156
+
157
+ ---
158
+
159
+ **Built with purpose by MundiX. Happy Hacking.**