A package to auto-generate structured ML project folders
Project description
๐ Updated README.md for ml_project_setup
# ๐ ml_project_setup
A simple Python package to **automate the creation of structured Machine Learning projects** with a single command.
## ๐ Overview
Setting up a clean and organized ML project can be time-consuming. **`ml_project_setup`** makes it effortless by generating the **entire project structure**, including essential files and dependencies.
---
## ๐ Project Structure Created
When you run `mlsetup my_project`, the following structure is created:
my_project/ โโโ source/ โ โโโ components/ โ โโโ constants/ โ โโโ entity/ โ โโโ pipeline/ โ โโโ utility/ โ โโโ exception/ โ โโโ logger/ โโโ data/ # Placeholder for datasets โโโ models/ # Stores trained models โโโ notebooks/ # Jupyter notebooks for experiments โโโ .gitignore # Ignores unnecessary files โโโ config.yaml # Configuration settings โโโ Dockerfile # For containerization โโโ main.py # Entry point script โโโ README.md # Project documentation โโโ requirements.txt # Dependencies โโโ setup.py # Package setup โโโ setup_env.bat # Windows environment setup โโโ setup_env.sh # Linux/macOS environment setup
---
## ๐ Installation
Install the package using **pip**:
```sh
pip install ml_project_setup
๐ Usage
To create a new Machine Learning project, run:
mlsetup my_project
This will generate a structured ML project named my_project in the current directory.
โ Select ML Framework During Setup
You'll be prompted to choose an ML framework, and the package will automatically install it:
๐ Welcome to ML Project Setup! ๐
Enter your project name: my_ml_project
Select ML Framework:
[1] scikit-learn (default)
[2] PyTorch
[3] TensorFlow
Enter your choice (1/2/3): 2
๐ฆ Installing PyTorch... This may take a while.
โ
PyTorch installed successfully!
โ
Project 'my_ml_project' created with PyTorch framework!
๐ฆ Dependencies
This package installs dependencies automatically, depending on the framework you select:
| Framework | Installed Packages |
|---|---|
| scikit-learn (default) | scikit-learn |
| PyTorch | torch, torchvision, torchaudio |
| TensorFlow | tensorflow |
If needed, you can manually install dependencies:
pip install -r requirements.txt
๐ License
This project is licensed under the MIT License. See the LICENSE file for details.
๐ค Author
Developed by Amogh Pathak
๐ง Contact: amogh9792@gmail.com
โจ Contribute & Improve
Have suggestions or feature requests? Feel free to open an issue or contribute on GitHub!
๐ PyPI: https://pypi.org/project/ml-project-setup/
---
### **๐น Whatโs Updated?**
โ
**Includes automatic framework installation (scikit-learn, PyTorch, TensorFlow)**
โ
**Shows example CLI prompt when running `mlsetup`**
โ
**Lists dependencies based on the selected framework**
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ml_project_setup-0.4.tar.gz.
File metadata
- Download URL: ml_project_setup-0.4.tar.gz
- Upload date:
- Size: 5.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7e580db1247f7f7a95d65cf3ef7b1f619243e22bc8bcc23bc0635c75b6020bba
|
|
| MD5 |
14a590ba722e1ecfa37aec2e8b496403
|
|
| BLAKE2b-256 |
24c275ad704ee7712d3b262e55e6ac5fb0ea85966d4584efd013d0e0f15c45dc
|
File details
Details for the file ml_project_setup-0.4-py3-none-any.whl.
File metadata
- Download URL: ml_project_setup-0.4-py3-none-any.whl
- Upload date:
- Size: 5.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9a0895c1b6748b6a3bc40035d5d59906a1bf1590a2f9d10860a09ddce72de99c
|
|
| MD5 |
6e80df066d684cc72c72fbbcbb4b42ce
|
|
| BLAKE2b-256 |
1f277ae6a026450c3ab30cd50b3023748fd045c843f108626e35d255673c2bea
|