smartrun 0.2.0

Run any Python script with automatic environment setup, fast package resolution via uv, and reproducible lockfile generation

smartrun

Run any Python script in a clean, disposable virtual environment — automatically.

smartrun 🚀

Run Python and Jupyter files with zero setup, zero pollution. Just run it.

smartrun scans your script or notebook, detects the required third-party packages, creates (or reuses) an isolated environment, installs what’s missing — and runs your code.

✅ No more ModuleNotFoundError
✅ No more cluttered global site-packages
✅ Just clean, reproducible execution — every time

Features

• 🧪 Supports both .py and .ipynb files
• 🔍 Automatically detects and resolves imports
• 🛠️ Uses venv or fast uv environments (if available)
• 📦 Installs only what's needed, only when needed
• 💡 Reuses environments smartly to save time

---

Installation

pip install smartrun

Requires Python 3.10+

---

Usage

smartrun your_script.py
## Notebook
```bash
smartrun your_notebook.ipynb

If the dependency isn’t installed yet, smartrun will fetch it automatically.

Why smartrun?

Because setup should never block you from running great code. Whether you're experimenting, prototyping, or sharing — smartrun ensures your script runs smoothly, without dependency drama.

Contributing

Contributions are welcome! 🧑‍💻

If you’ve got ideas, bug fixes, or improvements — feel free to open an issue or a pull request. Let’s make smartrun even smarter together.

License

BSD 3‑Clause — see LICENSE for details.

---