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

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.22
File Size Uploaded Provenance
winnex_nano-0.1.22.tar.gz 133.3 kB With provenance Details

Built distributions (wheels)

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

Download URL winnex_nano-0.1.22.tar.gz
Size 133.3 kB
Tags Source
SHA-256 checksum
How to use checksums
9e52f4516668e5d5dd02f04d2d5055edf93037e4914c6222c82965b2904b1bc9
BLAKE2b-256 checksum
How to use checksums
75d8a1f1a9323e0d3fa57eb5a7b5e54285f4cc6e191871fabc80b65f25363875
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.22-cp313-cp313-win_amd64.whl

Download URL winnex_nano-0.1.22-cp313-cp313-win_amd64.whl
Size 223.1 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
0bac87d6052386e3dc24e381c3fd01ed62c862f6d86744de6703283cf50c788b
BLAKE2b-256 checksum
How to use checksums
c873bf9fecde8396c8e6a1d358b69e5060c1bed6cc7f4136b55f056cee58c05a
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.22-cp313-cp313-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.22-cp313-cp313-manylinux_2_28_x86_64.whl
Size 492.5 kB
Tags CPython 3.13 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
5c63f72aea7b5defa1a17a6e900809d5de5d92abd7ddfb03610ffb624784ad04
BLAKE2b-256 checksum
How to use checksums
8e7a548584961c52178ef28dd2f876e804bb4ea137a723ed22c00e80971f6fe9
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.22-cp313-cp313-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.22-cp313-cp313-macosx_11_0_arm64.whl
Size 239.4 kB
Tags CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
e9725f202c1c61357086c1ed2fe23d6b7153ed2d3b3f37307d3b0dd829644290
BLAKE2b-256 checksum
How to use checksums
db826a2a88611a2927d1cbe4293ac56b1edca861e162248cdf2c7154a5268d91
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.22-cp312-cp312-win_amd64.whl

Download URL winnex_nano-0.1.22-cp312-cp312-win_amd64.whl
Size 222.9 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
cabf086a9f8afe386a909e0244b8c279e9d85352af9a8694d5f27f5454a7c863
BLAKE2b-256 checksum
How to use checksums
dc22f02808c24ffdb2e86bbcdf247fc3cefcaf5609bbed5f893cc25578c040d8
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.22-cp312-cp312-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.22-cp312-cp312-manylinux_2_28_x86_64.whl
Size 492.3 kB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
ca3a684b1a44c66c6e8f77834bd6fd47a43d0dac094e3281a5b18b7b3f15795b
BLAKE2b-256 checksum
How to use checksums
8bbdaa7d726f96788e4d3f42d2ddd9877acfac441f96d706268689479c613f7b
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.22-cp312-cp312-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.22-cp312-cp312-macosx_11_0_arm64.whl
Size 239.4 kB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
0ee4e1d330126c54ffeb1c8b6f8b869388258b13c9234b53d11a94142c517049
BLAKE2b-256 checksum
How to use checksums
880b16b981c42420255d1d4439d5eeb31ca6311be517ebb21a4227c2c1925813
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.22-cp311-cp311-win_amd64.whl

Download URL winnex_nano-0.1.22-cp311-cp311-win_amd64.whl
Size 223.4 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
2326c2bd9d22740283c75ba73669bda4970f08544b4d59e5da0f7988bbefd269
BLAKE2b-256 checksum
How to use checksums
26525a0594d006a323f84585ecf8563a3d66e2e1164bac57c89b056ba617e807
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.22-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.22-cp311-cp311-manylinux_2_28_x86_64.whl
Size 492.2 kB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
829055abb4381f2830fa332f751a19dceb4bc7ea113d3940eb2dce7c16b24427
BLAKE2b-256 checksum
How to use checksums
a172a29d5d49aba3927f5d7eb882f00dec0bb6f9825fd146ec35df5b71df01e0
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.22-cp311-cp311-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.22-cp311-cp311-macosx_11_0_arm64.whl
Size 237.8 kB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
0d79915f7c6d4d79bd278eb76a99dd7591ac93124a5f4a116e009fe0170a5ec8
BLAKE2b-256 checksum
How to use checksums
c7f556976c01f406a7837c9152ba5a58622f8f45bf176ac5d5499ecf7b9d42a1
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.22-cp310-cp310-win_amd64.whl

Download URL winnex_nano-0.1.22-cp310-cp310-win_amd64.whl
Size 222.0 kB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
3c54fb226daa1b31423b5d7059cb7154b8b366d88c81502183cd83e8e988e30d
BLAKE2b-256 checksum
How to use checksums
c2643c02229d6fdc577683c4d977c7df3b74046dd29f517e12f2ecdf458f6c40
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.22-cp310-cp310-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.22-cp310-cp310-manylinux_2_28_x86_64.whl
Size 490.8 kB
Tags CPython 3.10 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
078e8615ef3635e52ea8652c8d56c842fd023942d4d159cf924f040d6a089d7f
BLAKE2b-256 checksum
How to use checksums
23012435c5e1aab9dbd4972fd2220ff2d3365b1a6d2e74c6eb3ad2a7e615be17
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.22-cp310-cp310-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.22-cp310-cp310-macosx_11_0_arm64.whl
Size 236.7 kB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
1618c42e7c2fa59088bd79704108562748654831fda9b01aaf560136141b6bc4
BLAKE2b-256 checksum
How to use checksums
bdbbe23406726333fec5495a55e9f8abacf6be3d363ea3fd6a9ef03021eea97d
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.22

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