Task Manager Pro

Task Manager Pro is a local, cross-platform Streamlit system-monitor dashboard that shows processes, network connections, disk usage and OS-aware optimization recommendations. It includes per-process drill-downs, CSV/JSON/ZIP exports and permission-aware fallbacks for platforms that restrict psutil visibility.

Getting started (developer)

Prerequisites

• Python 3.12 (or a compatible 3.10+ interpreter)
• Git

Quick setup (macOS / Linux - zsh)

# from project root
./setup.sh

This script creates a virtualenv at .venv and installs dependencies from requirements.txt.

Run the app

# Run main dashboard (default port 8501)
./run_main.sh

# Run secondary app (example port 8502)
./run_app.sh 8502

Integration smoke test

There is a small smoke test that launches Streamlit headlessly, checks HTTP 200 and saves the homepage snapshot to /tmp/tmpro_index.html:

chmod +x integration_test.sh
./integration_test.sh

Permission note

• On macOS some per-process network details require elevated privileges. To see per-process network connections, run Streamlit with elevated privileges (sudo) or enable appropriate permissions for the process.

Repository contents

• main.py — main Streamlit app UI and logic
• app.py — optional secondary app
• requirements.txt — pinned dependencies
• run_main.sh, run_app.sh, start_all.sh — helper run scripts
• integration_test.sh — simple headless smoke test (local)
• .github/workflows/ci.yml — CI to run quick checks on PRs

Contributing

See CONTRIBUTING.md for the simple contributor guide and how to run local checks.

License

Add your license file here if you want to publish this repo publicly.