Skip to main content

winnex-nano

Native Winnex inference engine — deterministic spectral tokenizer, multimodel weight balancing, and chunk streaming via the Madhava fast build.

Model-agnostic (Qwen / BERT / DeepSeek / GPT), C++20/OpenCL, no CUDA. Reuses the winnex-madhava engine kernels (QKᵀ matmul, selective-top-K with Cauchy-Schwarz bounds) — no code duplication.

Components

Module Purpose
SpectralTokenizer Character → quaternion spectrum (deterministic, no BPE, no vocabulary)
WeightBalancer Multimodel fusion: W' = Σᵢ αᵢ·R(qᵢ)·Wᵢ
StreamEngine Chunk generation via the Madhava fast build (working memory)
server_sse OpenAI-compatible /v1/chat/completions (stream + non-stream)

Installation

pip install winnex-nano

Requires winnex-madhava>=1.8.1 (the engine), numpy. Optional: winnex-nano[server] for the SSE server (fastapi, uvicorn, httpx).

Quick start

import winnex_nano as wn

# 1. Deterministic spectral tokenizer (no BPE, no vocabulary)
tok = wn.SpectralTokenizer(embed_dim=64)
states = tok.encode("Winnex AI")       # list of quaternions
text = tok.decode(states)              # round-trip: "Winnex AI"

# 2. Multimodel weight balancing: W' = Σ αᵢ·R(qᵢ)·Wᵢ
bal = wn.WeightBalancer()
model_a = {"layer.0.weight": [1, 2, 3, 4]}
model_b = {"layer.0.weight": [10, 20, 30, 40]}
a = wn.BlendWeight(); a.alpha = 0.5
b = wn.BlendWeight(); b.alpha = 0.5
fused = bal.blend([model_a, model_b], [a, b])   # [5.5, 11, 16.5, 22]

# 3. Streaming via the Madhava fast build
engine = wn.StreamEngine()
chunks = []
engine.stream(
    "O Madhava e deterministico.",
    lambda ctx, top: " chunk" if len(chunks) < 3 else "",
    lambda c: chunks.append(c.text) if not c.done else None,
)

SSE server (OpenAI-compatible)

pip install "winnex-nano[server]"
python -m winnex_nano.server_sse 30002
curl -N http://localhost:30002/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"O Madhava e deterministico"}],"stream":true}'

Honest benchmark (vs BPE)

Run the full benchmark on Kaggle — installs winnex-nano from PyPI and reports round-trip, throughput and O(1) decode scaling on real multilingual text:

Kaggle

Metric winnex-nano spectral BPE (Qwen2.5)
Round-trip perfect 8/8 n/a
Char error rate 0.00% n/a
Encode throughput 234K chars/s 4.3M chars/s
Stream (3 chunks) 1.7 ms ~2.1 s (HTTP)
Vocabulary none 151K tokens

The spectral tokenizer is 100% deterministic with no vocabulary dependency, but 50–70× slower and ~1000× less compact than BPE. It is an autonomous encoding for the native multimodel engine, NOT a drop-in BPE replacement for a BPE-trained model.

License

Business Source License 1.1 (BSL 1.1) — pay@winnex.ai.

Pre-patent: https://zenodo.org/records/21861809

Metadata

Release files for winnex-nano 0.1.26

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for winnex-nano 0.1.26
File Size Uploaded Provenance
winnex_nano-0.1.26.tar.gz 155.0 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for winnex-nano 0.1.26
File
winnex_nano-0.1.26-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details
winnex_nano-0.1.26-cp313-cp313-manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.28+ x86-64 Details
winnex_nano-0.1.26-cp313-cp313-macosx_11_0_arm64.whl CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details
winnex_nano-0.1.26-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details
winnex_nano-0.1.26-cp312-cp312-manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64 Details
winnex_nano-0.1.26-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details
winnex_nano-0.1.26-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details
winnex_nano-0.1.26-cp311-cp311-manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64 Details
winnex_nano-0.1.26-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details
winnex_nano-0.1.26-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details
winnex_nano-0.1.26-cp310-cp310-manylinux_2_28_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.28+ x86-64 Details
winnex_nano-0.1.26-cp310-cp310-macosx_11_0_arm64.whl CPython 3.10 CPython 3.10 macOS 11.0+ ARM64 Details

Total release size: 4.2 MB

Release files / winnex_nano-0.1.26.tar.gz

Download URL winnex_nano-0.1.26.tar.gz
Size 155.0 kB
Tags Source
SHA-256 checksum
How to use checksums
34da784630b73ba82d095f074b2cdb41fb12ebf8f6f09dc160d7bf19b7fedcce
BLAKE2b-256 checksum
How to use checksums
0c5cf18fc0f5f1f27e29a802a2b4ef902a773ff1cfd4a7527c9086d9ec326741
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp313-cp313-win_amd64.whl

Download URL winnex_nano-0.1.26-cp313-cp313-win_amd64.whl
Size 234.4 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
ed789f9d22caeec3e5e1993fa23ca983db0e898227e426b177b07bfd36e9a9df
BLAKE2b-256 checksum
How to use checksums
0b8b6d68f1f43a8725414e48cfea450648c5847ef3f558d0bef781f6c353af47
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp313-cp313-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.26-cp313-cp313-manylinux_2_28_x86_64.whl
Size 511.3 kB
Tags CPython 3.13 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
32a3e66908cc38dfe38fdb28fb8bf369664cea64c7e1eadea5dd20f814c384b8
BLAKE2b-256 checksum
How to use checksums
6b1e401576017b8f16f1e2917317730791156f81c6cbfe78f7c36f777409ff54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp313-cp313-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.26-cp313-cp313-macosx_11_0_arm64.whl
Size 254.7 kB
Tags CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
ff6ca84924aedd51799cfe4d3d0fdd7c18884fcf2642e1af3614431a4d56f427
BLAKE2b-256 checksum
How to use checksums
d92063fc1003e682dc67f6b520a70902bcb0e540c9bbc74b025b90977b18c79b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp312-cp312-win_amd64.whl

Download URL winnex_nano-0.1.26-cp312-cp312-win_amd64.whl
Size 234.4 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
0d1a69f5c59c5b943530d877c90170f47dd7a6164076edbdecb882bd9c6299ad
BLAKE2b-256 checksum
How to use checksums
60d31c3d4bbdf4002c05efa6c041ca5a1f54658b8dd9db86717f321bd349bff6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp312-cp312-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.26-cp312-cp312-manylinux_2_28_x86_64.whl
Size 511.3 kB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
322ec769737a8d4e2ae21cfa4c3855aa28cb4caef7b9994c3cd4dc04fa63a4b5
BLAKE2b-256 checksum
How to use checksums
c72ec7a8b293e142ee6cc35f5c5c507577678143ab266f99bb8b4379142bd1a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp312-cp312-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.26-cp312-cp312-macosx_11_0_arm64.whl
Size 254.8 kB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
16f48875705908e28ca3d90227ee739b056b7bba5bc0b95d53dcc067335e8105
BLAKE2b-256 checksum
How to use checksums
2baa244db661adc42355bc20ee378cb4087b3a120ecae64a2c635caee938c8eb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp311-cp311-win_amd64.whl

Download URL winnex_nano-0.1.26-cp311-cp311-win_amd64.whl
Size 235.0 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
1e37bc8d26925b5cff25b93c8354403204c6a187dd4aebe7c7a5460bdcb015f0
BLAKE2b-256 checksum
How to use checksums
01c549b06a32ac5101269718db36e8f747739a1f0ce03278ac6492c2ae246385
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.26-cp311-cp311-manylinux_2_28_x86_64.whl
Size 511.8 kB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
bc24014a06369f66d7a554433a50d18697f6bbe3e23f99e1d5a2e19c5cfb579d
BLAKE2b-256 checksum
How to use checksums
7eb732c36dea716be3e45bb42a909bd854d5d86ad02cfd85e72c25e1511290c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp311-cp311-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.26-cp311-cp311-macosx_11_0_arm64.whl
Size 252.9 kB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
b4e6c123ecadd979e46a39857ab0b7582791f8d6cec375e3be5edc65ed49c370
BLAKE2b-256 checksum
How to use checksums
a319c63c928924b62daefe3476766098760284070ee86b1f06acb6f0b96451a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp310-cp310-win_amd64.whl

Download URL winnex_nano-0.1.26-cp310-cp310-win_amd64.whl
Size 233.8 kB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
5a937a47717ae211e90b086e76d7b4364de639dc8306b130dfb34163bcc66326
BLAKE2b-256 checksum
How to use checksums
a2352b953ac4f3c547076cde79f69bf5ebf45d0fc2b077aaa75d9e5f3ac7247b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp310-cp310-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.26-cp310-cp310-manylinux_2_28_x86_64.whl
Size 510.1 kB
Tags CPython 3.10 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
eb2e059aa868b9eb722ced6e0417a9b8cf41d9a84217dd64083762e740ba225d
BLAKE2b-256 checksum
How to use checksums
12458ad630d3d36c76b39bbf583dde033b51974c6817acdd70d33b22fcce7d3c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / winnex_nano-0.1.26-cp310-cp310-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.26-cp310-cp310-macosx_11_0_arm64.whl
Size 251.7 kB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
728bfeda95d517b8bbbc31b2591f9bcc585deb1c074946bd6773998054464707
BLAKE2b-256 checksum
How to use checksums
ac912e6e9961fa3335ba95a43edc4918cf0559e8110830e11325750bac589e71
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Security for winnex-nano 0.1.26

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 13 files in this release have been uploaded with provenance metadata.

Select from 13 files

Attestation for winnex_nano-0.1.26.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page