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.
- mundix_cli-0.7.0/LICENSE +21 -0
- mundix_cli-0.7.0/MANIFEST.in +3 -0
- mundix_cli-0.7.0/PKG-INFO +202 -0
- mundix_cli-0.7.0/README.md +159 -0
- mundix_cli-0.7.0/ai_provider.py +530 -0
- mundix_cli-0.7.0/autopilot.py +400 -0
- mundix_cli-0.7.0/memory.py +201 -0
- mundix_cli-0.7.0/mundix_cli.egg-info/PKG-INFO +202 -0
- mundix_cli-0.7.0/mundix_cli.egg-info/SOURCES.txt +19 -0
- mundix_cli-0.7.0/mundix_cli.egg-info/dependency_links.txt +1 -0
- mundix_cli-0.7.0/mundix_cli.egg-info/entry_points.txt +2 -0
- mundix_cli-0.7.0/mundix_cli.egg-info/requires.txt +5 -0
- mundix_cli-0.7.0/mundix_cli.egg-info/top_level.txt +8 -0
- mundix_cli-0.7.0/mundix_cli.py +1536 -0
- mundix_cli-0.7.0/playbooks.py +758 -0
- mundix_cli-0.7.0/project.py +653 -0
- mundix_cli-0.7.0/pyproject.toml +67 -0
- mundix_cli-0.7.0/requirements.txt +5 -0
- mundix_cli-0.7.0/setup.cfg +4 -0
- mundix_cli-0.7.0/setup.py +58 -0
- mundix_cli-0.7.0/system_integrator.py +359 -0
mundix_cli-0.7.0/LICENSE
ADDED
|
@@ -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,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.**
|