TricorderKit
Local-first knowledge system for AI agents with measured retrieval, guardrails, and plugins.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 18 known high or critical vulnerabilities (19 findings, one per affected package version) in the packages a fresh install brings (OSV.dev, 3 Nov 2026). Weigh this before you install it.
npm:@grpc/grpc-js 1.14.3@grpc/grpc-js: A malformed request can cause a server crash (GHSA-5375-pq7m-f5r2, high, fixed in 1.14.4)npm:browserslist 4.28.2Browserslist: Uncaught crash / prototype write via untrusted browserslist-stats.json custom stats (normalizeStats) (GHSA-73wf-gq98-2v4g, high, fixed in 4.28.7)
See 8 more
npm:@grpc/grpc-js 1.14.3— GHSA-99f4-grh7-6pcq (high), fixed in 1.14.4npm:@grpc/grpc-js 1.14.3— GHSA-m9gg-hp2v-232j (high), fixed in 1.14.5npm:browserslist 4.28.2— GHSA-c83g-rgw3-j3cx (high), fixed in 4.28.7npm:fast-uri 3.1.2— GHSA-4c8g-83qw-93j6 (high), fixed in 3.1.3npm:fast-uri 3.1.2— GHSA-7p8r-x3mc-p8w7 (high), fixed in 3.1.5npm:fast-uri 3.1.2— GHSA-f65p-4m7j-42xc (high), fixed in 3.1.6npm:fast-uri 3.1.2— GHSA-fph4-wmhf-6fwf (high), fixed in 3.1.6npm:fast-uri 3.1.2— GHSA-jqff-g426-hqxp (high), fixed in 3.1.6
9 more findings not listed here.
Linux x86_64
git clone TricorderKit source (ranked candidate 1)
git clone https://github.com/GeekFamilyCorp/TricorderKit.git
Where the README and reality differ
- README: make gates runs out of the box after git clone
What worked: pip install pyyaml jsonschema first; otherwise check_preflight_contract.py exits 2 with tooling_error missing dependency
Check that it works
python TricorderKit/cli/tk.py --helpThe output should contain “TricorderKit CLI”.
First thing to try
python TricorderKit/cli/tk.py doctorRun python TricorderKit/cli/tk.py doctor from the folder where you cloned the repository to check your setup.
What it does
- Retrieve answers with hybrid vector and graph searchTested
How to use it
- Run
python TricorderKit/experiments/graphrag/graphrag.py --selftestto run the GraphRAG self-test. - Look for the line starting with
[selftest] OK — GraphRAG, which compares graph retrieval against flat retrieval.
- Run
- Run a local second brain for AI agentsNot shown working
- Run autonomous research pipelinesNot shown working
- Coordinate multiple agents safelyNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
Good for
- run autonomous research pipeline on a topic
- retrieve answers with hybrid vector and graph search
- route tasks to cheapest capable model and estimate budget
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version v1.2.0
Differences the test machine hit
- README: python cli/tk.py doctor
In the test: run from repo root (cd TricorderKit) or prefix paths with TricorderKit/ - README: make gates
In the test: make not installed in box; ran underlying scripts directly: python scripts/check_public_boundary.py etc. from repo root