Metadata-Version: 2.4
Name: streamlit-embla-carousel
Version: 0.9.4
Summary: Interactive image gallery component for Streamlit based on Embla Carousel
Author-email: Muwsik <nanoweb.assist@gmail.com>
License: ﻿Copyright © 2026 Muwsik
        
        Permission is granted to use this software for personal,
        educational and research purposes.
        
        Commercial use, redistribution, modification, or creation
        of derivative works is prohibited without prior written
        permission from the copyright holder.
        
        For commercial licensing: muwsik@mail.ru
        
Project-URL: Repository, https://github.com/Muwsik/streamlit-embla-carousel
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: streamlit>=1.55
Provides-Extra: dev
Requires-Dist: wheel; extra == "dev"
Requires-Dist: pytest==7.4.0; extra == "dev"
Requires-Dist: playwright==1.48.0; extra == "dev"
Requires-Dist: requests==2.31.0; extra == "dev"
Requires-Dist: pytest-playwright-snapshot==1.0; extra == "dev"
Requires-Dist: pytest-rerunfailures==12.0; extra == "dev"
Dynamic: license-file

# streamlit-embla-carousel

A lightweight image carousel component for [Streamlit](https://streamlit.io/) based on [Embla Carousel](https://www.embla-carousel.com/).

The component allows you to display images in a horizontal carousel with titles, descriptions, navigation controls, and image selection.

## Features

* Horizontal image carousel
* Multiple images visible at once
* Previous/next navigation
* Navigation dots
* Image selection with a visual indicator
* Titles and descriptions for images
* Markdown support in titles and descriptions
* Responsive layout
* Built with Streamlit Components v2 and Embla Carousel

## Installation

```bash
pip install streamlit-embla-carousel
```

## Image format

Each image is defined by an object containing:

| Field         | Type  | Description                   |
| ------------- | ----- | ----------------------------- |
| `id`          | `str` | Unique image identifier       |
| `title`       | `str` | Image title                   |
| `image`       | `str` | Image source                  |
| `description` | `str` | Optional Markdown description |


## License

Permission is granted to use this software for personal,
educational and research purposes.

Commercial use, redistribution, modification, or creation
of derivative works is prohibited without prior written
permission from the copyright holder.

For commercial licensing: [muwsik@mail.ru](mailto:muwsik@mail.ru)
