GridSearchHelper


NameGridSearchHelper JSON
Version 0.8.0 PyPI version JSON
download
home_pagehttps://github.com/alimovabdulla/GridSearchHelper
SummaryAdvanced hyperparameter tuning using grid search for ML models
upload_time2025-02-01 07:41:14
maintainerNone
docs_urlNone
authorAbdulla Alimov
requires_python>=3.6
licenseMIT
keywords machine-learning grid-search hyperparameter-tuning scikit-learn
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 📊 GridSearchHelper: Advanced Hyperparameter Tuning Library

Welcome to **GridSearchHelper**, a powerful and flexible hyperparameter tuning library designed to make model optimization effortless! 🚀

## ✨ Features

- 🔄 **Automated Hyperparameter Grid Generation** for supported models
- 📈 **Seamless Integration** with Scikit-Learn's GridSearchCV
- ⚡ **Supports Classification & Regression Models**
- 🛠️ **Customizable Parameter Grids**
- 🎯 **Easy-to-Use API**

---

## 📌 Installation

```bash
pip install GridSearchHelper
```

---

## 🚀 Quick Start

### Import and Initialize

```python
from GridSearchHelper import perform_grid_search
from sklearn.linear_model import Ridge
from sklearn.model_selection import train_test_split
from sklearn.preprocessing import StandardScaler
from sklearn.datasets import load_diabetes

# Load dataset
data = load_diabetes()
X, y = data.data, data.target
X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.3, random_state=42)

# Scale features
scaler = StandardScaler()
X_train_scaled = scaler.fit_transform(X_train)
X_test_scaled = scaler.transform(X_test)

# Run Hyperparameter Tuning
best_params, best_score, grid_search = perform_grid_search(
    model_name='Ridge',
    X_train=X_train_scaled,
    y_train=y_train,
    cv_folds=5,
    scoring='neg_mean_squared_error'
)

print(f'Best Parameters: {best_params}')
```

---

## ⚙️ Supported Models

- RandomForestClassifier 🌲
- GradientBoostingClassifier 🔥
- SVC 🛡️
- LogisticRegression 📊
- Ridge 📏
- Many more...

---

## 🔧 Configuration

To add custom hyperparameters, simply pass them as a dictionary:

```python
custom_params = {
    'alpha': [0.01, 0.1, 1, 10],
    'solver': ['auto', 'svd', 'cholesky']
}
perform_grid_search('Ridge', X_train_scaled, y_train, additional_params=custom_params)
```

---

## 📜 License

MIT License © 2025 Abdulla Alimov

---

## 🤝 Contributing

Contributions are welcome! Feel free to submit issues or pull requests.

🌟 **Star this repo if you find it useful!**




            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/alimovabdulla/GridSearchHelper",
    "name": "GridSearchHelper",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": null,
    "keywords": "machine-learning grid-search hyperparameter-tuning scikit-learn",
    "author": "Abdulla Alimov",
    "author_email": "abdullaalimov555@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/71/fb/f091cacd8db7a88781daff23aff1197a32421ba31c9574c20f6b5c78d2c6/GridSearchHelper-0.8.0.tar.gz",
    "platform": null,
    "description": "# \ud83d\udcca GridSearchHelper: Advanced Hyperparameter Tuning Library\n\nWelcome to **GridSearchHelper**, a powerful and flexible hyperparameter tuning library designed to make model optimization effortless! \ud83d\ude80\n\n## \u2728 Features\n\n- \ud83d\udd04 **Automated Hyperparameter Grid Generation** for supported models\n- \ud83d\udcc8 **Seamless Integration** with Scikit-Learn's GridSearchCV\n- \u26a1 **Supports Classification & Regression Models**\n- \ud83d\udee0\ufe0f **Customizable Parameter Grids**\n- \ud83c\udfaf **Easy-to-Use API**\n\n---\n\n## \ud83d\udccc Installation\n\n```bash\npip install GridSearchHelper\n```\n\n---\n\n## \ud83d\ude80 Quick Start\n\n### Import and Initialize\n\n```python\nfrom GridSearchHelper import perform_grid_search\nfrom sklearn.linear_model import Ridge\nfrom sklearn.model_selection import train_test_split\nfrom sklearn.preprocessing import StandardScaler\nfrom sklearn.datasets import load_diabetes\n\n# Load dataset\ndata = load_diabetes()\nX, y = data.data, data.target\nX_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.3, random_state=42)\n\n# Scale features\nscaler = StandardScaler()\nX_train_scaled = scaler.fit_transform(X_train)\nX_test_scaled = scaler.transform(X_test)\n\n# Run Hyperparameter Tuning\nbest_params, best_score, grid_search = perform_grid_search(\n    model_name='Ridge',\n    X_train=X_train_scaled,\n    y_train=y_train,\n    cv_folds=5,\n    scoring='neg_mean_squared_error'\n)\n\nprint(f'Best Parameters: {best_params}')\n```\n\n---\n\n## \u2699\ufe0f Supported Models\n\n- RandomForestClassifier \ud83c\udf32\n- GradientBoostingClassifier \ud83d\udd25\n- SVC \ud83d\udee1\ufe0f\n- LogisticRegression \ud83d\udcca\n- Ridge \ud83d\udccf\n- Many more...\n\n---\n\n## \ud83d\udd27 Configuration\n\nTo add custom hyperparameters, simply pass them as a dictionary:\n\n```python\ncustom_params = {\n    'alpha': [0.01, 0.1, 1, 10],\n    'solver': ['auto', 'svd', 'cholesky']\n}\nperform_grid_search('Ridge', X_train_scaled, y_train, additional_params=custom_params)\n```\n\n---\n\n## \ud83d\udcdc License\n\nMIT License \u00a9 2025 Abdulla Alimov\n\n---\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Feel free to submit issues or pull requests.\n\n\ud83c\udf1f **Star this repo if you find it useful!**\n\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Advanced hyperparameter tuning using grid search for ML models",
    "version": "0.8.0",
    "project_urls": {
        "Bug Tracker": "https://github.com/alimovabdulla/GridSearchHelper/",
        "Documentation": "https://github.com/alimovabdulla/GridSearchHelper/",
        "Homepage": "https://github.com/alimovabdulla/GridSearchHelper"
    },
    "split_keywords": [
        "machine-learning",
        "grid-search",
        "hyperparameter-tuning",
        "scikit-learn"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d6fb15e9755d55fd27c86f48a86574b6e43fb004ba30d3b66a7b82e2ad00b82d",
                "md5": "11d1b8f6d45cf92d2752a8381ddefce5",
                "sha256": "61fa93ed7f8595835f32c11727f6b5e88939e9fec3c66a9aceef0e55fdbe4317"
            },
            "downloads": -1,
            "filename": "GridSearchHelper-0.8.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "11d1b8f6d45cf92d2752a8381ddefce5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 6471,
            "upload_time": "2025-02-01T07:41:12",
            "upload_time_iso_8601": "2025-02-01T07:41:12.842389Z",
            "url": "https://files.pythonhosted.org/packages/d6/fb/15e9755d55fd27c86f48a86574b6e43fb004ba30d3b66a7b82e2ad00b82d/GridSearchHelper-0.8.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "71fbf091cacd8db7a88781daff23aff1197a32421ba31c9574c20f6b5c78d2c6",
                "md5": "97d402b0c6c3d99ad321e6a6eb7bfc65",
                "sha256": "486cfb6578f958a8b4fd25c6f23c0dc7ff6d760874c15483cd5ed52b81964c41"
            },
            "downloads": -1,
            "filename": "GridSearchHelper-0.8.0.tar.gz",
            "has_sig": false,
            "md5_digest": "97d402b0c6c3d99ad321e6a6eb7bfc65",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 6479,
            "upload_time": "2025-02-01T07:41:14",
            "upload_time_iso_8601": "2025-02-01T07:41:14.813664Z",
            "url": "https://files.pythonhosted.org/packages/71/fb/f091cacd8db7a88781daff23aff1197a32421ba31c9574c20f6b5c78d2c6/GridSearchHelper-0.8.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-01 07:41:14",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "alimovabdulla",
    "github_project": "GridSearchHelper",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "gridsearchhelper"
}
        
Elapsed time: 0.38804s