Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

wrong-nebula/hypbr

Media & Design

Generate seamless, physically calibrated PBR material sets from procedural code, ready for game engines and 3D tools.

105
6
Python
MIT
1 day old

What hypbr does

hypbr is a Python package that synthesizes seamlessly tileable PBR material sets — 15 maps including albedo, tangent normals, ORM, 16-bit height, curvature, cavity, bent normals and subsurface thickness — at arbitrary resolution without border seams. It combines a procedurally generated catalog (69 hand-tuned flagship generators plus 431 curated parametric materials across masonry, wood, stone, tiles, metals, fabrics, terrain, glass, rubber and roofing/tech) with optional reference-photo calibration against CC0 photogrammetry scans.

The synthesis core uses circular-padded FFT and FBM/Voronoi microstructure generators, feeding a composable 47-node PBR graph with analytic bevels, RNM blending and 8-azimuth HBAO. Materials can be blended with HeightLerp or cavity modes, weathered with physical presets, and exported directly to Unity, Unity HDRP, Godot, Unreal, Blender, Three.js, glTF/GLB, Vulkan, MaterialX and USD. A local Three.js preview and an online browser studio over the 500-material atlas provide inspection. It targets technical artists and graphics developers who need engine-ready PBR sets without sourcing textures manually.

Install and first material

Requirements: Python with pip; the core install needs only numpy and pillow, so all 500 materials, blending, weathering, export and verification run in pure NumPy. PyTorch is optional (.[gpu] for CUDA/MPS kernels, .[neural] for photo-to-PBR).

git clone https://github.com/wrong-nebula/hypbr.git
cd hypbr
pip install -e .

Synthesize a single material at 1024×1024 and inspect the results:

hypbr list
hypbr synth patinated_verdigris_bronze --size 1024 --wear 0.35 --out ./output/pbr
hypbr preview ./output/pbr/patinated_verdigris_bronze

The output directory contains the 15 PNG maps. hypbr preview starts a local interactive studio with channel switching, UV tiling and displacement controls. To export to engines in one command:

hypbr synth patinated_verdigris_bronze --size 1024 --export unity,godot,unreal,blender,threejs,vulkan --out ./output/pbr

For the online atlas, point a browser at the interactive Three.js studio or fetch the machine-readable index and spec cards through the Agent Atlas endpoints, for example llms.txt, atlas.json, and the integration guide.

Reference-photo calibration can be rerun with hypbr atlas calibrate --refs <scan dirs> --baked <uncalibrated bake>; the README does not document the exact expected directory layout of the reference scans, so that step needs additional inspection of the fitter.

Constraints and limits

  • Pure procedural paths are MIT licensed; the optional hypbr photo mode using Apple Depth Pro checkpoints pulls in external weights under Apple's research license. See the license.
  • Reported performance is about 1 s per 512×512 material and 11–13 s at 2048×2048 on CPU (Apple Silicon, 4 threads). Costs increase with resolution; Gaussian blurs are FFT-based, so blur radius does not scale cost.
  • Materials are synthetic and calibrated to reference scans; the README does not claim measured physical accuracy beyond the hypbr.verify checks (seam, normal validity, ORM packing, PBR range).
  • The 500-material atlas is served online with CORS-enabled 512px WebP maps; the Python synthesizer is needed for custom sizes and full 15-map sets.
  • Optional torch kernels are described as bit-identical to the NumPy path; HYPBR_TORCH=0 forces NumPy fallbacks.

HotRepo's take

This is a recent repository with a small but visible early signal: it appeared on the Python new-project board on 2026-11-22, gaining 5 stars over a short window while holding 105 stars and 6 forks. No all-language daily rank or discussion thread is recorded. The interesting technical claim is the combination of exact periodic synthesis (zero reported wrap seams) with an agent-readable material atlas — the spec cards expose tile size in meters, preferred objects, shader wiring and weathering presets, which is more useful to a coding agent than a texture dump. The small sample window means the star curve does not yet show a trend; it is simply early attention around a narrow niche of procedural PBR authoring.

Written by AI from the project's public information and HotRepo's records, updated . The project's own docs are the source of truth.

You might also like

  1. storytold/materialcraftNode-based procedural PBR material designer in pure Rust that runs on desktop and the web.Rust104
  2. alla2001/material-painterA free PBR texture painter for game and film assets, with layer painting, mesh map baking and node-based material design, built in Rust and wgpu.Rust106
  3. dmitrykurash/holospotDrop-in three.js materials for physically accurate holographic foil, glitter and volume holograms, designed to be wired up by an AI agent.TypeScript102
  4. AIRzZ90/study-materials-forkA Tauri 2 desktop app for browsing and playing media, with React UI and hls.js playback.TypeScript113
  5. guzhezao/needleAn interactive 3D vinyl turntable study with draggable records, two speeds and procedural audio.JavaScript109