Skip to content

fire17/TesseractLogo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TesseractLogo — the 4D hypercube mark, pure math, infinite resolution

license geometry generator playground live app stars

A logo you can zoom into forever — because it isn't a picture, it's a theorem.

⚡ Quickstart · 🎨 Gallery · 🕹️ Playground · 🧮 The math · 🛠️ Making-of


✨ The part that should stop you

This mark was never drawn. It is computed. The star-like logo from fire17/tami is the Petrie projection of a tesseract — a real 4-dimensional hypercube flattened onto the page — and this repo regenerates it from first principles instead of upscaling the old 1000px raster:

  • The 16 vertices are every point of (±1, ±1, ±1, ±1) in 4D space; the 32 edges connect pairs differing in exactly one coordinate — tesseract.py asserts both counts on every run.
  • Projection basis: angles π/8 + i·π/4 — that's the whole trick. Four cosine/sine pairs turn 4D into the octagonal lattice you see.
  • The generator is ~50 lines of Python, standard library only. No numpy, no drawing package, no design tool.
  • A vector master is ~7 KB and stays razor sharp at any size; the original raster was 400 KB and blurry past 1000px.
  • Every image in this repo — all 8 variants, the 4K renders, even the banner above — comes out of the same 32-edge computation.

Important

Change one number in tesseract.py and every variant regenerates, pixel-perfect, at any resolution — the logo is source code now.

⚡ Quickstart

Zero-install: open the live playground → https://tesseract.akeyo.io/ — drag sliders, pick colors, hit Save PNG.

Or regenerate every SVG master locally (stdlib only):

git clone https://github.com/fire17/TesseractLogo && cd TesseractLogo
python3 tesseract.py            # emits all 8 SVG variants into the cwd
# optional 4K raster: brew install librsvg
rsvg-convert -w 4000 -h 4000 tesseract-outlined.svg -o tesseract-4k.png

🎨 Gallery — 8 variants

Every cell links to its infinitely-scalable SVG master; 4000×4000 PNGs live in assets/png/.

Light Inverted
Outlined
Solid
Thin outlined
Thin solid

Plus the two gray-outline masters matching the original tami style (tesseract.svg, tesseract-thin.svg) and the original 1000px raster for comparison in assets/reference/.

🕹️ The playground

index.html — one self-contained file, zero dependencies, served as the live GitHub Page:

Control What it does
line width / outline thickness bar weight; outline 0 = solid mode
figure scale logo size inside the frame
line / outline / background colors full pickers + transparent-background toggle
Invert Colors flips all three to exact RGB inverses
Save PNG canvas export at any resolution (default 4000px, up to 16k)
Save SVG downloads the current design as a vector master

🧮 The math

How 4 dimensions become a flat star (the whole algorithm)

A tesseract's vertices are all sign combinations of (±1, ±1, ±1, ±1). To flatten 4D → 2D, project each vertex onto two axes built from four angles:

TH = [pi/8 + i*pi/4 for i in range(4)]        # 22.5°, 67.5°, 112.5°, 157.5°
U  = [(cos(t), sin(t)) for t in TH]           # four 2D direction vectors

x = sum(v[i] * U[i][0] for i in range(4))     # vertex v = (±1,±1,±1,±1)
y = sum(v[i] * U[i][1] for i in range(4))

This is the Petrie projection — the one that gives the hypercube its maximal octagonal symmetry. The π/8 offset rotates the octagon so corners sit at N/E/S/W, matching the original logo's orientation. Edges connect vertex pairs at Hamming distance 1 (sum(a[i] != b[i]) == 1), giving exactly 16·4/2 = 32 lines.

The outlined look is two stroke passes: every edge drawn wide in the outline color, then again narrower in the fill color on top.

🛠️ Making-of

Built in one Claude Code session (2026-07-11), driven by fire17:

flowchart LR
    A["tami repo<br/><i>logo.png 1000px raster</i>"] --> B["identify shape:<br/><i>tesseract Petrie projection</i>"]
    B --> C["tesseract.py<br/><i>~50 lines, stdlib</i>"]
    C --> D["8 SVG masters<br/>+ 4K renders"]
    C --> E["index.html playground<br/><i>zero deps</i>"]
    E --> F["GitHub Pages<br/><i>live app</i>"]
    style A fill:#1a1030,stroke:#e8b84a,color:#f5d67b
    style C fill:#1a1030,stroke:#e8b84a,color:#f5d67b
    style F fill:#1a1030,stroke:#e8b84a,color:#f5d67b
Loading
Tool Role
Python 3 stdlib (math, itertools) all geometry — no other libraries
rsvg-convert SVG → 4K PNG rasters
vanilla HTML/JS/SVG the playground — no framework, no build step
Claude Code (Fable 5) wrote the generator, app, and this page

Defects the process caught along the way — kept here because honesty reads better than polish:

  • First "inverted" pass used literal RGB negation on the gray-era renders — mid-gray inverts to nearly the same mid-gray, so the result barely changed. Superseded by regenerating pure black/white from vector.
  • The original raster couldn't be sharpened by upscaling (soft shadows baked in at 1000px) — that failure is why the math reconstruction exists.

🛡️ Safety & undo

Install footprint none — clone and open; the app is one HTML file
Generator writes SVG files into the current directory only
Uninstall delete the folder

⭐ If the geometry stopped you

This repo's whole thesis is that a mark built from a theorem beats a mark built from pixels. If a logo that is literally a 4-dimensional object earns a place in your head, a star tells the algorithm the math was worth it.

Star History Chart

🔗 Kin

📄 License

MIT © fire17


16 vertices. 32 edges. One theorem, any resolution.

About

The tami tesseract mark rebuilt from pure 4D math — parametric SVG generator + zero-dep playground (live on Pages)

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors