Skip to content

sanchez314c/sweepOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

SweepOS

Linux system maintenance app. CleanMyMac for Linux, with GPU/VRAM management.

Features

  • Dev Cache Cleaning — pip, npm, conda, yarn, pnpm, bun, cargo caches
  • AI/ML Cache Cleaning — HuggingFace Hub, PyTorch Hub, Electron cache
  • System Cache Cleaning — thumbnails, fonts, shaders, journals, browser caches
  • Trash Manager — browse, select, and empty desktop trash
  • GPU Monitor — NVIDIA VRAM usage, process list, kill GPU processes, drop page cache
  • Ollama Manager — list, load, unload, and delete Ollama models
  • Smart Scan — one-click aggregate scan across all modules with tiered results
  • Dashboard — disk, RAM, GPU VRAM, uptime at a glance

Screenshots

SweepOS Dashboard

Installation

AppImage

Download the latest .AppImage from Releases, make it executable, and run:

chmod +x SweepOS-*.AppImage
./SweepOS-*.AppImage

Debian/Ubuntu

sudo dpkg -i sweepOS_*.deb

System Requirements

  • Linux (Ubuntu 22.04+, Fedora 38+, or equivalent)
  • NVIDIA GPU + nvidia-smi (optional, for GPU features)
  • Ollama (optional, for Ollama management)

Development

Prerequisites

  • Node.js 22+ (LTS)
  • npm 10+

Setup

git clone https://github.com/sanchez314c/sweepOS.git
cd sweepOS
npm ci
npm run dev

Build

npm run build:linux

Outputs .deb and .AppImage to dist/.

Stack

  • Electron 35 + React 19 + TypeScript 5.8
  • Tailwind CSS 4 + Neo-Noir Glass Monitor design system
  • electron-vite 3 (build tooling)
  • Zustand 5 (state) + electron-store 8 (persistence)
  • lucide-react (icons)
  • electron-builder (packaging)

Security

  • Context isolation enabled, nodeIntegration disabled
  • All system commands via execFile (no shell interpolation)
  • Path allowlist prevents deletes outside safe directories
  • Symlink resolution before any delete operation
  • Privileged operations use pkexec (graphical auth), never raw sudo
  • Every delete logged to ~/.config/sweepOS/clean-history.json

License

MIT. See LICENSE.

Author

Jason Paul Michaels — jason@jasonpaulmichaels.co

About

Linux system maintenance app. CleanMyMac for Linux, with GPU/VRAM management.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages