mlnew 1.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. mlnew-1.1.0/LICENSE +21 -0
  2. mlnew-1.1.0/PKG-INFO +147 -0
  3. mlnew-1.1.0/README.md +131 -0
  4. mlnew-1.1.0/mlnew.egg-info/PKG-INFO +147 -0
  5. mlnew-1.1.0/mlnew.egg-info/SOURCES.txt +8 -0
  6. mlnew-1.1.0/mlnew.egg-info/dependency_links.txt +1 -0
  7. mlnew-1.1.0/mlnew.egg-info/entry_points.txt +2 -0
  8. mlnew-1.1.0/mlnew.egg-info/top_level.txt +1 -0
  9. mlnew-1.1.0/pyproject.toml +26 -0
  10. mlnew-1.1.0/setup.cfg +4 -0
mlnew-1.1.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Alex
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
mlnew-1.1.0/PKG-INFO ADDED
@@ -0,0 +1,147 @@
1
+ Metadata-Version: 2.4
2
+ Name: mlnew
3
+ Version: 1.1.0
4
+ Summary: One command ML project scaffolding CLI — works on Windows, Mac, and Linux.
5
+ License: MIT
6
+ Keywords: machine-learning,cli,scaffold,data-science,project-template
7
+ Classifier: Programming Language :: Python :: 3
8
+ Classifier: License :: OSI Approved :: MIT License
9
+ Classifier: Operating System :: OS Independent
10
+ Classifier: Environment :: Console
11
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
12
+ Requires-Python: >=3.8
13
+ Description-Content-Type: text/markdown
14
+ License-File: LICENSE
15
+ Dynamic: license-file
16
+
17
+ # mlnew
18
+
19
+ One command ML project scaffolding CLI. Works on Windows, Mac, and Linux.
20
+
21
+ ## Install
22
+
23
+ ```bash
24
+ pip install mlnew
25
+ ```
26
+
27
+ ## Usage
28
+
29
+ ```bash
30
+ mlnew init project_name
31
+ ```
32
+
33
+ That single command will:
34
+
35
+ - Create the project folder
36
+ - Create all directories — `data`, `src`, `notebooks`, `configs`, `logs`, `tests`
37
+ - Create all required files — `.gitignore`, `.env`, `config.yaml`, `train.py`, `eda.ipynb`
38
+ - Generate `SETUP_GUIDE.md` — full manual reference inside every project
39
+ - Create and configure a virtual environment inside `.venv`
40
+ - Upgrade `pip`, `setuptools`, `wheel`
41
+ - Install common ML dependencies with pinned versions
42
+ - Save `requirements.txt`
43
+ - Generate a `README.md`
44
+ - Initialize a Git repository with an initial commit
45
+
46
+ ## Version Control
47
+
48
+ By default mlnew installs pinned, stable versions of every package. You can override any of them with `--pkg`.
49
+
50
+ ```bash
51
+ # Use all defaults
52
+ mlnew init my_project
53
+
54
+ # Pin specific versions
55
+ mlnew init my_project --pkg numpy==1.24.0 --pkg pandas==2.0.0
56
+
57
+ # Install latest (no pin)
58
+ mlnew init my_project --pkg numpy==latest
59
+
60
+ # Add a package not in the defaults
61
+ mlnew init my_project --pkg torch --pkg transformers
62
+
63
+ # Mix and match
64
+ mlnew init my_project --pkg numpy==1.24.0 --pkg torch --pkg transformers==4.40.0
65
+ ```
66
+
67
+ ## Default Packages
68
+
69
+ | Package | Default Version |
70
+ |---|---|
71
+ | numpy | 1.26.4 |
72
+ | pandas | 2.2.2 |
73
+ | scikit-learn | 1.4.2 |
74
+ | matplotlib | 3.9.0 |
75
+ | seaborn | 0.13.2 |
76
+ | jupyter | 1.0.0 |
77
+ | mlflow | 2.13.0 |
78
+ | fastapi | 0.111.0 |
79
+ | uvicorn | 0.30.1 |
80
+ | python-dotenv | 1.0.1 |
81
+
82
+ See all defaults anytime:
83
+
84
+ ```bash
85
+ mlnew packages
86
+ ```
87
+
88
+ ## Project Structure Created
89
+
90
+ ```
91
+ project_name/
92
+ ├── .venv/ Virtual environment (auto-generated, never touch)
93
+ ├── data/
94
+ │ ├── raw/ Original, untouched data.
95
+ │ └── processed/ Cleaned and transformed data.
96
+ ├── notebooks/
97
+ │ └── eda.ipynb Exploration and visualization only.
98
+ ├── src/
99
+ │ ├── features/ Feature engineering logic.
100
+ │ ├── models/ Model definition.
101
+ │ ├── training/
102
+ │ │ └── train.py Main training entry point.
103
+ │ └── inference/ Prediction and serving logic.
104
+ ├── configs/
105
+ │ └── config.yaml All settings and hyperparameters.
106
+ ├── logs/ Training logs.
107
+ ├── tests/ Unit and integration tests.
108
+ ├── .env Secret keys. Never commit.
109
+ ├── .gitignore
110
+ ├── requirements.txt
111
+ ├── SETUP_GUIDE.md Full manual setup reference.
112
+ └── README.md
113
+ ```
114
+
115
+ ## After Setup
116
+
117
+ ```bash
118
+ cd project_name
119
+
120
+ # Mac / Linux
121
+ source .venv/bin/activate
122
+
123
+ # Windows (PowerShell)
124
+ .venv\Scripts\Activate.ps1
125
+
126
+ # Run training
127
+ python src/training/train.py
128
+ ```
129
+
130
+ ## All Commands
131
+
132
+ ```bash
133
+ mlnew init <project_name> Create project with default packages
134
+ mlnew init <project_name> --pkg <spec> Override specific package versions
135
+ mlnew packages List all default packages and versions
136
+ mlnew --version Show version
137
+ mlnew --help Show help
138
+ ```
139
+
140
+ ## Requirements
141
+
142
+ - Python 3.8 or higher
143
+ - Git (optional, for auto git init)
144
+
145
+ ## License
146
+
147
+ MIT
mlnew-1.1.0/README.md ADDED
@@ -0,0 +1,131 @@
1
+ # mlnew
2
+
3
+ One command ML project scaffolding CLI. Works on Windows, Mac, and Linux.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ pip install mlnew
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```bash
14
+ mlnew init project_name
15
+ ```
16
+
17
+ That single command will:
18
+
19
+ - Create the project folder
20
+ - Create all directories — `data`, `src`, `notebooks`, `configs`, `logs`, `tests`
21
+ - Create all required files — `.gitignore`, `.env`, `config.yaml`, `train.py`, `eda.ipynb`
22
+ - Generate `SETUP_GUIDE.md` — full manual reference inside every project
23
+ - Create and configure a virtual environment inside `.venv`
24
+ - Upgrade `pip`, `setuptools`, `wheel`
25
+ - Install common ML dependencies with pinned versions
26
+ - Save `requirements.txt`
27
+ - Generate a `README.md`
28
+ - Initialize a Git repository with an initial commit
29
+
30
+ ## Version Control
31
+
32
+ By default mlnew installs pinned, stable versions of every package. You can override any of them with `--pkg`.
33
+
34
+ ```bash
35
+ # Use all defaults
36
+ mlnew init my_project
37
+
38
+ # Pin specific versions
39
+ mlnew init my_project --pkg numpy==1.24.0 --pkg pandas==2.0.0
40
+
41
+ # Install latest (no pin)
42
+ mlnew init my_project --pkg numpy==latest
43
+
44
+ # Add a package not in the defaults
45
+ mlnew init my_project --pkg torch --pkg transformers
46
+
47
+ # Mix and match
48
+ mlnew init my_project --pkg numpy==1.24.0 --pkg torch --pkg transformers==4.40.0
49
+ ```
50
+
51
+ ## Default Packages
52
+
53
+ | Package | Default Version |
54
+ |---|---|
55
+ | numpy | 1.26.4 |
56
+ | pandas | 2.2.2 |
57
+ | scikit-learn | 1.4.2 |
58
+ | matplotlib | 3.9.0 |
59
+ | seaborn | 0.13.2 |
60
+ | jupyter | 1.0.0 |
61
+ | mlflow | 2.13.0 |
62
+ | fastapi | 0.111.0 |
63
+ | uvicorn | 0.30.1 |
64
+ | python-dotenv | 1.0.1 |
65
+
66
+ See all defaults anytime:
67
+
68
+ ```bash
69
+ mlnew packages
70
+ ```
71
+
72
+ ## Project Structure Created
73
+
74
+ ```
75
+ project_name/
76
+ ├── .venv/ Virtual environment (auto-generated, never touch)
77
+ ├── data/
78
+ │ ├── raw/ Original, untouched data.
79
+ │ └── processed/ Cleaned and transformed data.
80
+ ├── notebooks/
81
+ │ └── eda.ipynb Exploration and visualization only.
82
+ ├── src/
83
+ │ ├── features/ Feature engineering logic.
84
+ │ ├── models/ Model definition.
85
+ │ ├── training/
86
+ │ │ └── train.py Main training entry point.
87
+ │ └── inference/ Prediction and serving logic.
88
+ ├── configs/
89
+ │ └── config.yaml All settings and hyperparameters.
90
+ ├── logs/ Training logs.
91
+ ├── tests/ Unit and integration tests.
92
+ ├── .env Secret keys. Never commit.
93
+ ├── .gitignore
94
+ ├── requirements.txt
95
+ ├── SETUP_GUIDE.md Full manual setup reference.
96
+ └── README.md
97
+ ```
98
+
99
+ ## After Setup
100
+
101
+ ```bash
102
+ cd project_name
103
+
104
+ # Mac / Linux
105
+ source .venv/bin/activate
106
+
107
+ # Windows (PowerShell)
108
+ .venv\Scripts\Activate.ps1
109
+
110
+ # Run training
111
+ python src/training/train.py
112
+ ```
113
+
114
+ ## All Commands
115
+
116
+ ```bash
117
+ mlnew init <project_name> Create project with default packages
118
+ mlnew init <project_name> --pkg <spec> Override specific package versions
119
+ mlnew packages List all default packages and versions
120
+ mlnew --version Show version
121
+ mlnew --help Show help
122
+ ```
123
+
124
+ ## Requirements
125
+
126
+ - Python 3.8 or higher
127
+ - Git (optional, for auto git init)
128
+
129
+ ## License
130
+
131
+ MIT
mlnew-1.1.0/mlnew.egg-info/PKG-INFO ADDED
@@ -0,0 +1,147 @@
1
+ Metadata-Version: 2.4
2
+ Name: mlnew
3
+ Version: 1.1.0
4
+ Summary: One command ML project scaffolding CLI — works on Windows, Mac, and Linux.
5
+ License: MIT
6
+ Keywords: machine-learning,cli,scaffold,data-science,project-template
7
+ Classifier: Programming Language :: Python :: 3
8
+ Classifier: License :: OSI Approved :: MIT License
9
+ Classifier: Operating System :: OS Independent
10
+ Classifier: Environment :: Console
11
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
12
+ Requires-Python: >=3.8
13
+ Description-Content-Type: text/markdown
14
+ License-File: LICENSE
15
+ Dynamic: license-file
16
+
17
+ # mlnew
18
+
19
+ One command ML project scaffolding CLI. Works on Windows, Mac, and Linux.
20
+
21
+ ## Install
22
+
23
+ ```bash
24
+ pip install mlnew
25
+ ```
26
+
27
+ ## Usage
28
+
29
+ ```bash
30
+ mlnew init project_name
31
+ ```
32
+
33
+ That single command will:
34
+
35
+ - Create the project folder
36
+ - Create all directories — `data`, `src`, `notebooks`, `configs`, `logs`, `tests`
37
+ - Create all required files — `.gitignore`, `.env`, `config.yaml`, `train.py`, `eda.ipynb`
38
+ - Generate `SETUP_GUIDE.md` — full manual reference inside every project
39
+ - Create and configure a virtual environment inside `.venv`
40
+ - Upgrade `pip`, `setuptools`, `wheel`
41
+ - Install common ML dependencies with pinned versions
42
+ - Save `requirements.txt`
43
+ - Generate a `README.md`
44
+ - Initialize a Git repository with an initial commit
45
+
46
+ ## Version Control
47
+
48
+ By default mlnew installs pinned, stable versions of every package. You can override any of them with `--pkg`.
49
+
50
+ ```bash
51
+ # Use all defaults
52
+ mlnew init my_project
53
+
54
+ # Pin specific versions
55
+ mlnew init my_project --pkg numpy==1.24.0 --pkg pandas==2.0.0
56
+
57
+ # Install latest (no pin)
58
+ mlnew init my_project --pkg numpy==latest
59
+
60
+ # Add a package not in the defaults
61
+ mlnew init my_project --pkg torch --pkg transformers
62
+
63
+ # Mix and match
64
+ mlnew init my_project --pkg numpy==1.24.0 --pkg torch --pkg transformers==4.40.0
65
+ ```
66
+
67
+ ## Default Packages
68
+
69
+ | Package | Default Version |
70
+ |---|---|
71
+ | numpy | 1.26.4 |
72
+ | pandas | 2.2.2 |
73
+ | scikit-learn | 1.4.2 |
74
+ | matplotlib | 3.9.0 |
75
+ | seaborn | 0.13.2 |
76
+ | jupyter | 1.0.0 |
77
+ | mlflow | 2.13.0 |
78
+ | fastapi | 0.111.0 |
79
+ | uvicorn | 0.30.1 |
80
+ | python-dotenv | 1.0.1 |
81
+
82
+ See all defaults anytime:
83
+
84
+ ```bash
85
+ mlnew packages
86
+ ```
87
+
88
+ ## Project Structure Created
89
+
90
+ ```
91
+ project_name/
92
+ ├── .venv/ Virtual environment (auto-generated, never touch)
93
+ ├── data/
94
+ │ ├── raw/ Original, untouched data.
95
+ │ └── processed/ Cleaned and transformed data.
96
+ ├── notebooks/
97
+ │ └── eda.ipynb Exploration and visualization only.
98
+ ├── src/
99
+ │ ├── features/ Feature engineering logic.
100
+ │ ├── models/ Model definition.
101
+ │ ├── training/
102
+ │ │ └── train.py Main training entry point.
103
+ │ └── inference/ Prediction and serving logic.
104
+ ├── configs/
105
+ │ └── config.yaml All settings and hyperparameters.
106
+ ├── logs/ Training logs.
107
+ ├── tests/ Unit and integration tests.
108
+ ├── .env Secret keys. Never commit.
109
+ ├── .gitignore
110
+ ├── requirements.txt
111
+ ├── SETUP_GUIDE.md Full manual setup reference.
112
+ └── README.md
113
+ ```
114
+
115
+ ## After Setup
116
+
117
+ ```bash
118
+ cd project_name
119
+
120
+ # Mac / Linux
121
+ source .venv/bin/activate
122
+
123
+ # Windows (PowerShell)
124
+ .venv\Scripts\Activate.ps1
125
+
126
+ # Run training
127
+ python src/training/train.py
128
+ ```
129
+
130
+ ## All Commands
131
+
132
+ ```bash
133
+ mlnew init <project_name> Create project with default packages
134
+ mlnew init <project_name> --pkg <spec> Override specific package versions
135
+ mlnew packages List all default packages and versions
136
+ mlnew --version Show version
137
+ mlnew --help Show help
138
+ ```
139
+
140
+ ## Requirements
141
+
142
+ - Python 3.8 or higher
143
+ - Git (optional, for auto git init)
144
+
145
+ ## License
146
+
147
+ MIT
mlnew-1.1.0/mlnew.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,8 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ mlnew.egg-info/PKG-INFO
5
+ mlnew.egg-info/SOURCES.txt
6
+ mlnew.egg-info/dependency_links.txt
7
+ mlnew.egg-info/entry_points.txt
8
+ mlnew.egg-info/top_level.txt
mlnew-1.1.0/mlnew.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ mlnew = mlnew.main:main
mlnew-1.1.0/mlnew.egg-info/top_level.txt ADDED
@@ -0,0 +1 @@
1
+
mlnew-1.1.0/pyproject.toml ADDED
@@ -0,0 +1,26 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "mlnew"
7
+ version = "1.1.0"
8
+ description = "One command ML project scaffolding CLI — works on Windows, Mac, and Linux."
9
+ readme = "README.md"
10
+ requires-python = ">=3.8"
11
+ license = { text = "MIT" }
12
+ keywords = ["machine-learning", "cli", "scaffold", "data-science", "project-template"]
13
+ classifiers = [
14
+ "Programming Language :: Python :: 3",
15
+ "License :: OSI Approved :: MIT License",
16
+ "Operating System :: OS Independent",
17
+ "Environment :: Console",
18
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
19
+ ]
20
+
21
+ [project.scripts]
22
+ mlnew = "mlnew.main:main"
23
+
24
+ [tool.setuptools.packages.find]
25
+ where = ["."]
26
+ include = ["mlsetup*"]
mlnew-1.1.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+