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

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.25
File Size Uploaded Provenance
winnex_nano-0.1.25.tar.gz 145.6 kB With provenance Details

Built distributions (wheels)

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

Total release size: 4.0 MB

Release files / winnex_nano-0.1.25.tar.gz

Download URL winnex_nano-0.1.25.tar.gz
Size 145.6 kB
Tags Source
SHA-256 checksum
How to use checksums
10e900ccacec8f7d2b287e77ea5b8d57911ea697290e53efe5d40dc5b4103c58
BLAKE2b-256 checksum
How to use checksums
f018903249ff22fdb2a86e68e12ace80585a9bd42ba41ce635c25c51506f0528
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.25-cp313-cp313-win_amd64.whl

Download URL winnex_nano-0.1.25-cp313-cp313-win_amd64.whl
Size 225.2 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
38e5051b92bfed457c6b7fc2f0fe9d092a5f45f705ab235a29abb277776df3eb
BLAKE2b-256 checksum
How to use checksums
77863e0b14014eafa2b3b9efc83031590dd52747f17753636dd7856384e0cad8
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.25-cp313-cp313-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.25-cp313-cp313-manylinux_2_28_x86_64.whl
Size 498.0 kB
Tags CPython 3.13 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
72a81631fefaa8592dbe914441da96041e20fe4f19efcebd549203bb071e7273
BLAKE2b-256 checksum
How to use checksums
3c86e92f4f4897e44d424a13a5f143830c20b5236497ce9aa352fff8a19c7882
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.25-cp313-cp313-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.25-cp313-cp313-macosx_11_0_arm64.whl
Size 242.5 kB
Tags CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
b3241563f15be911916d13dc5a70db8416652e6ef48be222091b925d399addb9
BLAKE2b-256 checksum
How to use checksums
3709d51a5f4381921b284201b4c6bfc38750ea1df6093479c962262b4d94ff2a
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.25-cp312-cp312-win_amd64.whl

Download URL winnex_nano-0.1.25-cp312-cp312-win_amd64.whl
Size 225.2 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
c2112b11372214d3b53f5edc62589b71e80e4ea67f134692777464bef8efdc13
BLAKE2b-256 checksum
How to use checksums
7c4b3a68fe880803f1ac89ef05b215267e8a95723013ba238a96c2b5684b269d
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.25-cp312-cp312-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.25-cp312-cp312-manylinux_2_28_x86_64.whl
Size 498.0 kB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
5adb71645c3380a46b5c01ec59180dfe3032d7050a47921f79642f3edfd2793c
BLAKE2b-256 checksum
How to use checksums
afbf61ba99bce69f9e7ca481b88b6c7cfd250ac6701323a0afa7fb40b9aec56b
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.25-cp312-cp312-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.25-cp312-cp312-macosx_11_0_arm64.whl
Size 242.5 kB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
8c15f14c4f82ac842ddf5ae51f1f851dda6e38f7b937dd8f8fbb8a9edffecea0
BLAKE2b-256 checksum
How to use checksums
a266022f7af60a1fe64ee6a0c48074d5c57e312f9238e8062537c2e1cdb89149
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.25-cp311-cp311-win_amd64.whl

Download URL winnex_nano-0.1.25-cp311-cp311-win_amd64.whl
Size 225.6 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
b74af747e22f44973199225e4c76fb7c12e03f70b6c1b6ff274cd6a783f54869
BLAKE2b-256 checksum
How to use checksums
c1c014fa2e057ece6b65fb09fe99e73e51393fe1ec883555c62d1b7157d12f70
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.25-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.25-cp311-cp311-manylinux_2_28_x86_64.whl
Size 497.3 kB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
69b61c61ba432e971f6a5cb0545ed3132e058a3d7ea1d7224bca8a78fb81be0e
BLAKE2b-256 checksum
How to use checksums
13942a677987fad9ab54076285c6125bda3fdb423eed1b1ea8584cbd9946d7c5
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.25-cp311-cp311-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.25-cp311-cp311-macosx_11_0_arm64.whl
Size 241.2 kB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
807b24f68ae3e88c568e0dc67d2de8db082d7d420b2893f25f3905b702e0f098
BLAKE2b-256 checksum
How to use checksums
51c293cea12e48d157f12090c0f95a174d7929639a351b361ed85ec2b8896300
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.25-cp310-cp310-win_amd64.whl

Download URL winnex_nano-0.1.25-cp310-cp310-win_amd64.whl
Size 224.4 kB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
0ca8a0254621afec77052239f066e877924c69064cd366ad76f741ef271ca21a
BLAKE2b-256 checksum
How to use checksums
3001fc4f5179f6be24647e0f7aad3389e6fb5b66d572d96b3677d8782500c101
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.25-cp310-cp310-manylinux_2_28_x86_64.whl

Download URL winnex_nano-0.1.25-cp310-cp310-manylinux_2_28_x86_64.whl
Size 495.6 kB
Tags CPython 3.10 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
e3230af2f2832bd67965ebaef9755f6f17bee62526462129eb46119d37a535c2
BLAKE2b-256 checksum
How to use checksums
e7de1a981ee1d02b7e76a6f6f26d9db7ad1a3b5f8feeffd1d725082d80564ad4
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.25-cp310-cp310-macosx_11_0_arm64.whl

Download URL winnex_nano-0.1.25-cp310-cp310-macosx_11_0_arm64.whl
Size 240.2 kB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
f40dfbe1199491ad8994e1dcb5ec8b9435a130611ce92f0a8ef190f55fe648ea
BLAKE2b-256 checksum
How to use checksums
0245f7c7a24291ba2a806b1ffa2e3757a06d6f1e0b3a360f79a666fd941d9d00
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.25

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