msiltop 0.2.0__tar.gz → 0.2.2__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.
@@ -81,7 +81,7 @@ pip install msiltop
81
81
  sudo uv run msiltop
82
82
 
83
83
  # Run with options
84
- sudo uv run msiltop --interval 2 --color 5 --avg 60 --show_cores
84
+ sudo uv run msiltop --interval 2 --theme cyan --avg 60 --show_cores
85
85
 
86
86
  # Alternative: run the module directly
87
87
  sudo uv run -m msiltop.msiltop
@@ -99,12 +99,13 @@ sudo msiltop
99
99
  msiltop
100
100
 
101
101
  # With options
102
- msiltop --interval 2 --color 5 --avg 60 --show_cores
102
+ msiltop --interval 2 --theme cyan --avg 60 --show_cores
103
103
  ```
104
104
 
105
105
  ### Available Command Line Options
106
106
  - `--interval INTERVAL`: Display and powermetrics sampling interval (seconds, default: 1)
107
- - `--color COLOR`: Color theme selection 0-8 (default: 2)
107
+ - `--theme THEME`: Color theme selection (default: cyan)
108
+ - Options: default, dark, blue, green, red, purple, orange, cyan, magenta
108
109
  - `--avg AVG`: Averaging window for power values (seconds, default: 30)
109
110
  - `--show_cores`: Enable individual core monitoring display
110
111
  - `--max_count COUNT`: Restart powermetrics after N samples (for long-running sessions)
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: msiltop
3
- Version: 0.2.0
3
+ Version: 0.2.2
4
4
  Summary: Real-time macOS hardware performance monitoring for Apple Silicon (M1/M2/M3/M4) with AI workload focus - enhanced asitop alternative
5
5
  Project-URL: Homepage, https://github.com/pratikdevnani/msiltop
6
6
  Project-URL: Repository, https://github.com/pratikdevnani/msiltop
@@ -39,7 +39,6 @@ Description-Content-Type: text/markdown
39
39
 
40
40
  # MSILTOP - MacOS Performance Monitor for Local AI
41
41
 
42
- [![PyPI version](https://badge.fury.io/py/msiltop.svg)](https://badge.fury.io/py/msiltop)
43
42
  [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
44
43
  [![macOS](https://img.shields.io/badge/macOS-Monterey%2B-green.svg)](https://www.apple.com/macos/)
45
44
  [![Apple Silicon](https://img.shields.io/badge/Apple%20Silicon-M1%2FM2%2FM3%2FM4-orange.svg)](https://www.apple.com/mac/)
@@ -47,7 +46,7 @@ Description-Content-Type: text/markdown
47
46
 
48
47
  **Real-time macOS hardware performance monitoring CLI tool for Apple Silicon Macs (M1/M2/M3/M4+) with AI workload focus**
49
48
 
50
- MSILTOP is a Python-based `nvtop`-inspired command line tool specifically designed for Apple Silicon Macs. This enhanced and actively maintained fork of the original [asitop](https://github.com/tlkh/asitop) project provides comprehensive hardware monitoring with additional features, support for newer Apple Silicon chips, and optimizations for modern terminal emulators including Ghostty.
49
+ MSILTOP is a Python-based `nvtop`-inspired command line tool specifically designed for Apple Silicon Macs. This enhanced and actively maintained fork of the original [fluidtop](https://github.com/FluidInference/fluidtop) project provides comprehensive hardware monitoring with additional features, support for newer Apple Silicon chips, and optimizations for modern terminal emulators including Ghostty.
51
50
 
52
51
 
53
52
  ## 📦 Installation & Usage
@@ -64,7 +63,7 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
64
63
  sudo uvx msiltop
65
64
 
66
65
  # Run with custom options
67
- sudo uvx msiltop --interval 2 --color 5 --avg 60
66
+ sudo uvx msiltop --interval 2 --theme cyan --avg 60
68
67
 
69
68
  # Or install as a tool for regular usages
70
69
  uv tool install msiltop@latest -U
@@ -78,7 +77,7 @@ uv tool install msiltop@latest -U
78
77
 
79
78
  ```bash
80
79
  # Run with custom options
81
- sudo uvx msiltop --interval 2 --color 5 --avg 60
80
+ sudo uvx msiltop --interval 2 --theme cyan --avg 60
82
81
  ```
83
82
 
84
83
  ### Install from PyPI
@@ -132,7 +131,8 @@ msiltop [OPTIONS]
132
131
 
133
132
  Options:
134
133
  --interval INTERVAL Display refresh rate in seconds (default: 1.0)
135
- --color COLOR Color theme selection 0-8 (default: 2)
134
+ --theme THEME Color theme selection (default: cyan)
135
+ Options: default, dark, blue, green, red, purple, orange, cyan, magenta
136
136
  --avg AVG Power averaging window in seconds (default: 30)
137
137
  --show_cores Enable individual CPU core monitoring
138
138
  --max_count COUNT Restart powermetrics after N samples (stability)
@@ -151,8 +151,8 @@ sudo msiltop --interval 0.5 --show_cores
151
151
  # Long-term monitoring with 60-second power averaging
152
152
  sudo msiltop --avg 60 --max_count 1000
153
153
 
154
- # Custom color theme
155
- sudo msiltop --color 5
154
+ # Custom theme
155
+ sudo msiltop --theme purple
156
156
  ```
157
157
 
158
158
  ## 🔧 How MSILTOP Works
@@ -176,15 +176,6 @@ MSILTOP leverages macOS's built-in [`powermetrics`](https://www.unix.com/man-pag
176
176
  * **Python:** Python 3.8+ (automatically managed with UV)
177
177
  * **Privileges:** Root access required for `powermetrics`
178
178
 
179
- ### Why Fork asitop?
180
-
181
- The original `asitop` provided excellent Apple Silicon monitoring but lacked:
182
-
183
- - **Modern hardware support** - M3, M4+ compatibility
184
- - **Terminal compatibility** - Ghostty and modern terminal optimization
185
- - **AI workload focus** - Machine learning specific monitoring
186
- - **Active maintenance** - Regular updates and bug fixes
187
-
188
179
  ### Migration from asitop
189
180
 
190
181
  MSILTOP is a drop-in replacement for asitop with identical command-line interface:
@@ -207,20 +198,6 @@ For detailed information, troubleshooting, and frequently asked questions, see o
207
198
  - **Troubleshooting**: Common issues and solutions
208
199
  - **Migration Guide**: Differences from asitop and compatibility
209
200
 
210
- ## 🗺️ Roadmap & Development
211
-
212
- ### Completed Features
213
- - ✅ Enhanced hardware support (M1-M4+)
214
- - ✅ Ghostty terminal optimization
215
- - ✅ Improved documentation and user experience
216
- - ✅ PyPI publishing and UV integration
217
-
218
- ### In Development
219
- - 🔄 monitor a specific process/application
220
- - 🔄 GUI-less monitoring and data collection
221
- - 🔄 Performance data export capabilities (CSV, JSON)
222
- - API interface for other Python services
223
-
224
201
  ## 🛠️ Development & Publishing
225
202
 
226
203
  ### Automated Release Process
@@ -248,14 +225,7 @@ sudo uv run msiltop --help # Verify build works
248
225
  ```
249
226
 
250
227
 
251
- ## 🐛 Known Issues & Contributing
252
-
253
- ### Current Issues
254
- - Chart height doesn't adapt to terminal height (width works correctly)
255
- - Plot colors don't always respect theme selection
256
- - Long-running sessions may require periodic restart
257
-
258
- ### Contributing
228
+ ## 🐛 Contributing
259
229
  - Report bugs and request features via [GitHub Issues](https://github.com/pratikdevnani/msiltop/issues)
260
230
  - Submit pull requests for bug fixes and improvements
261
231
  - Improve documentation and examples
@@ -269,7 +239,7 @@ MIT License - maintaining compatibility with the original asitop project.
269
239
 
270
240
  This project builds upon the excellent foundation created by [Timothy Liu](https://github.com/tlkh) with the original [asitop](https://github.com/tlkh/asitop) project. We extend our gratitude for creating the groundwork for Apple Silicon performance monitoring.
271
241
 
272
- This project adds to the MSILTOP project created by [pratikdevnani](https://github.com/pratikdevnani/msiltop).
242
+ MSILTOP is a lightweight fork of [FluidInference's fluidtop](https://github.com/FluidInference/fluidtop). The motivation for this fork is to keep the tool lean and focused by removing features that are not necessary, based on my understanding of the core use cases.
273
243
 
274
244
  ---
275
245
 
@@ -1,6 +1,5 @@
1
1
  # MSILTOP - MacOS Performance Monitor for Local AI
2
2
 
3
- [![PyPI version](https://badge.fury.io/py/msiltop.svg)](https://badge.fury.io/py/msiltop)
4
3
  [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
5
4
  [![macOS](https://img.shields.io/badge/macOS-Monterey%2B-green.svg)](https://www.apple.com/macos/)
6
5
  [![Apple Silicon](https://img.shields.io/badge/Apple%20Silicon-M1%2FM2%2FM3%2FM4-orange.svg)](https://www.apple.com/mac/)
@@ -8,7 +7,7 @@
8
7
 
9
8
  **Real-time macOS hardware performance monitoring CLI tool for Apple Silicon Macs (M1/M2/M3/M4+) with AI workload focus**
10
9
 
11
- MSILTOP is a Python-based `nvtop`-inspired command line tool specifically designed for Apple Silicon Macs. This enhanced and actively maintained fork of the original [asitop](https://github.com/tlkh/asitop) project provides comprehensive hardware monitoring with additional features, support for newer Apple Silicon chips, and optimizations for modern terminal emulators including Ghostty.
10
+ MSILTOP is a Python-based `nvtop`-inspired command line tool specifically designed for Apple Silicon Macs. This enhanced and actively maintained fork of the original [fluidtop](https://github.com/FluidInference/fluidtop) project provides comprehensive hardware monitoring with additional features, support for newer Apple Silicon chips, and optimizations for modern terminal emulators including Ghostty.
12
11
 
13
12
 
14
13
  ## 📦 Installation & Usage
@@ -25,7 +24,7 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
25
24
  sudo uvx msiltop
26
25
 
27
26
  # Run with custom options
28
- sudo uvx msiltop --interval 2 --color 5 --avg 60
27
+ sudo uvx msiltop --interval 2 --theme cyan --avg 60
29
28
 
30
29
  # Or install as a tool for regular usages
31
30
  uv tool install msiltop@latest -U
@@ -39,7 +38,7 @@ uv tool install msiltop@latest -U
39
38
 
40
39
  ```bash
41
40
  # Run with custom options
42
- sudo uvx msiltop --interval 2 --color 5 --avg 60
41
+ sudo uvx msiltop --interval 2 --theme cyan --avg 60
43
42
  ```
44
43
 
45
44
  ### Install from PyPI
@@ -93,7 +92,8 @@ msiltop [OPTIONS]
93
92
 
94
93
  Options:
95
94
  --interval INTERVAL Display refresh rate in seconds (default: 1.0)
96
- --color COLOR Color theme selection 0-8 (default: 2)
95
+ --theme THEME Color theme selection (default: cyan)
96
+ Options: default, dark, blue, green, red, purple, orange, cyan, magenta
97
97
  --avg AVG Power averaging window in seconds (default: 30)
98
98
  --show_cores Enable individual CPU core monitoring
99
99
  --max_count COUNT Restart powermetrics after N samples (stability)
@@ -112,8 +112,8 @@ sudo msiltop --interval 0.5 --show_cores
112
112
  # Long-term monitoring with 60-second power averaging
113
113
  sudo msiltop --avg 60 --max_count 1000
114
114
 
115
- # Custom color theme
116
- sudo msiltop --color 5
115
+ # Custom theme
116
+ sudo msiltop --theme purple
117
117
  ```
118
118
 
119
119
  ## 🔧 How MSILTOP Works
@@ -137,15 +137,6 @@ MSILTOP leverages macOS's built-in [`powermetrics`](https://www.unix.com/man-pag
137
137
  * **Python:** Python 3.8+ (automatically managed with UV)
138
138
  * **Privileges:** Root access required for `powermetrics`
139
139
 
140
- ### Why Fork asitop?
141
-
142
- The original `asitop` provided excellent Apple Silicon monitoring but lacked:
143
-
144
- - **Modern hardware support** - M3, M4+ compatibility
145
- - **Terminal compatibility** - Ghostty and modern terminal optimization
146
- - **AI workload focus** - Machine learning specific monitoring
147
- - **Active maintenance** - Regular updates and bug fixes
148
-
149
140
  ### Migration from asitop
150
141
 
151
142
  MSILTOP is a drop-in replacement for asitop with identical command-line interface:
@@ -168,20 +159,6 @@ For detailed information, troubleshooting, and frequently asked questions, see o
168
159
  - **Troubleshooting**: Common issues and solutions
169
160
  - **Migration Guide**: Differences from asitop and compatibility
170
161
 
171
- ## 🗺️ Roadmap & Development
172
-
173
- ### Completed Features
174
- - ✅ Enhanced hardware support (M1-M4+)
175
- - ✅ Ghostty terminal optimization
176
- - ✅ Improved documentation and user experience
177
- - ✅ PyPI publishing and UV integration
178
-
179
- ### In Development
180
- - 🔄 monitor a specific process/application
181
- - 🔄 GUI-less monitoring and data collection
182
- - 🔄 Performance data export capabilities (CSV, JSON)
183
- - API interface for other Python services
184
-
185
162
  ## 🛠️ Development & Publishing
186
163
 
187
164
  ### Automated Release Process
@@ -209,14 +186,7 @@ sudo uv run msiltop --help # Verify build works
209
186
  ```
210
187
 
211
188
 
212
- ## 🐛 Known Issues & Contributing
213
-
214
- ### Current Issues
215
- - Chart height doesn't adapt to terminal height (width works correctly)
216
- - Plot colors don't always respect theme selection
217
- - Long-running sessions may require periodic restart
218
-
219
- ### Contributing
189
+ ## 🐛 Contributing
220
190
  - Report bugs and request features via [GitHub Issues](https://github.com/pratikdevnani/msiltop/issues)
221
191
  - Submit pull requests for bug fixes and improvements
222
192
  - Improve documentation and examples
@@ -230,7 +200,7 @@ MIT License - maintaining compatibility with the original asitop project.
230
200
 
231
201
  This project builds upon the excellent foundation created by [Timothy Liu](https://github.com/tlkh) with the original [asitop](https://github.com/tlkh/asitop) project. We extend our gratitude for creating the groundwork for Apple Silicon performance monitoring.
232
202
 
233
- This project adds to the MSILTOP project created by [pratikdevnani](https://github.com/pratikdevnani/msiltop).
203
+ MSILTOP is a lightweight fork of [FluidInference's fluidtop](https://github.com/FluidInference/fluidtop). The motivation for this fork is to keep the tool lean and focused by removing features that are not necessary, based on my understanding of the core use cases.
234
204
 
235
205
  ---
236
206
 
@@ -86,7 +86,7 @@ sudo msiltop
86
86
 
87
87
  Try these solutions:
88
88
  1. Resize your terminal window to be larger
89
- 2. Use a different color theme: `sudo msiltop --color 0`
89
+ 2. Use a different theme: `sudo msiltop --theme default`
90
90
  3. Clear your terminal: `clear` before running FluidTop
91
91
  4. Update to the latest version: `uv tool install msiltop@latest -U`
92
92
 
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "msiltop"
7
- version = "0.2.0"
7
+ version = "0.2.2"
8
8
  description = "Real-time macOS hardware performance monitoring for Apple Silicon (M1/M2/M3/M4) with AI workload focus - enhanced asitop alternative"
9
9
  readme = "README.md"
10
10
  license = "MIT"
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes