explaingit

weizhishu123/jelly-computer

Analysis updated 2026-07-26

1PythonAudience · researcherComplexity · 4/5LicenseSetup · easy

TLDR

An open-source design toolkit for building a computer that runs on light instead of electricity. It includes simulators and a tiny operating system to model optical computing circuits before they are physically built.

Mindmap

mindmap
  root((repo))
    What it does
      Replaces electronics with light
      Simulates optical circuits
      Generates laser instructions
    Tech stack
      Python
      NumPy
      PyTorch
    Use cases
      Simulate a photonic CPU
      Run a tiny optical OS
      3D carve a crystal
    Audience
      Optical computing researchers
      Physics hobbyists
      Experimental hardware hackers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Simulate how a light-based CPU performs basic arithmetic like addition.

USE CASE 2

Generate laser instructions to physically carve optical circuits into a crystal.

USE CASE 3

Test a tiny operating system that manages memory and schedules processes for an optical chip.

USE CASE 4

Experiment with a neural network compiler designed for photonic hardware.

What is it built with?

PythonNumPyPyTorch

How does it compare?

weizhishu123/jelly-computer0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity4/54/54/5
Audienceresearcherdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Python 3.7 and the NumPy library, with PyTorch as an optional dependency for neural network features.

Use this code freely for any purpose, including commercial projects, as long as you include the original copyright notice.

In plain English

This repository is an experimental computing project that replaces traditional electronic transistors with light-based optical circuits. Instead of electrons flowing through silicon chips, it uses laser pulses traveling through channels carved inside a transparent crystal called lithium niobate. The physical shape of those channels, specifically a Y-shaped branching pattern, encodes basic arithmetic operations like addition, subtraction, multiplication, and division. The repository contains a full vertical stack of software, from physics simulation up to a small operating system. At the bottom is a physics simulator that models how light behaves in these Y-shaped waveguides. Above that, a code generator produces instructions for a femtosecond laser, the machine that would physically carve the channels into the crystal. On top of that sit two CPU simulators, a 5-chip version and a 7-chip version, each with 17 instructions including arithmetic, memory operations, jumps, and interrupts. At the highest level, a micro operating system provides memory management, process scheduling, a file system, eight system calls, and an interactive shell. The project is currently a simulation and design toolkit. No physical jelly computer has been built yet. The README explicitly invites someone to manufacture the first physical optical gate using the generated laser instructions and demonstrate that 3 plus 5 equals 8. The first person to do so would be recognized as the builder of the first photonic jelly computer. To run the software, a user needs Python 3.7 or newer and the NumPy library. An optional dependency on PyTorch is mentioned for a neural network compiler. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Using the jelly-computer repository, write a Python script that simulates the optical Y-splitter and shows how it calculates 3 plus 5.
Prompt 2
Help me set up and run the 5-chip CPU simulator from jelly-computer, and explain how to use its 17 instructions to add two numbers.
Prompt 3
Show me how to use the jelly-computer code generator to produce laser instructions for carving an optical arithmetic gate into a crystal.
Prompt 4
Walk me through starting the micro operating system shell from jelly-computer and running a basic program with its system calls.

Frequently asked questions

What is jelly-computer?

An open-source design toolkit for building a computer that runs on light instead of electricity. It includes simulators and a tiny operating system to model optical computing circuits before they are physically built.

What language is jelly-computer written in?

Mainly Python. The stack also includes Python, NumPy, PyTorch.

What license does jelly-computer use?

Use this code freely for any purpose, including commercial projects, as long as you include the original copyright notice.

How hard is jelly-computer to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is jelly-computer for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.