-
Notifications
You must be signed in to change notification settings - Fork 74
Particles
Dimitri Glazkov edited this page May 31, 2025
·
47 revisions
Particles is a UI toolkit designed to answer the following question: "Now that LLMs can generate UI code, what's the right way to do this"? The word "right" is load bearing here and contains various intuitions and practices that guide the overall design -- aka "the Opinion".
The following assertions comprise the guiding principles of the toolkit design:
-
Sandbox the LLM -- Code that is generated by LLMs will have to be sandboxed to run safely. More specifically and as applies to the UI, code that drives UI:
- must be able to do so asynchronously (though with minimal latency) from the code that renders UI;
- must not be able to operate directly on the UI.
- Separate rendering from semantics -- The oldie-but-goodie from HTML, but now with feeling. Code that renders UI must have control in how UI is presented. Code that drives UI must be able to provide the semantics of what it's trying to convey, but not the exact rendering.
- Prefer concrete use cases -- use the concrete use cases from implementations (like the Breadboard project) to inform priorities and overall shape of design. Theoretical explorations are great, but practical problems are better.
Because the sandbox is the key design constraint, it figures prominently in the overall approach. Very loosely speaking, Particles splits the typical MVC setup into two layers:
- The Model + Controller, which is located inside of the sandbox
- The View, which is located outside of the sandbox.
Additionally, there's a Transport layer that handles the shuttling of the particles between the Model+Controller and the View layers.
flowchart BT
u["UI code"]
v["View"]
t["Transport"]
mc["Model + Controller"]
l["LLM-generated code"]
l -- "Calls to produce particles" --> mc
mc -- "Uses to send particles" --> t
t -- "Provides received particles" --> v
v -- "Presents signal-backed structure for rendering" --> u