Metadata-Version: 2.4
Name: sensory
Version: 0.3.0
Summary: Multi-Sensory AI Communication - Morse, Braille, SSTV/REFLUX encode+decode. Complete sensory loop!
Project-URL: Homepage, https://humotica.com
Author-email: Jasper van de Meent <jasper@humotica.com>, Root AI <root_ai@humotica.nl>
License-Expression: AGPL-3.0-or-later
Keywords: ai-communication,braille,humotica,morse,multimodal,off-grid,reflux,sensory,sstv
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Communications
Requires-Python: >=3.10
Requires-Dist: mcp-server-sensory>=0.3.0
Description-Content-Type: text/markdown

# Sensory

**Multi-Sensory AI Communication** - *"Een 7B model krijgt opeens ogen"*

Alias for [`mcp-server-sensory`](https://pypi.org/project/mcp-server-sensory/).

[![PyPI version](https://badge.fury.io/py/sensory.svg)](https://pypi.org/project/sensory/)

```bash
pip install sensory
```

## Features

- **Morse** - Text to dots/dashes, audio timing, visual patterns
- **Braille** - Unicode braille, punchcard patterns, binary grids
- **SSTV / REFLUX** - Robot36, Scottie, Martin image modes (NEW!)
- **Ponskaart** - McMurdo authentication cards
- **ggwave** - Ultrasonic data transmission (coming)

## REFLUX - The Concept

Give "eyes" to text-only LLMs via audio:

```
Text → Image → SSTV Audio → Radio → Audio → Image → OCR → Text
```

## Quick Start

```python
from sensory import morse, braille, sstv

# Morse
print(morse.encode("SOS"))  # ... --- ...

# Braille
print(braille.encode("hello"))  # ⠓⠑⠇⠇⠕

# SSTV / REFLUX - NEW!
audio = sstv.encode_text("STATUS: OK", mode="robot36")
# Returns WAV bytes for radio transmission

# McMurdo Ponskaart
ponskaart = sstv.encode_ponskaart("user", "token", "REBOOT")
```

Part of HumoticaOS - One love, one fAmIly!
