{"id":24716936,"url":"https://github.com/atticuszeller/pytorch-lightning-uv","last_synced_at":"2026-04-16T11:34:57.388Z","repository":{"id":273690929,"uuid":"920557974","full_name":"AtticusZeller/Pytorch-Lightning-uv","owner":"AtticusZeller","description":"📦 Zero-config Deep Learning template with PyTorch Lightning, UV package manager, W\u0026B tracking, and modern Python tooling 🚀","archived":false,"fork":false,"pushed_at":"2025-03-03T17:03:54.000Z","size":4821,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-03T18:22:42.183Z","etag":null,"topics":["classification","cuda","deep-learning","machine-learning","mnist-classification","python","pytorch","pytorch-lightning","typer","uv"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AtticusZeller.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-22T11:14:00.000Z","updated_at":"2025-02-20T09:31:31.000Z","dependencies_parsed_at":"2025-02-10T05:23:16.876Z","dependency_job_id":"f7ec95fb-eaa2-416d-beb2-4f9307c3bb79","html_url":"https://github.com/AtticusZeller/Pytorch-Lightning-uv","commit_stats":null,"previous_names":["atticuszeller/pytorch-lightning-uv"],"tags_count":4,"template":true,"template_full_name":"AtticusZeller/python-uv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtticusZeller%2FPytorch-Lightning-uv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtticusZeller%2FPytorch-Lightning-uv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtticusZeller%2FPytorch-Lightning-uv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtticusZeller%2FPytorch-Lightning-uv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AtticusZeller","download_url":"https://codeload.github.com/AtticusZeller/Pytorch-Lightning-uv/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244932994,"owners_count":20534270,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["classification","cuda","deep-learning","machine-learning","mnist-classification","python","pytorch","pytorch-lightning","typer","uv"],"created_at":"2025-01-27T09:14:55.893Z","updated_at":"2026-04-16T11:34:57.383Z","avatar_url":"https://github.com/AtticusZeller.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🧪 Pytorch Lightning UV Template\n\nA modern Deep Learning experiment template with PyTorch Lightning\n\n[![python](https://img.shields.io/badge/-Python_3.10_%7C_3.11_%7C_3.12-blue?logo=python\u0026logoColor=white)](https://www.python.org/downloads/release/python-310/)\n[![pytorch](https://img.shields.io/badge/PyTorch_2.5+-ee4c2c?logo=pytorch\u0026logoColor=white)](https://pytorch.org/get-started/locally/)\n[![lightning](https://img.shields.io/badge/-Lightning_2.5+-792ee5?logo=pytorchlightning\u0026logoColor=white)](https://lightning.ai/)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![license](https://img.shields.io/badge/License-MIT-green.svg?labelColor=gray)](https://github.com/ashleve/lightning-hydra-template#license)\n[![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/AtticusZeller/Pytorch-Lightning-uv/pulls)\n\nClick on [\u003ckbd\u003eUse this template\u003c/kbd\u003e](https://github.com/AtticusZeller/Pytorch-Lightning-uv/generate) to initialize new repository.\n\n\u003c/div\u003e\n\n## ✨ Features\n\n* 🚀 **UV Environment Management** - Fast and efficient dependency management\n* 🎯 **Typer CLI** - Modern command line interface\n* ⚙️ **YAML Config** - Flexible experiment configuration\n* 🔋 **Lightning Components**\n  + DataModule for clean data handling\n  + Model with built-in training logic\n  + Trainer with all the bells and whistles\n* 📊 **Weights \u0026 Biases Integration**\n  + Experiment tracking and visualization\n  + Hyperparameter optimization with sweeps\n  + Dataset analysis and exploration\n* 🎨 **Clean Project Structure**\n  + Modular and maintainable codebase\n  + Easy to extend and customize\n\n## 🛠️ Installation\n\n```bash\n# install dependencies\nuv sync --dev\n# install project as a package\nuv pip install -e .\n```\n\n\u003e [!note]\n\u003e 1. remember to replace `atticux` with your actual W\u0026B entity in the config files and `config.py`\n\n\u003e 2. `uv run` before bash scripts to ensure the environment is activated\n\n## 📊 Dataset Analysis\n\nExplore and analyze your dataset with built-in EDA tools:\n\n```bash\npython -m expt.main -c config/resnet.yml --eda\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e📈 View EDA Example\u003c/summary\u003e\n\n![EDA Example](assets/eda.png)\n\n\u003c/details\u003e\n\n## 🚀 Training\n\nStart training your model with a single command:\n\n```bash\npython -m expt.main -c config/resnet.yml --train\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e🔍 View Training Details\u003c/summary\u003e\n\n### Configuration Overview\n\n![Config Display](assets/config_show.png)\n\n### Training Progress\n\n![Training Step](assets/step.png)\n\n### Training Summary\n\n![Training Summary](assets/summary.png)\n\n### W\u0026B Dashboard\n\n![Wandb Dashboard](assets/train.png)\n\n\u003c/details\u003e\n\n## 📊 Evaluation\n\nEvaluate your trained model:\n\n```bash\npython -m expt.main -c config/resnet.yml --eval --run-id n8fjnlyi\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e📊 View Evaluation Results\u003c/summary\u003e\n\n![Evaluation Results](assets/result.png)\n\n\u003c/details\u003e\n\n## 🎛️ Hyperparameter Tuning\n\nOptimize your model with W\u0026B Sweeps:\n\n```bash\npython -m expt.main -c config/resnet.yml --sweep --sweep-config config/sweep/mlp.yml\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e📈 View Sweep Results\u003c/summary\u003e\n\n![Sweep Results](assets/sweep.png)\n\n\u003c/details\u003e\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgements\n\n* [PyTorch Lightning](https://lightning.ai/)\n* [Weights \u0026 Biases](https://wandb.ai/)\n* [Typer](https://typer.tiangolo.com/)\n* [UV](https://github.com/astral-sh/uv)\n\n---\n\n\u003cdiv align=\"center\"\u003e\nMade with ❤️ for the ML community\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatticuszeller%2Fpytorch-lightning-uv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatticuszeller%2Fpytorch-lightning-uv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatticuszeller%2Fpytorch-lightning-uv/lists"}