whatisgithub

What is parralax?

forgedemir/parralax — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 4/5Setup · moderate

In one sentence

Parallax uses a camera and a vision AI model to verify that real-world work, like a packed box or finished repair, actually matches what a business system claims happened.

Mindmap

mindmap
  root((Parallax))
    What it does
      Verifies physical reality
      Holds or releases work
      Generates repair directives
    Tech stack
      TypeScript
      React
      Express
      Vision AI
    Use cases
      Warehouse pack verification
      Field service closeout checks
      Custom photo-based QA
    Audience
      Developers
      Ops teams

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

Verify a packed shipment matches its required contents before it ships.

USE CASE 2

Confirm a field technician actually installed a required safety part before closing a job.

USE CASE 3

Build a custom photo-based verification check for any workflow without writing code.

USE CASE 4

Keep a tamper evident audit trail of every verification decision made.

What is it built with?

TypeScriptReactExpressMCP

How does it compare?

forgedemir/parralax0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity4/53/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Runs with no API key in demo mode, but live vision requires a Hugging Face or NVIDIA NIM API key.

No license information is stated in the README.

So what is it?

Parallax is a hackathon project that tries to solve a specific trust problem in AI automation: business software can record that a task was completed, but nothing checks whether the physical world actually matches that record. Parallax is described as a verification layer that uses a camera to confirm reality before an automated process is allowed to continue. The project works alongside a separate AI orchestrator called Hermes Agent, which decides what steps to take next in a workflow. Parallax itself does not make those decisions. Instead, a photo is taken of the real world situation, such as a packed shipping box or a finished repair job, and a vision AI model reads out what it actually sees in that photo. That observation is then checked against a fixed set of rules written in regular code, not by another AI vote, to decide whether the work is genuinely complete. If something is missing or wrong, the system holds the process and generates a specific list of what needs fixing. Once corrected evidence is provided, it checks again. Two example scenarios are given in the README: a warehouse packing station that verifies a box contains the right mug, cable, and warranty card before it ships, and a repair technician job that checks a safety seal and label were actually installed before the visit is marked closed. The project also supports defining a brand new custom scenario just by uploading reference photos, without writing any extra code. Every decision the system makes is recorded to a tamper evident, hash chained log so it can later be independently verified. The project is built with TypeScript, React, and Express, and can run entirely in a local demo mode using saved sample data with no external API key needed, or connect to a real vision model through Hugging Face or NVIDIA's cloud service for live use.

Copy-paste prompts

Prompt 1
Run Parallax locally in fixture replay mode and walk me through the demo scenarios.
Prompt 2
Explain how Parallax decides between HELD and RELEASED for a piece of evidence.
Prompt 3
Show me how to connect Parallax to a real vision model using Hugging Face or NVIDIA NIM.
Prompt 4
How would I define a brand new custom verification scenario using my own reference photos?

Frequently asked questions

What is parralax?

Parallax uses a camera and a vision AI model to verify that real-world work, like a packed box or finished repair, actually matches what a business system claims happened.

What language is parralax written in?

Mainly TypeScript. The stack also includes TypeScript, React, Express.

What license does parralax use?

No license information is stated in the README.

How hard is parralax to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is parralax for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.