eSlider/2dph

Fork 0

Files

T

eSliderandGitHub af2db630c8

Tests / Test (push) Failing after 5s

Details

Tests / Release (semver) (push) Skipped

Details

docs: portable runbook and Diataxis index (#27 )

Public face is a product, not a laptop tool. Run steps live in
docs/runbook.md; decisions D3/D6/D14/D15/D17/D18 stay in the docs index.

2026-08-13 23:31:41 +01:00

2.2 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 Compose profile index (Python Ladybug rebuild) until brain/add is v2. The operator command is bin/brain/index.go.

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.

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.2 KiB Raw Blame History