Skip to content

Installation¤

Requirements¤

  • Python 3.10 or higher
  • pandas >= 2.0.0
  • numpy >= 1.24.0

Install from PyPI¤

pip install ts-shape

Install from Source¤

git clone https://github.com/jakobgabriel/ts-shape.git
cd ts-shape
pip install -e .

Verify Installation¤

import ts_shape
from ts_shape.transform.filter.numeric_filter import NumericFilter

print("ts-shape installed successfully!")

Optional Dependencies¤

Install extras for specific backends:

# Parquet support (recommended)
pip install pyarrow

# S3 storage
pip install s3fs

# Azure Blob storage
pip install azure-storage-blob

# TimescaleDB
pip install sqlalchemy psycopg2-binary

Development Installation¤

For contributing:

git clone https://github.com/jakobgabriel/ts-shape.git
cd ts-shape

# Install in development mode
pip install -e .

# Install dev dependencies
pip install pytest black flake8

# Run tests
pytest

# Format code
black src/

Troubleshooting¤

ImportError for ts_shape 

# Check your environment
which python
pip list | grep ts-shape

pandas version conflict 

pip install --upgrade pandas

Performance with large datasets 

pip install pyarrow  # Faster parquet loading

Next Steps¤