Metadata-Version: 2.3
Name: pixano
Version: 0.6.1
Summary: Data-centric AI building blocks for computer vision applications
Project-URL: Documentation, https://github.com/pixano/pixano#readme
Project-URL: Issues, https://github.com/pixano/pixano/issues
Project-URL: Source, https://github.com/pixano/pixano
Author-email: Pixano Developers <pixano@cea.fr>
License: CECILL-C
Keywords: computer vision,data annotation,data visualization,deep learning,machine learning
Classifier: Development Status :: 4 - Beta
Classifier: License :: CeCILL-C Free Software License Agreement (CECILL-C)
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: <3.13,>=3.10
Requires-Dist: duckdb<2.0.0,>=1.0.0
Requires-Dist: fastapi<1.0.0,>=0.103.0
Requires-Dist: httpx<1.0.0,>=0.25.0
Requires-Dist: importlib-resources<6.0.0,>=5.12.0
Requires-Dist: ipywidgets<9.0.0,>=8.0.0
Requires-Dist: jinja2<4.0.0,>=3.1.2
Requires-Dist: lancedb<0.17.0,>=0.10.0
Requires-Dist: numpy<2.0.0,>=1.18.0
Requires-Dist: opencv-python<5.0.0,>=4.7.0
Requires-Dist: pandas<3.0.0,>=1.5.0
Requires-Dist: pillow<11.0.0,>=9.4.0
Requires-Dist: polars<2.0.0,>1.7.0
Requires-Dist: pycocotools<3.0.0,>=2.0.0
Requires-Dist: pydantic-settings<3.0.0,>=2.0.0
Requires-Dist: pydantic<3.0.0,>=2.9.0
Requires-Dist: s3path<1.0.0,>=0.5.0
Requires-Dist: setuptools<76.0.0,>=65.6.0
Requires-Dist: shortuuid<2.0.0,>=1.0.0
Requires-Dist: tqdm<5.0.0,>=4.64.0
Requires-Dist: uvicorn<1.0.0,>=0.20.0
Provides-Extra: docs
Requires-Dist: mike<3.0.0,>=2.1.0; extra == 'docs'
Requires-Dist: mkdocs-gen-files>=0.5.0; extra == 'docs'
Requires-Dist: mkdocs-literate-nav>=0.6.0; extra == 'docs'
Requires-Dist: mkdocs-material<10.0.0,>=9.5.0; extra == 'docs'
Requires-Dist: mkdocs-redirects>=1.2.1; extra == 'docs'
Requires-Dist: mkdocs<2.0.0,>=1.6.0; extra == 'docs'
Requires-Dist: mkdocstrings-python>=1.7.0; extra == 'docs'
Provides-Extra: test
Requires-Dist: ffmpeg-python<0.3.0,>=0.2.0; extra == 'test'
Requires-Dist: mediapy; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-mock; extra == 'test'
Description-Content-Type: text/markdown

<div align="center">

<img src="https://raw.githubusercontent.com/pixano/pixano/main/docs/assets/pixano_wide.png" alt="Pixano" height="100"/>

<br/>
<br/>

**Data-centric AI building blocks for computer vision applications**

**_Under active development, subject to API change_**

[![GitHub version](https://img.shields.io/github/v/release/pixano/pixano?label=release&logo=github)](https://github.com/pixano/pixano/releases)
[![PyPI version](https://img.shields.io/pypi/v/pixano?color=blue&label=release&logo=pypi&logoColor=white)](https://pypi.org/project/pixano/)
[![Tests](https://img.shields.io/github/actions/workflow/status/pixano/pixano/test_back.yml?branch=develop)](https://github.com/pixano/pixano/actions/workflows/test_back.yml)
[![Coverage](https://codecov.io/github/pixano/pixano/graph/badge.svg?token=4BJY43YQ6L)](https://codecov.io/github/pixano/pixano)
[![Documentation](https://img.shields.io/website?url=https%3A%2F%2Fpixano.github.io%2F&up_message=online&down_message=offline&label=docs)](https://pixano.github.io)
[![Python version](https://img.shields.io/pypi/pyversions/pixano?color=important&logo=python&logoColor=white)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-CeCILL--C-blue.svg)](LICENSE)

</div>

<hr />

Pixano is an open-source tool by CEA List for exploring and annotating your dataset using AI features:

- **Fast dataset navigation** using the the modern storage format _Lance_
- **Multi-view datasets** support for images, and soon for _3D point clouds_ and _videos_
- **Import and export** support for dataset formats like _COCO_
- **Semantic search** using models like _CLIP_
- **Smart segmentation** using models like _SAM_

# Getting started

## Installing Pixano

As Pixano requires specific versions for its dependencies, we recommend creating a new Python virtual environment to install it.

For example, with <a href="https://conda.io/projects/conda/en/latest/user-guide/install/index.html" target="_blank">conda</a>:

```shell
conda create -n pixano_env python=3.10
conda activate pixano_env
```

Then, you can install the Pixano package inside that environment with pip:

```shell
pip install pixano
```

## Using your datasets

Please refer to our Jupyter notebooks for <a href="https://github.com/pixano/pixano/blob/main/notebooks/datasets/import_dataset.ipynb" target="_blank">importing</a> and <a href="https://github.com/pixano/pixano/blob/main/notebooks/datasets/export_dataset.ipynb" target="_blank">exporting</a> your datasets.

## Using the Pixano app

Please refer to this link for using the <a href="https://github.com/pixano/pixano/tree/main/pixano/app/README.md" target="_blank">Pixano app</a>.

# Contributing

Please refer to the [CONTRIBUTING.md](CONTRIBUTING.md) for information on running Pixano locally and guidelines on how to publish your contributions.

# License

Pixano is licensed under the [CeCILL-C license](LICENSE).
