Morphēa

Bitmap-to-vector reconstruction

Reveal the shape within.

Most vectorizers trace pixels. Morphēa reconstructs form, turning bitmap artwork into clean, editable SVG geometry.

Read the plan Run the CLI

Live quality artifacts

Bitmap and exported SVG, same canvas.

PASS

Touching circle and stroke

primitive_contact_pair
Bitmap
touching_circle_stroke_right bitmap
SVG
touching_circle_stroke_right SVG

2 anchors L1 0.0000 edge 0.0000

Stroke crossing rectangle

primitive_contact_pair
Bitmap
stroke_crossing_rectangle_horizontal bitmap
SVG
stroke_crossing_rectangle_horizontal SVG

2 anchors L1 0.0000 edge 0.0000

Pipeline

Geometry first. Learning and refinement where they help.

1

Read the bitmap

Normalize alpha, reduce palette drift, bound analysis size, and keep real images tractable.

2

Recover anchors

Find circles, strokes, rings, rectangles, quads, cut-outs, and regular grids before generic fitting.

3

Build the scene

Write layers, groups, reservations, metrics, and export policy metadata instead of opaque paths.

4

Inspect and improve

Use reports, curated checks, reviewed pseudo-labels, retraining, and structure-preserving refinement.

Current baseline

Designed for artwork that should stay editable.

Primitive anchors

Circles, dots, rings, strokes, arcs, rectangles, rounded rectangles, quads, and perspective grids.

Cut-out semantics

White interior gaps can stay selectable as overlay strokes or become SVG mask candidates.

Bounded local runs

Max size, palette quantization, component deferral, timeout diagnostics, and profile reports.

Research loop

Synthetic data, classifier training, curated checks, review queues, retraining gates, and refinement.

Primitive quality gate

Generated bitmap-to-SVG proof cases.

These panels are generated from passing primitive-check artifacts. Each bitmap and SVG pair uses the same fixed canvas.

Primitive quality gallery: 356 passing cases

Filled Square

PASS
Bitmap
filled_square bitmap
SVG
filled_square SVG

rect · 1 anchor · L1 0.0000 · edge 0.0000

Filled Circle

PASS
Bitmap
filled_circle bitmap
SVG
filled_circle SVG

circle · 1 anchor · L1 0.0000 · edge 0.0000

Horizontal Stroke

PASS
Bitmap
horizontal_stroke bitmap
SVG
horizontal_stroke SVG

stroke_polyline · 1 anchor · L1 0.0000 · edge 0.0000

Outlined Ring

PASS
Bitmap
outlined_ring bitmap
SVG
outlined_ring SVG

stroke_circle · 1 anchor · L1 0.0168 · edge 0.0211

Antialiased Circle

PASS
Bitmap
antialiased_circle bitmap
SVG
antialiased_circle SVG

circle · 1 anchor · L1 0.0052 · edge 0.0073

Square plus circle

PASS
Bitmap
composition_square_plus_circle_a bitmap
SVG
composition_square_plus_circle_a SVG

rect + circle · 2 anchors · L1 0.0000 · edge 0.0000

Touching circle and stroke

PASS
Bitmap
touching_circle_stroke_right bitmap
SVG
touching_circle_stroke_right SVG

primitive_contact_pair · 2 anchors · L1 0.0000 · edge 0.0000

Stroke crossing rectangle

PASS
Bitmap
stroke_crossing_rectangle_horizontal bitmap
SVG
stroke_crossing_rectangle_horizontal SVG

primitive_contact_pair · 2 anchors · L1 0.0000 · edge 0.0000

Ordered overlap

PASS
Bitmap
overlapping_rectangles_bottom_right bitmap
SVG
overlapping_rectangles_bottom_right SVG

primitive_contact_pair · 2 anchors · L1 0.0000 · edge 0.0000

Cut-out stroke

PASS
Bitmap
cutout_horizontal_gap_center bitmap
SVG
cutout_horizontal_gap_center SVG

cutout export · 2 anchors · L1 0.0000 · edge 0.0000

Parallel strokes

PASS
Bitmap
group_parallel_strokes_horizontal bitmap
SVG
group_parallel_strokes_horizontal SVG

parallel_stroke_group · 2 anchors · L1 0.0000 · edge 0.0000

Arc Up

PASS
Bitmap
arc_up bitmap
SVG
arc_up SVG

arc · 1 anchor · L1 0.0088 · edge 0.0125

Curve S

PASS
Bitmap
curve_s bitmap
SVG
curve_s SVG

stroke_path · 1 anchor · L1 0.0176 · edge 0.0233

Ellipse Horizontal

PASS
Bitmap
ellipse_horizontal bitmap
SVG
ellipse_horizontal SVG

ellipse · 1 anchor · L1 0.0123 · edge 0.0148

Cutout Curve Rect

PASS
Bitmap
cutout_curve_rect bitmap
SVG
cutout_curve_rect SVG

cutout export · 2 anchors · L1 0.0023 · edge 0.0036

Organic Blob

PASS
Bitmap
organic_blob bitmap
SVG
organic_blob SVG

cubic_path · 1 anchor · L1 0.0117 · edge 0.0175

Quickstart

Run the current baseline locally.

The legacy curve command remains as an alias, but new scripts should use morphea. 

python -m pip install -e .
python -m unittest discover -s tests
morphea vectorize input.png -o output.svg --color-tolerance 18
morphea curated-check docs/real-images/suite.json -o runs/curated.json --run

Repository docs

The homepage is the front door. The docs hold the machinery.

BrandNaming, positioning, voice, and launch motions PlanSemantic-first direction MilestonesImplemented baselines and roadmap SchemaManifest and report contracts ADRsArchitecture decisions SweepsExperiment comparison workflow

Status

The baseline is implemented; optional adapters stay explicit.

Morphēa runs with a deterministic baseline today. Optional MLX SAM and DiffVG adapters report their configuration state instead of silently becoming requirements.