Metadata-Version: 2.4
Name: bilinear-quantum
Version: 3.0.1
Summary: Automatic Bilinear Quantum Interaction Learning for TensorFlow and quantum runtimes
Author-email: Nguyen Minh Tuan <minhtuan@ptit.edu.vn>, Bui Phi Hung <n23dcat028@student.ptithcm.edu.vn>
License-Expression: LicenseRef-Proprietary-Bilinear-Quantum
Project-URL: Homepage, https://github.com/Thien-y1502/bilinear-quantum
Project-URL: Documentation, https://pypi.org/project/bilinear-quantum/
Project-URL: Repository, https://github.com/Thien-y1502/bilinear-quantum
Project-URL: Issues, https://github.com/Thien-y1502/bilinear-quantum/issues
Project-URL: PyPI, https://pypi.org/project/bilinear-quantum/
Keywords: bilinear learning,Hirota bilinear operator,quantum machine learning,TensorFlow Quantum
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Mathematics
Requires-Python: <3.14,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy<2.6,>=2
Requires-Dist: scipy<1.19,>=1.15
Requires-Dist: sympy<2,>=1.14
Requires-Dist: pandas<3,>=2.2
Requires-Dist: scikit-learn<2,>=1.8
Requires-Dist: packaging<27,>=25
Requires-Dist: PyYAML<7,>=6
Requires-Dist: psutil<8,>=7
Requires-Dist: tensorflow<2.21,>=2.20
Requires-Dist: keras<4,>=3.10
Provides-Extra: tensorflow
Requires-Dist: tensorflow<2.21,>=2.20; extra == "tensorflow"
Requires-Dist: keras<4,>=3.10; extra == "tensorflow"
Provides-Extra: cirq
Requires-Dist: cirq-core==1.7.0; extra == "cirq"
Requires-Dist: cirq-google==1.7.0; extra == "cirq"
Provides-Extra: pennylane
Requires-Dist: pennylane==0.45.1; extra == "pennylane"
Provides-Extra: experiments
Requires-Dist: matplotlib<4,>=3.11; extra == "experiments"
Requires-Dist: seaborn<1,>=0.13; extra == "experiments"
Requires-Dist: statsmodels<1,>=0.15; extra == "experiments"
Provides-Extra: full
Requires-Dist: tensorflow<2.21,>=2.20; extra == "full"
Requires-Dist: keras<4,>=3.10; extra == "full"
Requires-Dist: cirq-core==1.7.0; extra == "full"
Requires-Dist: cirq-google==1.7.0; extra == "full"
Requires-Dist: pennylane==0.45.1; extra == "full"
Requires-Dist: matplotlib<4,>=3.11; extra == "full"
Requires-Dist: seaborn<1,>=0.13; extra == "full"
Requires-Dist: statsmodels<1,>=0.15; extra == "full"
Provides-Extra: dev
Requires-Dist: build<2,>=1.2; extra == "dev"
Requires-Dist: pytest<9,>=8.4; extra == "dev"
Requires-Dist: pytest-cov<7,>=6; extra == "dev"
Requires-Dist: ruff<1,>=0.12; extra == "dev"
Requires-Dist: twine<7,>=6; extra == "dev"
Dynamic: license-file

# Bilinear Quantum

`bilinear-quantum` 3.0 is a task-oriented TensorFlow/Keras library built around
the Bilinear Quantum Interaction Graph (BQIG). Ordinary users provide data and
an objective; the library handles preprocessing, frozen recipe selection,
optimization, validation, early stopping, and evidence metadata.

Version `3.0.1` is a maintenance release focused on runtime compatibility and
packaging. It does not claim universal model or computational quantum advantage.
Such claims require locked, independent confirmatory benchmarks.

## Install

Python 3.12 or 3.13:

```bash
python -m pip install bilinear-quantum==3.0.1
```

The public distribution is a CPython-specific, compiled-only wheel. It does not
contain implementation source, private recipes, experiment registries,
datasets, checkpoints, or unpublished evidence.

## Use without model configuration

```python
import bilinear_quantum as bq

classifier = bq.learn.classify(data, target="label")
predictions = classifier.predict(new_data)
probabilities = classifier.predict_proba(new_data)

forecast = bq.sequence.forecast(
    time_series,
    target="power",
    horizon=24,
)
print(forecast.values)
```

The public task namespaces are:

- `bq.learn`: classification, regression, embeddings, and clustering;
- `bq.sequence`: classification, forecasting, events, segmentation, anomalies;
- `bq.fusion`: paired-source learning, alignment, and matching;
- `bq.relation`: matching, ranking, retrieval, and recommendation;
- `bq.graph`: node, edge, and link prediction;
- `bq.science`: surrogates, dynamics, operator discovery, and data-driven solves;
- `bq.quantum`: execution brokering, shots, noise, and resources;
- `bq.audit`: certification, paired comparison, and evidence export.

Researchers can freeze an explicit protocol without changing the ordinary API:

```python
protocol = bq.research.Protocol(
    name="subject-disjoint-confirmatory-v1",
    problem="classification",
    modality="sequence",
    seed=3729,
)
result = bq.research.fit(windows, labels, protocol, groups=subject_ids)
```

## Runtime design

TensorFlow 2.20/Keras 3 is the default training runtime. PennyLane and Cirq are
optional quantum execution extras rather than default installation dependencies.
TensorFlow Quantum 0.7.6 is kept in an isolated Python 3.12 reference environment
because it is not dependency-compatible with the main Python 3.13 runtime. It is
never silently emulated.

## Scientific safeguards

- preprocessing is fitted on training rows only;
- group/subject and temporal holdouts are first-class split policies;
- recipe selection uses validation data, never confirmatory test data;
- manifests record recipe, split hash, seed, backend, and versions;
- fallback use is explicit and cannot be counted as a BQL win;
- negative and failed benchmark results remain evidence;
- exact BQL/HQBL identities are separated from empirical Deep-BQL claims.

## License

Copyright (c) 2026 Nguyen Minh Tuan and Bui Phi Hung. The compiled package is
licensed under the accompanying Bilinear Quantum Binary License. It is not an
MIT or open-source distribution. Third-party dependencies retain their own
licenses.

Project: https://github.com/Thien-y1502/bilinear-quantum

Package: https://pypi.org/project/bilinear-quantum/
