Metadata-Version: 2.4
Name: syntropy
Version: 0.1.0
Summary: Modular research library for Efficient Axial Networks and future models
Home-page: https://github.com/ishans2404/syntropy
Author: Ishan Singh
Author-email: Ishan Singh <ishans2404@gmail.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/ishans2404/syntropy
Project-URL: Documentation, https://github.com/ishans2404/syntropy#readme
Project-URL: Issues, https://github.com/ishans2404/syntropy/issues
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.21
Provides-Extra: tf
Requires-Dist: tensorflow>=2.13.0; extra == "tf"
Requires-Dist: keras>=2.13.0; extra == "tf"
Provides-Extra: torch
Requires-Dist: torch>=2.1.0; extra == "torch"
Requires-Dist: torchvision>=0.16.0; extra == "torch"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Syntropy

Syntropy is a lightweight research toolkit for experimenting with hybrid convolutional and attention-based neural architectures. The initial release packages both TensorFlow and PyTorch building blocks for Efficient Axial Networks (EffAxNet) with aligned APIs, making it easy to compare implementations across frameworks and prototype new ideas quickly.

## Installation

Syntropy targets Python 3.8+ and ships optional extras for framework-specific dependencies:

```bash
pip install syntropy
pip install syntropy[tf]
pip install syntropy[torch]
```

The base install depends only on `numpy`. TensorFlow and PyTorch packages are delegated to extras to keep the default footprint small.

## Package Layout

```
syntropy/
├── core          # Framework-agnostic utilities and registries
├── tf            # TensorFlow layers, models, and training loops
├── torch         # PyTorch mirrors of the TensorFlow components
└── examples      # Jupyter notebooks and end-to-end demos
```

## Quick Start

```python
from syntropy.tf.models import effaxnet_2d

model = effaxnet_2d.build_model(input_shape=(128, 128, 3), num_classes=10)
model.summary()
```

## Development

1. Install development requirements:
   ```bash
   pip install -e .[tf,torch]
   ```
2. Run the unit tests:
   ```bash
   pytest
   ```

## License

This project is licensed under the MIT License. See `LICENSE` for details.
