eSlider
e04b037b33
stdlib flag dropped --hop after the query. One wrapper in internal/cli, source <(./bin/cli/complete.go bash). Gitea #34.
87 lines
2.6 KiB
Markdown
87 lines
2.6 KiB
Markdown
---
|
|
type: howto
|
|
status: current
|
|
related:
|
|
- 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](https://docs.astral.sh/uv)
|
|
- Optional: Docker, Zig CGO via `bin/cgo/zig` (not gcc)
|
|
- Optional: poppler (`pdftotext`/`pdftoppm`) + tesseract `eng+deu` for mail OCR
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
bin/brain/add.go --text "arc-1 runs Matrix" --root facts --source "compose.yml x docker ps"
|
|
bin/brain/index.go --rebuild --with-facts --with-chats
|
|
bin/brain/search.go "LadybugDB vector index" # facts → info → web (D17)
|
|
bin/brain/search.go "upstream flag" --no-web
|
|
source <(./bin/cli/complete.go bash) # D23 flaggy complete
|
|
bin/brain/get.go <id> --body
|
|
bin/brain/stats.go
|
|
```
|
|
|
|
`--hop N` walks File → Commit → Person from each hit. Empty web results are `throttled`, not absence.
|
|
Gap to v1: [roadmap](roadmap.md) / [epic #16](https://git.produktor.io/eSlider/2dph/issues/16).
|
|
|
|
Ladybug 0.19: never `DROP INDEX` FTS/VECTOR (ghost catalog). Fresh indexes =
|
|
delete `var/kb.lbug` then `--rebuild`.
|
|
|
|
## HTTP / MCP
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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](reasoner.md).
|