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.23

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.23
File Size Uploaded Provenance
winnex_nano-0.1.23.tar.gz 133.4 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for winnex-nano 0.1.23
File
winnex_nano-0.1.23-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details
winnex_nano-0.1.23-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.23-cp313-cp313-macosx_11_0_arm64.whl CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details
winnex_nano-0.1.23-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details
winnex_nano-0.1.23-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.23-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details
winnex_nano-0.1.23-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details
winnex_nano-0.1.23-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.23-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details
winnex_nano-0.1.23-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details
winnex_nano-0.1.23-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.23-cp310-cp310-macosx_11_0_arm64.whl CPython 3.10 CPython 3.10 macOS 11.0+ ARM64 Details

Total release size: 3.9 MB

Release files / winnex_nano-0.1.23.tar.gz

Download URL winnex_nano-0.1.23.tar.gz
Size 133.4 kB
Tags Source
SHA-256 checksum
How to use checksums
76a832a394b562000bcc8048851c0ec87ede626717136d353c68c34daac4fe95
BLAKE2b-256 checksum
How to use checksums
8121c438b3421da728c9875b65853656b97c79cb995c8f9f8c38f1c49bdb6336
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp313-cp313-win_amd64.whl
Size 223.3 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
8e585c6371bd95c7802e65e70c6c47c2c6a4667f711dc9fc3a32a4624a718178
BLAKE2b-256 checksum
How to use checksums
022c1dc5dff678c2836edbd734c8659b6739236e0ca8e3ce1374d9aecb3ee2c9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp313-cp313-manylinux_2_28_x86_64.whl
Size 492.7 kB
Tags CPython 3.13 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
73ea4149f357dfefc249d0c652dc8a17b1878bc367ec957801631fa4c3bd4fd6
BLAKE2b-256 checksum
How to use checksums
b99586af2c35dca5b4d94229343ac02ffd063bcb91ba1bfb6eecc6934735e0e4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp313-cp313-macosx_11_0_arm64.whl
Size 239.6 kB
Tags CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
87962bed9670d41c67fd84b4f3b94dc3b330703d6b5483d244496c8ba8e431e4
BLAKE2b-256 checksum
How to use checksums
987cf54683bc05e3b7a18ff1dd36904cbb68dc2c916c1a36df2f76d4c61c4de1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp312-cp312-win_amd64.whl
Size 223.2 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
3301255616fe4be54cd317d2e6fbcc3aa21c2ed5b80a3b0bb3dc9d849907693e
BLAKE2b-256 checksum
How to use checksums
5404b94da58b4543d27115ec82c181ac2010563725b62e6aacfb1696f395c69a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp312-cp312-manylinux_2_28_x86_64.whl
Size 492.5 kB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
394bd71ee761a9ed14fa78f179d5d24080a5928f58a416016d5efb26269542df
BLAKE2b-256 checksum
How to use checksums
3b44f985b886fa8af80c79c5fe1a06f64109ba84dbc42299ccd74345a3ce7483
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp312-cp312-macosx_11_0_arm64.whl
Size 239.6 kB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
bf5095d08c2954d6a5736091c77c3b3f2f9d00348cb5d465dc4ec0b3bb309785
BLAKE2b-256 checksum
How to use checksums
37b0c97c33096220acbf61a7cb89c11a7c7ee0347a72f443f75563c298f5db86
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp311-cp311-win_amd64.whl
Size 223.6 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
440865be00d7d62fc13bd4cfa855f6ca1bdf8442f027a9bf5ba1943bed617ebd
BLAKE2b-256 checksum
How to use checksums
580e45d10b3d728428dcd327b14a4af3db2ce7117fb00782cfeef1974e846f54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp311-cp311-manylinux_2_28_x86_64.whl
Size 492.4 kB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
8a1c1787f43480560dab50d2751ee3b3b4c0e23e3fd583d8a064c5643e0a7453
BLAKE2b-256 checksum
How to use checksums
ca9d7e1469cb1b29acc1e921aac061f04f204962f5aab58285a84b994df9b03f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp311-cp311-macosx_11_0_arm64.whl
Size 238.0 kB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
857fa2f72c46e973aa3015a642461b10f3c8b9af4cc190b15b54fd92cc74d49b
BLAKE2b-256 checksum
How to use checksums
cfe75e0be1e8af7a40dbde3bcf06da1c390dd43fae3a7d247c190249b3721929
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp310-cp310-win_amd64.whl
Size 222.3 kB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
35e9bf1e9c743a1b024469fc67064ae35735fff7fb68b3c46a65c4a9b95abd31
BLAKE2b-256 checksum
How to use checksums
a0909e578b51781e174ca924e1b0376eaaeb00ce1d95a83bf3ede86b203dd023
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp310-cp310-manylinux_2_28_x86_64.whl
Size 491.0 kB
Tags CPython 3.10 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
252ab4c20ccc0b82fcda8fe8d8e96488090ecafca69be103c19382e6c1c5a79c
BLAKE2b-256 checksum
How to use checksums
9287e363bb9146675db8b1042afde99fe8b4dda3530c9418cd79b304f116aef7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL winnex_nano-0.1.23-cp310-cp310-macosx_11_0_arm64.whl
Size 236.9 kB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
3dd5b95ee820b8e01737998515b032a0188d95975747b6cf9c6af2fdd6f0d651
BLAKE2b-256 checksum
How to use checksums
fb7b0b8fb57e14537dc351c953ab026e50cb5ae2a4e7f37f633753d4192fa159
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

Security for winnex-nano 0.1.23

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.23.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 19, 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