{"id":18774693,"url":"https://github.com/firefly-cpp/niaaml","last_synced_at":"2025-04-06T20:09:50.733Z","repository":{"id":39800416,"uuid":"289322337","full_name":"firefly-cpp/NiaAML","owner":"firefly-cpp","description":"Python automated machine learning framework.","archived":false,"fork":false,"pushed_at":"2025-01-23T08:39:11.000Z","size":1132,"stargazers_count":33,"open_issues_count":3,"forks_count":12,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-30T19:11:22.333Z","etag":null,"topics":["automl","classification","classification-pipelines","framework","machine-learning","nature-inspired-algorithms","python"],"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/firefly-cpp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-21T17:03:06.000Z","updated_at":"2025-02-19T15:16:34.000Z","dependencies_parsed_at":"2023-12-15T22:00:15.304Z","dependency_job_id":"900aa99b-d81c-4cde-bc96-6fc177d23746","html_url":"https://github.com/firefly-cpp/NiaAML","commit_stats":{"total_commits":279,"total_committers":10,"mean_commits":27.9,"dds":0.3261648745519713,"last_synced_commit":"711ef064b932615600880293add8a80e39d6f1cf"},"previous_names":["firefly-cpp/niaaml","lukapecnik/niaaml"],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firefly-cpp%2FNiaAML","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firefly-cpp%2FNiaAML/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firefly-cpp%2FNiaAML/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firefly-cpp%2FNiaAML/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firefly-cpp","download_url":"https://codeload.github.com/firefly-cpp/NiaAML/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247543591,"owners_count":20955865,"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":["automl","classification","classification-pipelines","framework","machine-learning","nature-inspired-algorithms","python"],"created_at":"2024-11-07T19:39:06.097Z","updated_at":"2025-04-06T20:09:50.707Z","avatar_url":"https://github.com/firefly-cpp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\".github/images/niaaml_logo.png\" alt=\"NiaAML\" title=\"NiaAML\"/\u003e\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\n    🌳 NiaAML\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"PyPI Version\" src=\"https://img.shields.io/pypi/v/niaaml.svg\" href=\"https://pypi.python.org/pypi/niaaml\"\u003e\n    \u003cimg alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/niaaml.svg\"\u003e\n    \u003cimg alt=\"PyPI - Downloads\" src=\"https://img.shields.io/pypi/dm/niaaml.svg\" href=\"https://pepy.tech/project/niaaml\"\u003e\n    \u003ca href=\"https://repology.org/project/python:niaaml/versions\"\u003e\n        \u003cimg src=\"https://repology.org/badge/tiny-repos/python:niaaml.svg\" alt=\"Packaging status\"\u003e\n    \u003c/a\u003e\n    \u003cimg alt=\"Downloads\" src=\"https://pepy.tech/badge/niaaml\"\u003e\n    \u003cimg alt=\"GitHub license\" src=\"https://img.shields.io/github/license/lukapecnik/niaaml.svg\" href=\"https://github.com/lukapecnik/niaaml/blob/master/LICENSE\"\u003e\n    \u003cimg alt=\"build\" src=\"https://github.com/lukapecnik/niaaml/actions/workflows/test.yml/badge.svg\"\u003e\n    \u003cimg alt=\"Coverage Status\" src=\"https://coveralls.io/repos/github/lukapecnik/NiaAML/badge.svg?branch=master\" href=\"https://coveralls.io/github/lukapecnik/NiaAML?branch=master\"\u003e\n    \u003cimg alt=\"Documentation Status\" src=\"https://readthedocs.org/projects/niaaml/badge/?version=latest\" href=\"https://niaaml.readthedocs.io/en/latest/?badge=latest\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"GitHub commit activity\" src=\"https://img.shields.io/github/commit-activity/w/lukapecnik/niaaml.svg\"\u003e\n    \u003cimg alt=\"Average time to resolve an issue\" src=\"http://isitmaintained.com/badge/resolution/lukapecnik/niaaml.svg\" href=\"http://isitmaintained.com/project/lukapecnik/niaaml\"\u003e\n    \u003cimg alt=\"Percentage of issues still open\" src=\"http://isitmaintained.com/badge/open/lukapecnik/niaaml.svg\" href=\"http://isitmaintained.com/project/lukapecnik/niaaml\"\u003e\n    \u003cimg alt=\"GitHub contributors\" src=\"https://img.shields.io/github/contributors/lukapecnik/niaaml.svg\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"DOI\" src=\"https://zenodo.org/badge/289322337.svg\" href=\"https://zenodo.org/badge/latestdoi/289322337\"\u003e\n    \u003cimg alt=\"DOI\" src=\"https://joss.theoj.org/papers/10.21105/joss.02949/status.svg\" href=\"https://doi.org/10.21105/joss.02949\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-installation\"\u003e📦 Installation\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-graphical-user-interface\"\u003e💻 Graphical User Interface\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-command-line-interface\"\u003e🧑‍💻 Command Line Interface\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-api\"\u003e📮 API\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-implemented-components\"\u003e✨ Implemented Components\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-optimization-process-and-parameter-tuning\"\u003e💪 Optimization Process And Parameter Tuning\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-examples\"\u003e📓 Examples\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-contributors\"\u003e🫂 Contributors\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-support\"\u003e🙏 Support\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-license\"\u003e🔑 License\u003c/a\u003e •\n  \u003ca href=\"https://github.com/firefly-cpp/NiaAML?tab=readme-ov-file#-cite-us\"\u003e📄 Cite Us\u003c/a\u003e\n\u003c/p\u003e\n\nNiaAML is a framework for Automated Machine Learning based on nature-inspired algorithms for optimization. The framework is written fully in Python. The name NiaAML comes from the Automated Machine Learning method of the same name [[1]](#1). Its goal is to compose the best possible classification pipeline for the given task efficiently using components on the input. The components are divided into three groups: feature selection algorithms, feature transformation algorithms and classifiers. The framework uses nature-inspired algorithms for optimization to choose the best set of components for the classification pipeline, and optimize their hyperparameters. We use the \u003ca href=\"https://github.com/NiaOrg/NiaPy\"\u003eNiaPy framework\u003c/a\u003e for the optimization process, which is a popular Python collection of nature-inspired algorithms. The NiaAML framework is easy to use and customize or expand to suit your needs.\n\n\u003e 🆕📈 NiaAML now also support regression tasks. The package still refers to regressors as \"classifiers\" to avoid introducing a breaking change to the API.\n\nThe NiaAML framework allows you not only to run full pipeline optimization, but also to separate implemented components such as classifiers, feature selection algorithms, etc. **It supports numerical and categorical features as well as missing values in datasets.**\n\n* **Free software:** MIT license,\n* **Documentation:** https://niaaml.readthedocs.io/en/latest/,\n* **Python versions:** 3.9 | 3.10 | 3.11\n* **Dependencies:** [click](CONTRIBUTING.md#development-dependencies),\n* **Tested OS:** Windows, Ubuntu, Fedora, Linux Mint and CentOS. **However, that does not mean it does not work on others.**\n\n![NiaAML Architecture](.github/images/niaaml.png)\n\n---\n\n## 📦 Installation\n\n### pip3\n\nInstall NiaAML with pip3:\n\n```sh\npip3 install niaaml\n```\n\nIn case you would like to try out the latest pre-release version of the framework, install it using:\n\n```sh\npip3 install niaaml --pre\n```\n\n### Fedora Linux\n\nTo install NiaAML on Fedora, use:\n\n```sh\n$ dnf install python-niaaml\n```\n\n### Alpine Linux\n\nTo install NiaAML on Alpine Linux, please enable Community repository and use:\n\n```sh\n$ apk add py3-niaaml\n```\n\n### Arch Linux\n\nTo install NiaAML on Arch Linux, use:\n\n```sh\n$ yay -Syyu python-niaaml\n```\n\n### Nix\n\nTo install NiaAML with the [Nix package manager](https://search.nixos.org/packages?channel=23.11\u0026show=python311Packages.niaaml), use:\n\n```sh\n$ nix-env -i python311Packages.niaaml\n```\n\nTo enter a shell with the package already installed, use:\n\n```sh\n$ nix-shell -p python311Packages.niaaml\n```\n\n## 💻 Graphical User Interface\n\nThere is a simple Graphical User Interface for the NiaAML package available [here](https://github.com/lukapecnik/NiaAML-GUI).\n\n## 🧑‍💻 Command Line Interface\n\nWe also provide a CLI for quick pipeline optimizations and inference from the terminal without the need to write custom scripts.\n\nWhen you install the package as instructed above, you will already have access to the `niaaml` command with sub-commands `optimize` and `infer`\n\nFor usage information, add the `--help` flag:\n\n![niaaml help](.github/images/niaaml_cli_help.png)\n\n![niaaml infer help](.github/images/niaaml_cli_infer_help.png)\n\nAn example Invocation of `optimize`:\n\n![niaaml optimize example](.github/images/niaaml_cli_optimize_example.png)\n\n## 📮 API\n\nThere is a simple API for remote work with NiaAML package available [here](https://github.com/alenrajsp/NiaAML-API).\n\n## ✨ Implemented Components\n\n[Click here](COMPONENTS.md) for a list of currently implemented components divided into groups: classifiers, feature selection algorithms and feature transformation algorithms. At the end you can also see a list of currently implemented fitness functions for the optimization process, categorical features' encoders, and missing values' imputers. All of the components are passed into the optimization process using their class names. Let's say we want to choose between Adaptive Boosting, Bagging and Multi Layer Perceptron classifiers, Select K Best and Select Percentile feature selection algorithms and Normalizer as the feature transformation algorithm (may not be selected during the optimization process).\n\n```python\nPipelineOptimizer(\n    data=...,\n    classifiers=['AdaBoost', 'Bagging', 'MultiLayerPerceptron'],\n    feature_selection_algorithms=['SelectKBest', 'SelectPercentile'],\n    feature_transform_algorithms=['Normalizer']\n)\n```\n\nThe argument of the PipelineOptimizer `categorical_features_encoder` is `None` by default. If your dataset contains any categorical features, you need to specify an encoder to use. The same goes for `imputer` and features that contain missing values.\n\n```python\nPipelineOptimizer(\n    data=...,\n    classifiers=['AdaBoost', 'Bagging', 'MultiLayerPerceptron'],\n    feature_selection_algorithms=['SelectKBest', 'SelectPercentile'],\n    feature_transform_algorithms=['Normalizer'],\n    categorical_features_encoder='OneHotEncoder',\n    imputer='SimpleImputer'\n)\n```\n\nFor a full example see the [📓 Examples section](https://github.com/firefly-cpp/NiaAML/blob/master/README.md#-examples).\n\n## 💪 Optimization Process And Parameter Tuning\n\nIn the modifier version of NiaAML optimization process there are two types of optimization. The goal of the first type is to find an optimal set of components (feature selection algorithm, feature transformation algorithm and classifier). The next step is to find optimal parameters for the selected set of components, and that is the goal of the second type of optimization. Each component has an attribute `_params`, which is a dictionary of parameters and their possible values.\n\n```python\nself._params = dict(\n    n_estimators = ParameterDefinition(MinMax(min=10, max=111), np.uint),\n    algorithm = ParameterDefinition(['SAMME', 'SAMME.R'])\n)\n```\n\nAn individual in the first type of optimization is represented as a real-valued vector that has a size equal to the sum of the number of keys in all three dictionaries (classifier's `_params`, Feature Transformation algorithm's `_params` and feature selection algorithm's `_params`) and the value of each dimension is in the range [0.0, 1.0]. The second type of optimization maps real values from the individual's vector to those parameter definitions in the dictionaries. Each parameter's value can be defined as a range or array of values. In the first case, a value from a vector is mapped from one iterval to another, and in the second case, a value from the vector falls into one of the bins that represent an index of the array that holds possible parameters` values.\n\nLet's say we have a classifier with 3 parameters, a feature selection algorithm with 2 parameters and feature transformation algorithm with 4 parameters. The size of an individual in the second type of optimization is 9. The size of an individual in the first type of optimization is always 3 (1 classifier, 1 feature selection algorithm and 1 feature transformation algorithm).\n\nIn some cases we may want to tune a parameter that needs additional information for setting its range of values, so we cannot set the range in the initialization method. In that case, we should set its value in the dictionary to None and define it later in the process. The parameter will be a part of the parameter tuning process as soon as we define its possible values. For example, see [Select K Best Feature Selection](niaaml/preprocessing/feature_selection/select_k_best.py) and its parameter `k`.\n\n**The NiaAML framwork also supports running optimization according to the original method proposed in [[1]](#1) where the components selection and hyperparameter optimization steps are combined into one.**\n\n## 📓 Examples\n\n### Example of Usage\n\nLoad data and try to find the optimal pipeline for the given components. The example below uses the Particle Swarm Algorithm as the optimization algorithm. You can find a list of all available algorithms in the \u003ca href=\"https://github.com/NiaOrg/NiaPy\"\u003eNiaPy's repository\u003c/a\u003e.\n\n```python\nfrom niaaml import PipelineOptimizer, Pipeline\nfrom niaaml.data import BasicDataReader\nimport numpy\nimport pandas\n\n# dummy random data\ndata_reader = BasicDataReader(\n    x=numpy.random.uniform(low=0.0, high=15.0, size=(50, 3)),\n    y=numpy.random.choice(['Class 1', 'Class 2'], size=50)\n)\n\npipeline_optimizer = PipelineOptimizer(\n    data=data_reader,\n    classifiers=['AdaBoost', 'Bagging', 'MultiLayerPerceptron', 'RandomForest', 'ExtremelyRandomizedTrees', 'LinearSVC'],\n    feature_selection_algorithms=['SelectKBest', 'SelectPercentile', 'ParticleSwarmOptimization', 'VarianceThreshold'],\n    feature_transform_algorithms=['Normalizer', 'StandardScaler']\n)\n\n# run the modified version of optimization\npipeline1 = pipeline_optimizer.run('Accuracy', 15, 15, 300, 300, 'ParticleSwarmAlgorithm', 'ParticleSwarmAlgorithm')\n\n# run the original version\npipeline2 = pipeline_optimizer.run_v1('Accuracy', 15, 400, 'ParticleSwarmAlgorithm')\n```\n\nYou can save a result of the optimization process as an object to a file for later use.\n\n```python\npipeline1.export('pipeline.ppln')\n```\n\nAnd also load it from a file and use the pipeline.\n\n```python\nloaded_pipeline = Pipeline.load('pipeline.ppln')\n\n# some features (can be loaded using DataReader object instances)\nx = pandas.DataFrame([[0.35, 0.46, 5.32], [0.16, 0.55, 12.5]])\ny = loaded_pipeline.run(x)\n```\n\nYou can also save a user-friendly representation of a pipeline to a text file.\n\n```python\npipeline1.export_text('pipeline.txt')\n```\n\nThis is a very simple example with dummy data. It is only intended to give you a basic idea of how to use the framework.\n\n### 📈 Example of a Regression Task\n\nThe API for solving regression tasks is not different to the classification use-case. One only has to choose the right components that support regression:\n\nCurrently, the following components support regression tasks:\n\n➡️ **Feature Transform Algorithms**:\n\n+ \"Normalizer\"\n+ \"StandardScaler\"\n+ \"MaxAbsScaler\"\n+ \"QuantileTransformer\"\n+ \"RobustScaler\"\n\n🔎 **Feature Selection Algorithms**:\n\n+ \"SelectKBest\"\n+ \"SelectPercentile\"\n+ \"SelectUnivariateRegression\"\n\n🔮 **Models (Classifiers)**:\n\n+ \"LinearRegression\"\n+ \"RidgeRegression\"\n+ \"LassoRegression\"\n+ \"DecisionTreeRegression\"\n+ \"GaussianProcessRegression\"\n\n```python\npipeline_optimizer = PipelineOptimizer(\n    data=data_reader,\n    feature_selection_algorithms=[\"SelectKBest\", \"SelectPercentile\", \"SelectUnivariateRegression\"],\n    feature_transform_algorithms=[\"Normalizer\", \"StandardScaler\"],\n    classifiers=[\"LinearRegression\", \"RidgeRegression\", \"LassoRegression\", \"DecisionTreeRegression\", \"GaussianProcessRegression\"],\n)\n\n# run the modified version of optimization\npipeline1 = pipeline_optimizer.run(\"MSE\", 10, 10, 20, 20, \"ParticleSwarmAlgorithm\")\n```\n\n### Example of a Pipeline Component's Implementation\n\nThe NiaAML framework is easily expandable, as you can implement components by overriding the base classes' methods. To implement a classifier you should inherit from the [Classifier](niaaml/classifiers/classifier.py) class, and you can do the same with [FeatureSelectionAlgorithm](niaaml/preprocessing/feature_selection/feature_selection_algorithm.py) and [FeatureTransformAlgorithm](niaaml/preprocessing/feature_transform/feature_transform_algorithm.py) classes. All of the mentioned classes inherit from the [PipelineComponent](niaaml/pipeline_component.py) class.\n\nTake a look at the [Classifier](niaaml/classifiers/classifier.py) class and the implementation of the [AdaBoost](niaaml/classifiers/ada_boost.py) classifier that inherits from it.\n\n### Example of a Fitness Function's Implementation\n\nThe NiaAML framework also allows you to implement your own fitness function. All you need to do is implement the [FitnessFunction](niaaml/fitness/fitness_function.py) class.\n\nTake a look at the [Accuracy](niaaml/fitness/accuracy.py) implementation.\n\n### Example of a Feature Encoder's Implementation\n\nThe NiaAML framework also allows you to implement your own feature encoder. All you need to do is implement the [FeatureEncoder](niaaml/preprocessing/encoding/feature_encoder.py) class.\n\nTake a look at the [OneHotEncoder](niaaml/preprocessing/encoding/one_hot_encoder.py) implementation.\n\n### Example of an Imputer's Implementation\n\nThe NiaAML framework also allows you to implement your own imputer. All you need to do is implement the [Imputer](niaaml/preprocessing/imputation/imputer.py) class.\n\nTake a look at the [SimpleImputer](niaaml/preprocessing/imputation/simple_imputer.py) implementation.\n\n### More\n\nYou can find more examples [here](examples).\n\n## 🫂 Contributors\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/lukapecnik\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/23029992?s=460\u0026u=d1c802fd8c82af0a020b1e21af80a34d6e28fb10\u0026v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eLuka Pečnik\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/lukapecnik/NiaAML/commits?author=lukapecnik\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/lukapecnik/NiaAML/commits?author=lukapecnik\" title=\"Documentation\"\u003e📖\u003c/a\u003e \u003ca href=\"https://github.com/lukapecnik/NiaAML/pulls?q=is%3Apr+reviewed-by%3Alukapecnik\" title=\"Reviewed Pull Requests\"\u003e👀\u003c/a\u003e \u003ca href=\"https://github.com/lukapecnik/NiaAML/issues?q=author%3Alukapecnik\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"#example-lukapecnik\" title=\"Examples\"\u003e💡\u003c/a\u003e \u003ca href=\"https://github.com/lukapecnik/NiaAML/commits?author=lukapecnik\" title=\"Tests\"\u003e⚠️\u003c/a\u003e \u003ca href=\"#infra-lukapecnik\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/firefly-cpp\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/1633361?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003efirefly-cpp\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/lukapecnik/NiaAML/commits?author=firefly-cpp\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/lukapecnik/NiaAML/issues?q=author%3Afirefly-cpp\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"#mentoring-firefly-cpp\" title=\"Mentoring\"\u003e🧑‍🏫\u003c/a\u003e \u003ca href=\"#research-firefly-cpp\" title=\"Research\"\u003e🔬\u003c/a\u003e \u003ca href=\"#ideas-firefly-cpp\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/sisco0\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/25695302?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003esisco0\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-sisco0\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/zStupan\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/48752988?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003ezStupan\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/lukapecnik/NiaAML/commits?author=zStupan\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/musicinmybrain\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/6898909?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eBen Beasley\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/lukapecnik/NiaAML/commits?author=musicinmybrain\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#infra-musicinmybrain\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/LaurenzBeck\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/16887213?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eLaurenz Farthofer\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/lukapecnik/NiaAML/commits?author=laurenzbeck\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/lukapecnik/NiaAML/commits?author=laurenzbeck\" title=\"Documentation\"\u003e📖\u003c/a\u003e \u003ca href=\"https://github.com/lukapecnik/NiaAML/commits?author=laurenzbeck\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind are welcome!\n\n## 🙇 Contributing\n\nWe encourage you to contribute to NiaAML! Please check out the [Contributing to NiaAML guide](CONTRIBUTING.md) for guidelines about how to proceed.\n\nEveryone interacting in NiaAML's codebases, issue trackers, chat rooms and mailing lists is expected to follow the NiaAML [code of conduct](CODE_OF_CONDUCT.md).\n\n## 🙏 Support\n\n### ❓ Usage Questions\n\nIf you have questions about how to use NiaAML, or have an issue that isn’t related to a bug, you can place a question on [StackOverflow](https://stackoverflow.com/).\n\nYou can also seek support via [email](mailto:lukapecnik96@gmail.com)\n\nNiaAML is a community supported package, nobody is paid to develop package nor to handle NiaAML support.\n\n**All people answering your questions are doing it with their own time, so please be kind and provide as much information as possible.**\n\n## ❗ Issues\n\nBefore creating bug reports, please check existing issues list as you might find out that you don't need to create one. When you are creating a bug report, please include as many details as possible in the [issue template](.github/templates/ISSUE_TEMPLATE.md).\n\n## 🔑 Licence\n\nThis package is distributed under the MIT License. This license can be found online at \u003chttp://www.opensource.org/licenses/MIT\u003e.\n\n## Disclaimer\n\nThis framework is provided as-is, and there are no guarantees that it fits your purposes or that it is bug-free. Use it at your own risk!\n\n## 📝 References\n\n\u003ca id=\"1\"\u003e[1]\u003c/a\u003e Iztok Fister Jr., Milan Zorman, Dušan Fister, Iztok Fister. \u003ca href=\"https://link.springer.com/chapter/10.1007%2F978-981-15-2133-1_13\"\u003eContinuous optimizers for automatic design and evaluation of classification pipelines\u003c/a\u003e. In: Frontier applications of nature inspired computation. Springer tracts in nature-inspired computing, pp.281-301, 2020.\n\n## 📄 Cite us\n\n```bibtex\n@article{Pečnik2021,\n    doi = {10.21105/joss.02949},\n    url = {https://doi.org/10.21105/joss.02949},\n    year = {2021},\n    publisher = {The Open Journal},\n    volume = {6},\n    number = {61},\n    pages = {2949},\n    author = {Luka Pečnik and Iztok Fister},\n    title = {NiaAML: AutoML framework based on stochastic population-based nature-inspired algorithms},\n    journal = {Journal of Open Source Software} \n} \n```\n\nL. Pečnik, I. Fister Jr. \"[NiaAML: AutoML framework based on stochastic population-based nature-inspired algorithms](https://joss.theoj.org/papers/10.21105/joss.02949).\" Journal of Open Source Software 6.61 (2021): 2949.\n\n```bibtex\n@inproceedings{pecnik_niaaml2_2021,\n\taddress = {Cham},\n\ttitle = {{NiaAML2}: {An} {Improved} {AutoML} {Using} {Nature}-{Inspired} {Algorithms}},\n\tisbn = {978-3-030-78811-7},\n\tabstract = {Using machine learning methods in the real-world is far from being easy, especially because of the number of methods on the one hand, and setting the optimal values of their parameters on the other. Therefore, a lot of so-called AutoML methods have emerged nowadays that also enable automatic construction of classification pipelines to users, who are not experts in this domain. In this study, the NiaAML2 method is proposed that is capable of constructing the classification pipelines using nature-inspired algorithms in two phases: pipeline construction, and hyper-parameter optimization. This method improves the original NiaAML capable of this construction in one phase. The algorithm was applied to four UCI ML datasets, while the obtained results encouraged us to continue with the research.},\n\tbooktitle = {Advances in {Swarm} {Intelligence}},\n\tpublisher = {Springer International Publishing},\n\tauthor = {Pečnik, Luka and Fister, Iztok and Fister, Iztok},\n\teditor = {Tan, Ying and Shi, Yuhui},\n\tyear = {2021},\n\tpages = {243--252},\n}\n```\n\nL. Pečnik, Fister, I., Fister, I. Jr. [NiaAML2: An Improved AutoML Using Nature-Inspired Algorithms](https://doi.org/10.1007/978-3-030-78811-7_23). In International Conference on Swarm Intelligence (pp. 243-252). Springer, Cham, 2021.\n\n```bibtex\n@article{fister2025,\n\ttitle = {{NiaAML}: {AutoML} for classification and regression pipelines},\n\tvolume = {29},\n\trights = {All rights reserved},\n\tissn = {2352-7110},\n\turl = {https://www.sciencedirect.com/science/article/pii/S2352711024003443},\n\tdoi = {10.1016/j.softx.2024.101974},\n\tshorttitle = {{NiaAML}},\n\tabstract = {In this paper we present {NiaAML}, an {AutoML} framework that we have developed for creating machine learning pipelines and hyperparameter tuning. The composition of machine learning pipelines is presented as an optimization problem that can be solved using various stochastic, population-based, nature-inspired algorithms. Nature-inspired algorithms are powerful tools for solving real-world optimization problems, especially those that are highly complex, nonlinear, and involve large search spaces where traditional algorithms may struggle. They are applied widely in various fields, including robotics, operations research, and bioinformatics. This paper provides a comprehensive overview of the software architecture, and describes the main tasks of {NiaAML}, including the automatic composition of classification and regression pipelines. The overview is supported by an practical illustrative example.},\n\tpages = {101974},\n\tjournaltitle = {{SoftwareX}},\n\tauthor = {Fister, Iztok and Farthofer, Laurenz A. and Pečnik, Luka and Fister, Iztok and Holzinger, Andreas},\n\tdate = {2025-02-01},\n\tkeywords = {{AutoML}, Classification, Nature-inspired algorithms, Optimization},\n}\n```\nI. Fister, L. A. Farthofer, L. Pečnik, I. Fister, and A. Holzinger, “NiaAML: AutoML for classification and regression pipelines,” SoftwareX, vol. 29, p. 101974, Feb. 2025, doi: 10.1016/j.softx.2024.101974.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirefly-cpp%2Fniaaml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirefly-cpp%2Fniaaml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirefly-cpp%2Fniaaml/lists"}