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

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.24
File Size Uploaded Provenance
winnex_nano-0.1.24.tar.gz 134.1 kB With provenance Details

Built distributions (wheels)

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

Download URL winnex_nano-0.1.24.tar.gz
Size 134.1 kB
Tags Source
SHA-256 checksum
How to use checksums
59b6fd9e96f36dd7279721aa0bcfab25f985dcaa19bf380c69c2e46fb97b43d5
BLAKE2b-256 checksum
How to use checksums
c12e042e545e1b6d373a057dcabd81945f7a6fdf96849d33773036f4c6e00785
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.24-cp313-cp313-win_amd64.whl

Download URL winnex_nano-0.1.24-cp313-cp313-win_amd64.whl
Size 223.3 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
3c65b86b61c405e4185e5883c46a4f3dd6477684355e1ec81aa08d4dda5912bc
BLAKE2b-256 checksum
How to use checksums
8f8d740c89b174f5949afaaaf357fcb0270815e59f347289962701efdc60b72b
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.24-cp313-cp313-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.24-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
42b684065fa6347427ca775e47e7ed4a62e939219b9106471e0054f291cae89d
BLAKE2b-256 checksum
How to use checksums
c3f6280124e58be1b83b35e3fa9eb87df92d339df09d17138ff14f02615d771d
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.24-cp313-cp313-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.24-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
53a141232331250edebe3fbe4ea689395420948d1d54847ca5985fb276b873d2
BLAKE2b-256 checksum
How to use checksums
122f4d8dfe6d3873745492be833d637bcaf4ace4e0c9cdd8cc2824ca451b2db1
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.24-cp312-cp312-win_amd64.whl

Download URL winnex_nano-0.1.24-cp312-cp312-win_amd64.whl
Size 223.2 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
49a4c6b19149ca38386f13b3f4d0f7affc9be0d20079e779647279ae751d8425
BLAKE2b-256 checksum
How to use checksums
80fd98fe6d8bfe80ffed65055c3d5658112f7fb5cae67b984594b9fa1dbe811e
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.24-cp312-cp312-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.24-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
97bc3ee7b4a01a6b35807fbb4535ff3bc02957acb310b334ba202d8e57a7520a
BLAKE2b-256 checksum
How to use checksums
95c413ab44015d5c75a92961d9976da5bebf5fd4af38df24b85864528f51d262
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.24-cp312-cp312-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.24-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
16bec0160d824faf97f6879be6e6759d0c26993e14b1487058456ce7e04f0561
BLAKE2b-256 checksum
How to use checksums
6cdf42970ee08648ee7a761c03109b359aa420d938ab329fbbf901e7d7366d83
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.24-cp311-cp311-win_amd64.whl

Download URL winnex_nano-0.1.24-cp311-cp311-win_amd64.whl
Size 223.6 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
3d91da18fb19a62d5de5a46e895715909a06709ac3fc419c8b442f26325f55a0
BLAKE2b-256 checksum
How to use checksums
a8e911e3f96ee19ce20f981e6878f3cd63ea000f9f90e05af5d79cf3de420d8a
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.24-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.24-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
2b2ea4a3c5099816e29913359ff0d29b998a8115d5e3f718a65c200ab506d8da
BLAKE2b-256 checksum
How to use checksums
22f233b780e251e287d30fe95c1a603f4a2c80870fafc1cb67701ac127124c32
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.24-cp311-cp311-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.24-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
bc8d0339fa1eb740efb30d584080728ee33646cecde6a86a68e05a1e4c3f603d
BLAKE2b-256 checksum
How to use checksums
e6ef11b42b8479c3aa349312c3dc33846e84d994388a4475c1f5720b0ae9ecdc
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.24-cp310-cp310-win_amd64.whl

Download URL winnex_nano-0.1.24-cp310-cp310-win_amd64.whl
Size 222.3 kB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
5e024d53928459324987ba9f884ef7b3c66520c1751c5add4eba04f5ed372303
BLAKE2b-256 checksum
How to use checksums
c6f0bc5e11f44cf02734203f756738efcef375dcfd5f4dc16abcdeaeb3384d2c
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.24-cp310-cp310-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.24-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
f1b47ad890fbc1d73866f7811f45505adb364b2f23688cead2cac3d365f8c88f
BLAKE2b-256 checksum
How to use checksums
ea963ea7fc9cffcfec57af4b0a762934ada1a60c6c448e4b471d84212cae888f
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.24-cp310-cp310-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.24-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
50f67ff4c9d07d0b319876273a0898d8f5fcbe4b551dea780de4655b6d6a3e1b
BLAKE2b-256 checksum
How to use checksums
6c7bf05cf2810af2dffd02dfe38b5a3cdee1cc08ad6cd12f8dc558640e6f21d9
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.24

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