Metadata-Version: 2.4
Name: smoosense
Version: 0.1.43
Summary: Smoothly make sense of your large multi-modal datasets
Author-email: SmooSense AI <contact@smoosense.ai>
License: Apache-2.0
Project-URL: Homepage, https://smoosense.ai
Project-URL: Documentation, https://smoosense.ai/docs/
Project-URL: Repository, https://github.com/SmooSenseAI/smoosense
Project-URL: Source Code, https://github.com/SmooSenseAI/smoosense
Project-URL: Bug Tracker, https://github.com/SmooSenseAI/smoosense/issues
Project-URL: Changelog, https://github.com/SmooSenseAI/smoosense/releases
Keywords: data-analysis,visualization,multimodal,parquet,csv,sql,duckdb
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: authlib>=1.6.6
Requires-Dist: boto3>=1.42.36
Requires-Dist: click>=8.1.8
Requires-Dist: duckdb>=1.4.4
Requires-Dist: flask>=3.1.0
Requires-Dist: lancedb>=0.27.1
Requires-Dist: pyarrow>=21.0.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pylance>=1.0.4
Requires-Dist: pytz>=2025.2
Requires-Dist: requests>=2.32.3
Requires-Dist: rich>=14.3.1
Provides-Extra: jupyter
Requires-Dist: pandas>=2.3.3; extra == "jupyter"
Requires-Dist: pyarrow>=21.0.0; extra == "jupyter"
Requires-Dist: ipython>=8.18.0; extra == "jupyter"
Provides-Extra: daft
Requires-Dist: smoosense[jupyter]; extra == "daft"
Requires-Dist: daft>=0.6.2; extra == "daft"
Provides-Extra: emb
Requires-Dist: torch>=2.5.0; extra == "emb"
Requires-Dist: pillow>=10.4.0; extra == "emb"
Requires-Dist: hdbscan>=0.8.40; extra == "emb"
Requires-Dist: opencv-python-headless>=4.10.0; extra == "emb"
Requires-Dist: tqdm>=4.67.1; extra == "emb"
Requires-Dist: transformers>=4.46.0; extra == "emb"
Requires-Dist: umap-learn>=0.5.7; extra == "emb"
Dynamic: license-file

# ![SmooSense](https://cdn.smoosense.ai/SmooSense-dark.svg)

[**Landing Page**](https://smoosense.ai) | [**Read Docs**](https://smoosense.ai/docs) | [![License](https://img.shields.io/github/license/SmooSenseAI/smoosense)](https://github.com/SmooSenseAI/smoosense/blob/main/LICENSE) | [![CI Status](https://github.com/SmooSenseAI/smoosense/actions/workflows/ci.yml/badge.svg)](https://github.com/SmooSenseAI/smoosense/actions/workflows/ci.yml) | [![Latest version](https://img.shields.io/pypi/v/smoosense?label=pypi-latest)](https://pypi.org/project/smoosense/) | [![Downloads](https://static.pepy.tech/personalized-badge/smoosense?period=total&units=international_system&left_color=black&right_color=MAGENTA&left_text=downloads)](https://pepy.tech/project/smoosense)

SmooSense is a web-based application for exploring and analyzing large-scale multi-modal tabular data. 
It provides an intuitive interface for working with CSV, Parquet, and other data formats with powerful SQL querying capabilities.


## Feature highlights
- Natively visualize multimodal data (images, videos, json, bbox, image mask, 3d assets etc)
- Effortlessly look at distribution. Automatic drill-through from statistics to random samples.
- Graphical and interactive slice-n-dice of your dataset.
- Large scale support for 100 million rows on your laptop.
- Easy to integrate; SmooSense directly work with table file (parquet, csv, jsonl, etc)
- Low cost. Free and open source to use on your laptop. Compute efficient when deployed.

Read more: <https://smoosense.ai>

## How to use
### CLI
Install [uv](https://docs.astral.sh/uv/#highlights), and then
```bash
uv tool install -U smoosense
```
In terminal, `cd` into the folder containing your data files, and then run `sense`

### Jupyter Notebook
```bash
pip install -U "smoosense[jupyter]"
```
Inside Jupyter notebook:
```python
from smoosense.widget import Sense
import pandas as pd
import numpy as np

df = pd.DataFrame(np.random.randn(500, 5), columns=["a", "b", "c", "d", "e"])

Sense(df)  # Displays automatically in Jupyter
```

## License

SmooSense Python SDK is licensed under **Apache 2.0**.

This is a permissive open source license that allows you to:
- ✅ Use SmooSense for any purpose, including commercial use
- ✅ Modify and distribute the software
- ✅ Use it in proprietary software
- ✅ Deploy it in production environments
- ✅ Include it as a dependency in your projects

See the full [LICENSE](LICENSE) file for complete terms and conditions.
