eSlider/2dph

Fork 0

Files

T

eSliderandGitHub 9d1a3f3c70

Tests / Test (push) Failing after 4s

Details

Tests / Release (semver) (push) Skipped

Details

feat: write leafs incrementally without rebuilding the graph. (#29 )

Ladybug 0.19 stays FTS/HNSW queryable on MERGE of new ids; DROP INDEX
was the fatal path. bin/brain/add.go and POST /ingest land facts+info
in one transaction so watch/mail/git can become leafs now (Gitea #14).

2026-08-14 10:46:59 +01:00

2.4 KiB

Raw Blame History

type, status, related

type

status

howto

current

docs/README.md

PLAN.md

Run 2dph (portable)

No laptop-absolute paths. Config lives in env files under $HOME/.config/brain/ (mode 0600), not in git.

Toolchain

Go (see go.mod)
Python 3.12 + uv
Optional: Docker, Zig CGO via bin/cgo/zig (not gcc)

uv venv .venv
uv pip install -r requirements.lock.txt
eval "$(bin/cgo/zig env)"   # when compiling Ladybug read tools
go test ./...
uv run python -m unittest discover -s bin/tools -t .

Config

File / env	Purpose
`$BRAIN_SEARCH_ENV` (default `$HOME/.config/brain/search.env`)	`BRAIN_SEARCH_URL` (SearXNG). Optional Basic Auth.
`$HOME/.config/brain/db-profiles.yml`	read-only Postgres profiles (OnlyOffice via tunnel)

If the host already runs SearXNG, point BRAIN_SEARCH_URL at it. Do not start a second copy (D3). Optional Compose instance:

SEARXNG_SECRET=$(openssl rand -hex 32) docker compose --profile searxng up -d

That binds 127.0.0.1:8888. JSON format must stay enabled.

Index then search

Write path is bin/brain/add.go for a leaf (or POST /ingest). Bulk corpus rebuild remains bin/brain/index.go --rebuild (Compose profile index). Do not DROP INDEX on Ladybug 0.19.

bin/brain/add.go --text "arc-1 runs Matrix" --root facts --source "compose.yml x docker ps"
bin/brain/index.go --rebuild
bin/brain/search.go "LadybugDB vector index"     # facts → info → web (D17)
bin/brain/search.go "upstream flag" --no-web
bin/brain/get.go <id> --body
bin/brain/stats.go

--hop is not implemented. Empty web results are throttled, not absence. Gap to v1: roadmap / epic #16.

Ladybug 0.19: never DROP INDEX FTS/VECTOR (ghost catalog). Fresh indexes = delete var/kb.lbug then --rebuild.

HTTP / MCP

docker compose up -d brain                       # :8630 Zig CGO serve
docker compose --profile index run --rm index    # rebuild
docker compose --profile picoclaw up brain-mcp   # MCP 127.0.0.1:8630

GET /openapi.json, POST /mcp. Agent tool order: search → get → audit.

Reasoner (optional, D18)

CPU sidecar on 127.0.0.1:11435. Weights are not in the 2dph image.

docker compose --profile reasoner up -d reasoner
REASONER_BASE_URL=http://127.0.0.1:11435/v1 ./bin/reasoner/bakeoff.go --json

See reasoner.md.

2.4 KiB Raw Blame History