GoldenFloat Python Bindings
Phi-structured floating-point formats for machine learning and scientific computing.
Installation
pip install golden-float
Quick Start
import numpy as np
from golden_float import gf16, gf32
# Create GoldenFloat values
phi = gf16(1.618)
pi = gf32(3.14159)
# Convert to float
print(phi.to_float()) # 1.618
# Arithmetic
result = phi + phi
# NumPy array support (with dtype registration)
arr = np.array([1.0, 1.618, 2.718], dtype=gf16)
Format Reference
| Format | Bits | Use Case | Memory vs f32 |
|---|---|---|---|
| GF4 | 4 | Ultra-compact quantization | 12.5% |
| GF8 | 8 | Minimal precision | 25% |
| GF12 | 12 | Embedded ML | 37.5% |
| GF16 | 16 | Primary format (replaces bfloat16) | 50% |
| GF20 | 20 | Balanced | 62.5% |
| GF24 | 24 | High precision | 75% |
| GF32 | 32 | Full precision (same size as f32) | 100% |
License
MIT
Metadata
Release files for golden-float 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| golden_float-0.1.0-cp311-abi3-win_amd64.whl | CPython 3.11 | abi3 | Windows x86-64 | Details |
| golden_float-0.1.0-cp311-abi3-manylinux_2_34_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.34+ x86-64 | Details |
| golden_float-0.1.0-cp311-abi3-macosx_11_0_arm64.whl | CPython 3.11 | abi3 | macOS 11.0+ ARM64 | Details |
Total release size: 616.3 kB
Release files / golden_float-0.1.0-cp311-abi3-win_amd64.whl
| Download URL | golden_float-0.1.0-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 149.9 kB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
cfd0e0afabfe512d486821ae55c1daedf754e9cee45bcce04c4232adc3977506
|
|
BLAKE2b-256 checksum How to use checksums |
172c5883de0ddb852c5a3d782f0a0ad41c40aba855978825fe78879b6e82803c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.12.6
|
Release files / golden_float-0.1.0-cp311-abi3-manylinux_2_34_x86_64.whl
| Download URL | golden_float-0.1.0-cp311-abi3-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 250.2 kB |
| Tags | CPython 3.11 Linux glibc 2.34+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
3ae86f55ef4f3cd53a99b491cef9689c814a66fa6b69e76cb4ee923e2a924907
|
|
BLAKE2b-256 checksum How to use checksums |
eb408a2deb3ea9bb298a455c2035a9507e6513f2c94d7f5cf85f4ff5de1c3566
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.12.6
|
Release files / golden_float-0.1.0-cp311-abi3-macosx_11_0_arm64.whl
| Download URL | golden_float-0.1.0-cp311-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 216.1 kB |
| Tags | CPython 3.11 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2c30519595f458c9439f5d04896be7d1723393080098d697eecfacee81d4d5f0
|
|
BLAKE2b-256 checksum How to use checksums |
21bf71143ab60c5d156d68c0a10ca1b2a4f0df9637acef47b83641c4ae11c467
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.12.6
|