morpho

KO | EN

gitlite — search

#python #hacktoberfest #golang #android #machine-learning #rust #deep-learning #linux #nodejs #cli #kubernetes #pytorch #security #mcp

(★ 184)

No description available.

File Explorer

Download Latest Version (.zip)

- - brent_kung_adder_32x32x1_layout.svg
  - chain_20x20_layout.svg
  - grid_10x15_layout.svg
  - grid_skip_16x16_layout.svg
  - medusa_36x8_layout.svg
  - right_shifter_32x5x1_layout.svg
  - ring_20_layout.svg
  - ripple_adder_32x32x1_layout.svg
  - tree_10x15_layout.svg
  - triangle_32_layout.svg
  - triangle_32_layout_bfs.svg
  - triangle_32_layout_largest.svg
  - tube_10x15_layout.svg
  - wallace_multiplier_16x16_layout.svg
- brent_kung_adder_32x32x1_layout.json
- chain_20x20_layout.json
- grid_10x15_layout.json
- grid_skip_16x16_layout.json
- medusa_36x8_layout.json
- right_shifter_32x5x1_layout.json
- right_shifter_32x5x1_mask.json
- ring_20_layout.json
- ripple_adder_32x32x1_layout.json
- ripple_recursion.svg
- tree_10x15_layout.json
- triangle_32_layout.json
- triangle_32_layout_bfs.json
- triangle_32_layout_largest.json
- tube_10x15_layout.json
- wallace_dependencies.svg
- wallace_multiplier_16x16_layout.json
- wallace_multiplier_16x16_mask_brent_kung_adder.json
- wallace_multiplier_16x16_mask_wallace_rec.json
- wallace_recursion.svg
- code-of-conduct.md
- contributing.md
- - main.c
- build.sh
- main.wasm
- article.js
- bloom.js
- compiler.js
- demo.js
- figures.js
- force_layout.js
- grower.js
- hex_layout.js
- layout_renderer.js
- parser.js
- presets.js
- primitives.js
- swissgl.js
- utils.js
- viewer.js
- bench_compiler.js
- bench_layout.js
- compile_dependencies.mjs
- generate_fallbacks.py
- generate_ripple_svg.py
- test_compiler.js
- test_hex_layout.js
- - LICENSE
  - marked.min.js
- - LICENSE
  - prism-core.min.js
  - prism-python.min.js
  - prism-tomorrow.min.css
.gitignore
AGENTS.md
article.md
demo.html
index.html
LICENSE
README.md
style.css
tiny_morpho.py

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MorphoHDL

**A minimalistic language for growing circuits through structural recursion.**

MorphoHDL is an experimental Hardware Description Language (HDL) and graph rewrite system built around recursive division and rewiring of cell definitions. Inspired by Parametric L-Systems and functional HDLs, MorphoHDL grows physical geometry and logical circuit structures concurrently without hardcoded bus widths.

---

## 🌟 Key Features

* **Recursive & Size-Agnostic**: Cells define rewrite rules where nodes are dynamically replaced by subcells. Bus widths are inferred and split automatically at runtime.
* **High-Performance SoA Engine**: The core compiler (`js/compiler.js`) utilizes a Struct-of-Arrays (SoA) flat memory layout for maximum cache locality and performance.
* **Interactive WebGL Explorer**: Integrated interactive viewer (`demo.html`) powered by SwissGL and Canvas 2D for real-time visualization of circuit growth, force-directed layouts, and signal propagation.
* **Rich Library of Primitives**: Includes classical boolean circuits (parallel prefix adders, multipliers, logarithmic shifters) and biological/cellular automata structures.

---

## 🚀 Getting Started

MorphoHDL runs natively in the browser with no build steps required.

### 1. Launching Locally
Start any local HTTP server from the repository root:
```bash
python3 -m http.server 8000
```

### 2. Interactive Environments
* **Interactive Explorer (`demo.html`)**: Open `http://localhost:8000/demo.html` to experiment with live circuit growth, parameter controls, and layout visualization.
* **Interactive Article (`index.html`)**: Open `http://localhost:8000/index.html` to read the interactive documentation and walk through classical boolean circuit examples.

---

## 💻 Example Usage

MorphoHDL uses a clean, dataflow-style Python syntax where bus sizes are inferred dynamically:

```python
# Define building blocks using Lookup Tables (LUTs)
Xor3 = LUT(3, 0b1001_0110)
Maj3 = LUT(3, 0b1110_1000)

# Base case (1-bit full adder)
@morpho
def full_adder(a, b, c_in):   
    sum = Xor3(a, b, c_in)
    c_out = Maj3(a, b, c_in)
    return sum, c_out

# Recursive N-bit ripple adder with 1-bit fallback
@morpho(fallback=full_adder)
def ripple_adder(a, b, c):
    a0, a1 = SPLIT(a)
    b0, b1 = SPLIT(b)
    s0, c_mid = ripple_adder(a0, b0, c)
    s1, c_out = ripple_adder(a1, b1, c_mid)
    sum = CAT(s0, s1)
    return sum, c_out
```

---

## 📁 Repository Structure

* `tiny_morpho.py`: Standalone Python reference implementation of MorphoHDL with simulation, compilation, and verification tests.
* `demo.html` / `index.html`: Web-based interactive explorer and interactive article.
* `js/`: Core browser runtime and engine:
  * `compiler.js`: Flat SoA compiler and width inference engine.
  * `viewer.js` & `layout_renderer.js`: Interactive WebGL/Canvas circuit visualizer.
  * `force_layout.js` & `hex_layout.js`: Physics and grid-based circuit layout engines.
* `graphs_engine/`: High-performance C/WASM graph layout backend.
* `scratch/`: Experimental scripts, layout benchmarks, and verification tools.

---

## 📜 License

Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.

---

## Disclaimer

This is not an officially supported Google product. This project is not
eligible for the [Google Open Source Software Vulnerability Rewards
Program](https://bughunters.google.com/open-source-security).

morpho

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

morpho

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README