aisee


Nameaisee JSON
Version 0.1.1 PyPI version JSON
download
home_pagehttps://iiconocimiento.github.io/aisee
Summaryaisee is a Python package for image classification using PyTorch and timm created by Instituto de Ingeniería del Conocimiento
upload_time2024-07-30 09:13:18
maintainerNone
docs_urlNone
authorIIC
requires_python<3.12,>=3.9
licenseMIT
keywords aisee computer vision vision timm pytorch
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            [![AISee Logo](./docs/source/_resources/aisee-logo.png)](https://iiconocimiento.github.io/aisee/stable/)

---

[![License: MIT](https://img.shields.io/github/license/iiconocimiento/aisee)](https://github.com/iiconocimiento/aisee/blob/main/LICENSE) ![GitHub Stars](https://img.shields.io/github/stars/iiconocimiento/aisee?style=social) [![Latest Version on Pypi](https://img.shields.io/pypi/v/aisee)](https://pypi.org/project/aisee/) ![Supported Python versions](https://img.shields.io/pypi/pyversions/aisee) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) ![Unit tests](https://github.com/iiconocimiento/aisee/actions/workflows/unit-tests.yml/badge.svg) [![codecov](https://codecov.io/github/iiconocimiento/aisee/branch/main/graph/badge.svg?token=YA7QJ8FOIM)](https://codecov.io/github/iiconocimiento/aisee) [![Docs](https://github.com/iiconocimiento/aisee/actions/workflows/documentation.yml/badge.svg)](https://iiconocimiento.github.io/aisee/stable/)

An open-source library for computer vision built on top of PyTorch and Timm libraries. It provides an easy-to-use interface for training and predicting with State-of-the-Art neural networks.

## AISee key features 

- 🤗 Simple interface for training and predicting using timm library models.
- 📁 Easily load images from a folder, a pandas `DataFrame` or a single image path.
- 🏋🏽‍♂️ Train SOTA neural networks from pre-trained weights or from scratch in very few lines of code.  
- 🖼️ Supports multiclass and multilabel image classification tasks.
- 🔨 We take care of `DataLoaders`, image transformations and training and inference loops.


## Installation

Install AISee using pip.

```bash
pip install aisee
```


## Quick tour

Here's an example of how to quickly train a model using AISee. We just have to initialize a `VisionClassifier` model and create a `Trainer`. As easy as it gets!

```python
from aisee import Trainer, VisionClassifier

# Initialize a VisionClassifier model
model = VisionClassifier(
    model_name="vgg11_bn", 
    num_classes=4,
)

# Create a Trainer 
trainer = Trainer(
    base_model=model, 
    data=f"animals/",
    output_dir="trained_weights.pt",
)

# Train
trainer.train()
```

To predict call `predict` method, we take care of the rest:

```python
# Predict 
trainer.base_model.predict("animals/without_label")
```


## Try it on Google Colab
<a target="_blank" href="https://colab.research.google.com/github/iiconocimiento/aisee/blob/main/notebooks/multi_class_classification.ipynb">
  <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
</a>


## Getting started

- Visit [AISee Getting started](https://iiconocimiento.github.io/aisee/stable/_getting_started/getting_started.html) to get an overview of how AISee works.

- Explore [AISee Documentation](https://iiconocimiento.github.io/aisee/stable/) page for a detailed guide and comprehensive API reference.

- Check out [AISee Examples](https://iiconocimiento.github.io/aisee/stable/_examples/examples.html) for Jupyter Notebook examples and tutorials, showcasing how to use AISee effectively in various scenarios.

## Contributing

We value community contributions, and we encourage you to get involved in the continuous development of AISee. Please refer to [AISee Development](https://iiconocimiento.github.io/aisee/stable/_development/development.html) page for guidelines on how to contribute effectively.

We also appreciate your feedback which helps us develop a robust and efficient solution for computer vision tasks. Together, let's make AISee the go-to library for AI practitioners and enthusiasts alike.

## Contact Us
For any questions or inquiries regarding the AISee library or potential collaborations, please feel free to contact us in marketing@iic.uam.es. 

## Instituto de Ingeniería del Conocimiento (IIC)
[IIC](https://www.iic.uam.es/) is a non-profit R&D centre founded in 1989 that has been working on Big Data analysis and Artificial Intelligence for more than 30 years. Its value proposition is the development of algorithms and analytical solutions based on applied research tailored to different businesses in different sectors such as energy, health, insurance and talent analytics.

---

            

Raw data

            {
    "_id": null,
    "home_page": "https://iiconocimiento.github.io/aisee",
    "name": "aisee",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<3.12,>=3.9",
    "maintainer_email": null,
    "keywords": "aisee, computer vision, vision, timm, pytorch",
    "author": "IIC",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/da/ea/be0000b8f00a8372e7261aa1119180ae9c0f03f77c7bd5c2951d0e6aa996/aisee-0.1.1.tar.gz",
    "platform": null,
    "description": "[![AISee Logo](./docs/source/_resources/aisee-logo.png)](https://iiconocimiento.github.io/aisee/stable/)\n\n---\n\n[![License: MIT](https://img.shields.io/github/license/iiconocimiento/aisee)](https://github.com/iiconocimiento/aisee/blob/main/LICENSE) ![GitHub Stars](https://img.shields.io/github/stars/iiconocimiento/aisee?style=social) [![Latest Version on Pypi](https://img.shields.io/pypi/v/aisee)](https://pypi.org/project/aisee/) ![Supported Python versions](https://img.shields.io/pypi/pyversions/aisee) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) ![Unit tests](https://github.com/iiconocimiento/aisee/actions/workflows/unit-tests.yml/badge.svg) [![codecov](https://codecov.io/github/iiconocimiento/aisee/branch/main/graph/badge.svg?token=YA7QJ8FOIM)](https://codecov.io/github/iiconocimiento/aisee) [![Docs](https://github.com/iiconocimiento/aisee/actions/workflows/documentation.yml/badge.svg)](https://iiconocimiento.github.io/aisee/stable/)\n\nAn open-source library for computer vision built on top of PyTorch and Timm libraries. It provides an easy-to-use interface for training and predicting with State-of-the-Art neural networks.\n\n## AISee key features \n\n- \ud83e\udd17 Simple interface for training and predicting using timm library models.\n- \ud83d\udcc1 Easily load images from a folder, a pandas `DataFrame` or a single image path.\n- \ud83c\udfcb\ud83c\udffd\u200d\u2642\ufe0f Train SOTA neural networks from pre-trained weights or from scratch in very few lines of code.  \n- \ud83d\uddbc\ufe0f Supports multiclass and multilabel image classification tasks.\n- \ud83d\udd28 We take care of `DataLoaders`, image transformations and training and inference loops.\n\n\n## Installation\n\nInstall AISee using pip.\n\n```bash\npip install aisee\n```\n\n\n## Quick tour\n\nHere's an example of how to quickly train a model using AISee. We just have to initialize a `VisionClassifier` model and create a `Trainer`. As easy as it gets!\n\n```python\nfrom aisee import Trainer, VisionClassifier\n\n# Initialize a VisionClassifier model\nmodel = VisionClassifier(\n    model_name=\"vgg11_bn\", \n    num_classes=4,\n)\n\n# Create a Trainer \ntrainer = Trainer(\n    base_model=model, \n    data=f\"animals/\",\n    output_dir=\"trained_weights.pt\",\n)\n\n# Train\ntrainer.train()\n```\n\nTo predict call `predict` method, we take care of the rest:\n\n```python\n# Predict \ntrainer.base_model.predict(\"animals/without_label\")\n```\n\n\n## Try it on Google Colab\n<a target=\"_blank\" href=\"https://colab.research.google.com/github/iiconocimiento/aisee/blob/main/notebooks/multi_class_classification.ipynb\">\n  <img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/>\n</a>\n\n\n## Getting started\n\n- Visit [AISee Getting started](https://iiconocimiento.github.io/aisee/stable/_getting_started/getting_started.html) to get an overview of how AISee works.\n\n- Explore [AISee Documentation](https://iiconocimiento.github.io/aisee/stable/) page for a detailed guide and comprehensive API reference.\n\n- Check out [AISee Examples](https://iiconocimiento.github.io/aisee/stable/_examples/examples.html) for Jupyter Notebook examples and tutorials, showcasing how to use AISee effectively in various scenarios.\n\n## Contributing\n\nWe value community contributions, and we encourage you to get involved in the continuous development of AISee. Please refer to [AISee Development](https://iiconocimiento.github.io/aisee/stable/_development/development.html) page for guidelines on how to contribute effectively.\n\nWe also appreciate your feedback which helps us develop a robust and efficient solution for computer vision tasks. Together, let's make AISee the go-to library for AI practitioners and enthusiasts alike.\n\n## Contact Us\nFor any questions or inquiries regarding the AISee library or potential collaborations, please feel free to contact us in marketing@iic.uam.es. \n\n## Instituto de Ingenier\u00eda del Conocimiento (IIC)\n[IIC](https://www.iic.uam.es/) is a non-profit R&D centre founded in 1989 that has been working on Big Data analysis and Artificial Intelligence for more than 30 years. Its value proposition is the development of algorithms and analytical solutions based on applied research tailored to different businesses in different sectors such as energy, health, insurance and talent analytics.\n\n---\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "aisee is a Python package for image classification using PyTorch and timm created by Instituto de Ingenier\u00eda del Conocimiento",
    "version": "0.1.1",
    "project_urls": {
        "Documentation": "https://iiconocimiento.github.io/aisee",
        "Homepage": "https://iiconocimiento.github.io/aisee",
        "Repository": "https://github.com/iiconocimiento/aisee"
    },
    "split_keywords": [
        "aisee",
        " computer vision",
        " vision",
        " timm",
        " pytorch"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a71cb21a2a804f9af2dc2f4e5be52f1741f5ab05e3421d54a26a0ca41ea8710a",
                "md5": "9e25f9f2f4c92892fd01214fa55860a3",
                "sha256": "386f4a58b2178d985027ce1fc38ad427bccaceb64f551620f839c2564587b441"
            },
            "downloads": -1,
            "filename": "aisee-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9e25f9f2f4c92892fd01214fa55860a3",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.12,>=3.9",
            "size": 18330,
            "upload_time": "2024-07-30T09:13:17",
            "upload_time_iso_8601": "2024-07-30T09:13:17.538372Z",
            "url": "https://files.pythonhosted.org/packages/a7/1c/b21a2a804f9af2dc2f4e5be52f1741f5ab05e3421d54a26a0ca41ea8710a/aisee-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "daeabe0000b8f00a8372e7261aa1119180ae9c0f03f77c7bd5c2951d0e6aa996",
                "md5": "f5a8e363ef34bdf5425f2a8b5a93b580",
                "sha256": "78137550d5615580ea534a95ba6472115de8e98483282b4a92b0a54e069c5f3a"
            },
            "downloads": -1,
            "filename": "aisee-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "f5a8e363ef34bdf5425f2a8b5a93b580",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.12,>=3.9",
            "size": 18444,
            "upload_time": "2024-07-30T09:13:18",
            "upload_time_iso_8601": "2024-07-30T09:13:18.888228Z",
            "url": "https://files.pythonhosted.org/packages/da/ea/be0000b8f00a8372e7261aa1119180ae9c0f03f77c7bd5c2951d0e6aa996/aisee-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-30 09:13:18",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "iiconocimiento",
    "github_project": "aisee",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "aisee"
}
        
IIC
Elapsed time: 0.37723s