Miscible

Miscible is a smart (and personal) photo gallery. It aims to provide image gallery features provided by (Web based) applications like Google Photos, Windows Photos, etc, while keeping everything running locally (and smoothly).

Miscible running on Windows 10

Caution

Miscible is still very much under development. Many of the (even basic) features can cause crashes.

Features

• Automatic directory scanning
• Image thumbnail atlas generation for fast preview load
• Automatic image embedding creation

Building

Currently there are only ways to build and no installation method on any OS.

Requirements

• git

• cmake

• gcc or msvc (on Windows)

• python3 + python3-requests (maybe in a virtual environment)

• Clone the repo

git clone --recursive https://github.com/mdhvg/miscible
cd miscible

• Run the setup script

python3 ./scripts/setup.py

• Run the build script

Linux

bash ./scripts/build.sh

Windows

.\scripts\build.ps1

Usage

Binary is built in the ./build directory and can be ran from there.

Setup script doesn't automatically download the CLIP model, so it can be manually downloaded from Hugging Face🤗 and placed at (project root)/CLIP-ViT-B-32-laion2B-s34B-b79K.gguf.

Usage Options

Normal run

./build/Miscible

Skip embeddings

./build/Miscible --no-embed

Credits

Although there are many things that need refactoring to follow the style (#TODO), the code style and build procedure in this software is heavily inspired by @Casey Muratori's Handmade Hero series (YouTube).

A lot of core code snippets come from EpicGamesExt/raddebugger.

Other sources which were referenced

• src/base/arena.* from Enter The Arena: Simplifying Memory Management (2023) by @Ryan Fleury.
• src/base/arena.* also from tsoding/arena by @tsoding.
• src/base/string.*, src/base/array.h from Vjekoslav Krajačić – File Pilot: Inside the Engine – BSC 2025 at @BSC 2025 talk by @Vjekoslav Krajačić.