🧰 Mini Toolkit

A collection of 25 everyday utilities — image editing, document conversion, text tools and website checks — in one fast, clean Streamlit app. No sign-up, no clutter.

Tools

Every tool has its own shareable URL, e.g. /?tool=qr-code.

Install from PyPI

pip install streamlit-mini-toolkit          # core tools
pip install "streamlit-mini-toolkit[all]"   # + background remover, OCR, DOCX/PDF conversion
mini-toolkit                                # opens the app at http://localhost:8501

Pick extras individually if you prefer: [bg] (Background Remover), [ocr] (OCR Text Extractor), [docs] (DOCX ↔ PDF). Streamlit flags pass through, e.g. mini-toolkit --server.port 8080.

Quick start (from source)

Requires Python 3.9+.

git clone https://github.com/sarif-mia/mini-toolkit.git
cd mini-toolkit
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
streamlit run app.py

The app opens at http://localhost:8501.

System dependencies (optional)

A few tools call external programs. Everything else works without them.

On Debian/Ubuntu: sudo xargs apt-get install -y < packages.txt

Deployment

Streamlit Community Cloud (recommended, free)

1. Go to share.streamlit.io and sign in with GitHub.
2. Create app → pick this repository, branch master, main file app.py.
3. Deploy. requirements.txt and packages.txt are picked up automatically.

Docker (Render, Railway, Fly.io, Hugging Face Spaces, …)

docker build -t mini-toolkit .
docker run -p 8501:8501 mini-toolkit

Why not Vercel? Vercel runs short-lived serverless functions, while Streamlit needs a long-running server with a persistent WebSocket connection. Use one of the options above instead.

Optional secrets

The Website Change Tracker can email change summaries. Add these to .streamlit/secrets.toml locally, or to your host's secrets settings:

smtp_server = "smtp.gmail.com"
smtp_port = 587
smtp_user = "you@example.com"
smtp_pass = "app-password"

Project structure

app.py               Entry point: page config, routing, home page
core/
  registry.py        List of tools and categories (add new tools here)
  ui.py              Shared UI helpers (headers, uploads, ZIP export, footer)
  net.py             Safe HTTP fetching for the web tools
tools/               One module per tool, each exposing render()
style/style.css      Custom styling
.streamlit/          Theme and server config

Adding a tool

1. Create tools/my_tool.py with a render() function.
2. Register it in core/registry.py:

   Tool("my-tool", "My Tool", "🧪", "One-line description.", TEXT, "my_tool"),
   

Tools are imported lazily, so a missing optional dependency only affects that one tool.

License

Distributed under the MIT License. See LICENSE.

Built by Sarif · GitHub · LinkedIn