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.
- {msiltop-0.2.0 → msiltop-0.2.2}/CLAUDE.md +4 -3
- {msiltop-0.2.0 → msiltop-0.2.2}/PKG-INFO +10 -40
- {msiltop-0.2.0 → msiltop-0.2.2}/README.md +9 -39
- {msiltop-0.2.0 → msiltop-0.2.2}/docs/FAQ.md +1 -1
- {msiltop-0.2.0 → msiltop-0.2.2}/pyproject.toml +1 -1
- {msiltop-0.2.0 → msiltop-0.2.2}/.github/workflows/ci.yml +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/.github/workflows/release.yml +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/.gitignore +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/.whitesource +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/LICENSE +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/_config.yml +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/docs/powermetrics.manual +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/docs/powermetrics.md +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/images/pic.png +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/msiltop/__init__.py +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/msiltop/msiltop.py +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/msiltop/parsers.py +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/msiltop/soc_info.json +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/msiltop/utils.py +0 -0
- {msiltop-0.2.0 → msiltop-0.2.2}/uv.lock +0 -0
|
@@ -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 --
|
|
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 --
|
|
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
|
-
- `--
|
|
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.
|
|
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
|
-
[](https://badge.fury.io/py/msiltop)
|
|
43
42
|
[](https://www.python.org/downloads/)
|
|
44
43
|
[](https://www.apple.com/macos/)
|
|
45
44
|
[](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 [
|
|
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 --
|
|
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 --
|
|
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
|
-
--
|
|
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
|
|
155
|
-
sudo msiltop --
|
|
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
|
-
## 🐛
|
|
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
|
-
|
|
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
|
-
[](https://badge.fury.io/py/msiltop)
|
|
4
3
|
[](https://www.python.org/downloads/)
|
|
5
4
|
[](https://www.apple.com/macos/)
|
|
6
5
|
[](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 [
|
|
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 --
|
|
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 --
|
|
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
|
-
--
|
|
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
|
|
116
|
-
sudo msiltop --
|
|
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
|
-
## 🐛
|
|
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
|
-
|
|
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
|
|
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.
|
|
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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|