Metadata-Version: 2.4
Name: purem
Version: 3.0.5
Summary: The official high-performance mapping function for mixed-type arrays powered by Work TIF Ltd.
Author-email: Raman Marozau <raman@worktif.com>
License-Expression: BUSL-1.1
Project-URL: Homepage, https://github.com/worktif/purem
Project-URL: Documentation, https://worktif.com/docs/basic-usage
Keywords: mapping,performance,numpy,arrays
Classifier: Typing :: Typed
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Operating System :: MacOS
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.11
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: numpy~=2.1.3
Requires-Dist: numba~=0.61.0
Requires-Dist: certifi~=2025.1.31
Requires-Dist: pydantic~=2.10.6
Requires-Dist: dotenv~=0.9.9
Requires-Dist: python-dotenv~=1.1.0
Requires-Dist: setuptools~=65.5.1
Requires-Dist: requests~=2.32.3
Requires-Dist: pytest~=8.3.5
Requires-Dist: pytest-env~=1.1.5
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: coverage; extra == "dev"
Requires-Dist: pytest-mock; extra == "dev"
Dynamic: license-file

Purem - High-Performance Mapping Operations
===========================================

.. image:: https://badge.fury.io/py/purem.svg
   :target: https://pypi.org/project/purem/
   :alt: PyPI version

.. image:: https://img.shields.io/badge/architecture-x86--64-002e30.svg
   :target: https://refspecs.linuxfoundation.org/elf/x86_64-abi-0.99.pdf
   :alt: Architecture Processor x86_64

.. image:: https://img.shields.io/badge/architecture-ARM64-002e30.svg
   :target: https://worktif.com
   :alt: Architecture Processor ARM64

.. image:: https://img.shields.io/pypi/pyversions/purem.svg
   :target: https://worktif.com
   :alt: Architecture Processor ARM64

.. image:: https://img.shields.io/badge/sandbox-Apple%20Silicon-green.svg
   :target: https://worktif.com
   :alt: Apple Silicon

.. image:: https://img.shields.io/badge/license-BUSL--1.1-blue.svg
   :target: https://worktif.com/documents/terms-of-service
   :alt: License: BUSL-1.1

Overview
--------

**Purem** is an advanced high-performance computational library optimized for vectorized mathematical operations. This project focuses on efficient execution of element-wise transformations, including ``softmax``, ``exp``, and other mathematical functions, leveraging highly optimized assembly code for modern architectures.

Key Features
------------

Purem is a blazing-fast AI math engine that turns your Python formulas into native-speed vectorized execution.
Achieve up to 429× faster performance on CPU/GPU/TPU – no rewrites, no dependencies, just speed.
Designed for ML researchers, scientific computing, and production-grade workloads that can’t afford to wait.

---

🔧 Installation
---------------

Install the Python wrapper via pip::

    pip install purem

📦 **Note:** Installation is quick, but ``purem`` must be initialized with a license before use.
Setup takes less than a minute – we’re ready when you are: https://worktif.com/#start

---

🚀 Quickstart
-------------

1. Import and Initialize::

    from purem import purem

    purem.configure(license_key='your-license-key')  # Auto-downloads and configures backend

---

🔐 License-Based Activation
----------------------------

The system will download the licensed native Purem engine:

1. Call ``purem.configure(license_key='<your-license-key>')``
2. The system will download the native Purem engine
3. All functions will become available instantly after initialization

Without a valid license key:

- No native Purem engine will be downloaded

---

🧠 Available Functions
-----------------------

After initialization, you can call::

    from purem import purem

    # Transforms a list of numbers into a probability distribution.
    # Each output value is between 0 and 1, and all outputs sum to 1.
    # Commonly used in classification tasks to interpret scores as probabilities.
    purem.softmax([...])
    ...

Full function list: https://worktif.com/docs/basic-usage

---

📦 Packaging Notes
-------------------

This package does **not** bundle the native Purem engine. You are required to:

- Use a license key to download it dynamically

---

🧪 Benchmark Tutorial
----------------------

Visit the Benchmark Tutorial: https://worktif.com/#benchmarks

- How ``Purem`` compares to NumPy, PyTorch and Numba
- How it reaches low-level performance via native execution
- Why it's faster than traditional Python-based computation

---

📧 Distribution and Licensing
------------------------------

The native Purem engine is distributed exclusively through license-based activation.
All users must:

- Use their license key to install

For access, contact us or visit: https://worktif.com/documents/terms-of-service

---

📚 Full Example
----------------

.. code-block:: python

    # Import required modules
    import numpy as np
    from purem import purem

    # Automatic setup using license key
    try:
        purem.configure(license_key='<your-license-key>')
    except Exception as e:
        print(f"Setup failed: {e}")

    data = np.array([1.0, 2.0, 3.0], dtype=float)
    output = purem.softmax(data)

    print(output)

---

🧠 Why Purem?
--------------

- 🔥 High level performance with zero Python overhead
- 🧪 Built-in benchmarking and scientific accuracy
- 🧩 Easy plug-and-play design
- 🔐 Secure and license-aware system

---

🛠 Advanced Usage & API Docs
----------------------------

Coming soon...
