whatisgithub

What is paiera-evidence-pack-demo?

paieralabs/paiera-evidence-pack-demo — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A sanitized demo of an assistant's food-allergy safety pipeline: structured facts, a deterministic conflict matcher, and a prompt assembler, where no model can write to memory.

Mindmap

mindmap
  root((paiera evidence pack))
    What it does
      Structured facts
      Conflict matcher
      Prompt assembler
    Tech stack
      Node.js
      better-sqlite3
    Use cases
      Test allergy logic
      Study memory design
    Audience
      Developers
      Technical reviewers

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

Test how a deterministic allergy matcher handles confirmed conflicts, unknown cases, and person isolation.

USE CASE 2

Study a pattern for keeping structured facts separate from what a language model can infer or write.

USE CASE 3

Review a sanitized slice of a larger assistant's memory pipeline before evaluating the full system.

What is it built with?

Node.jsJavaScriptbetter-sqlite3

How does it compare?

paieralabs/paiera-evidence-pack-demoabhay-pratapsingh-ctrl/chaptrabhishek-akkal/finova
Stars000
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatehardeasy
Complexity3/55/51/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

Needs a C toolchain installed to compile the better-sqlite3 dependency.

No license has been chosen yet, so no reuse rights are granted.

So what is it?

PAiERA Evidence Pack is a sanitized, reproducible demo that shows one narrow slice of a larger assistant system called PAiERA. It demonstrates a structured fact model for people and their food restrictions, a deterministic matcher that checks whether a food item conflicts with someone's allergy, logic for keeping people's information separate across multiple conversation turns, and a prompt assembler that turns all of this into text ready to send to a language model. The full PAiERA system, including voice, chat routing, the frontend, file uploads, and unrelated database tables, is not included here. The project runs entirely offline. Installing it requires Node.js version 18 or higher and a C compiler to build a small database library called better-sqlite3. No internet connection and no language model call is needed to install, run the demo, or run its automated tests. The demo uses three fictional people: Alice, who owns the account and has a shellfish allergy, her spouse Bob, who has no restrictions, and their child Clara, who has a peanut allergy. Three example requests show how the system behaves. Asking to buy a peanut cake for Clara triggers a confirmed conflict warning. Asking to buy an unspecified cake returns an unknown result rather than guessing it is safe, since a plain cake could still contain peanuts. Asking to buy fish for Clara shows that Alice's own shellfish allergy is never mistakenly applied to Clara. A key design rule is that the underlying model can only read the assembled prompt. It cannot add people, record allergies, or change any stored fact. All such changes happen only through a local seed script that runs before the demo. The matcher currently understands just three allergen categories: peanut, fish, and shellfish. Every other restriction is treated as unknown on purpose, since a broader list could not be checked with certainty. The project only supports English text, and it does not detect requests to cancel or forget a previous action.

Copy-paste prompts

Prompt 1
Walk me through what happens when I run npm run demo in this repo, scenario by scenario.
Prompt 2
Explain how the food_compatibility.js matcher decides between conflict, no_conflict, and unknown.
Prompt 3
Show me how to add a new allergen category to this matcher without breaking the existing three.
Prompt 4
Help me trace how person_safety_facts stays isolated to the correct person in this codebase.

Frequently asked questions

What is paiera-evidence-pack-demo?

A sanitized demo of an assistant's food-allergy safety pipeline: structured facts, a deterministic conflict matcher, and a prompt assembler, where no model can write to memory.

What language is paiera-evidence-pack-demo written in?

Mainly JavaScript. The stack also includes Node.js, JavaScript, better-sqlite3.

What license does paiera-evidence-pack-demo use?

No license has been chosen yet, so no reuse rights are granted.

How hard is paiera-evidence-pack-demo to set up?

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

Who is paiera-evidence-pack-demo for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.