okami.mom/albedo

git clone https://git.nkp.pet/okami.mom/albedo

nekomimi.pettui: one delimiter table for math, bytes.Cut over hand scans, and the fork's IndentWriter for list itemse4c3bd6

main
20 files

files

README.md4.3 KiB
active_output_benchmark.py10.6 KiB
albedo_live_coding.erl331 B
albedo_openai_bench.erl1.9 KiB
albedo_openai_rate_bench.erl4.9 KiB
benchmark.gleam3.8 KiB
coding.gleam6.8 KiB
copy_probe.gleam1.8 KiB
glinter-all.toml954 B
glinter-review.toml1.1 KiB
inspect_daemon.py2.8 KiB
json_roundtrip_bench.py7.2 KiB
kernel_memory_benchmark.py9.4 KiB
mock_openai_server.py13.1 KiB
nix_package_smoke.py2.2 KiB
remote_ssh.py2.0 KiB
stream_benchmark.gleam13.1 KiB
stream_rate_benchmark.gleam6.2 KiB
tui_shot.py6.6 KiB
verify_intervals.py2.9 KiB

Manual checks

These tools are opt-in. The full test gate excludes them because they require credentials, a real SSH host, an installed package, or benchmark artifacts. Run commands from the repository root inside nix develop.

ToolInvocation and prerequisitesResult
TUI screenshotsALBEDO_SHOT_DIR=/tmp/shots go -C cli test ./internal/tui -run TestShot, then python3 test/manual/tui_shot.py /tmp/shotsNeeds rsvg-convert. Draws each TestShot* screen (what the real View() emits, in a catppuccin terminal's colors) as a PNG beside its .ans, to look at before and after a layout change. Add a screen by calling shot(t, name, view) from a test after shotTerminal(t).
Packaged binarypython3 test/manual/nix_package_smoke.py /absolute/path/to/bin/albedoChecks the installed client and daemon outside the checkout with a restricted PATH. Fails on an invalid package.
Remote kernelpython3 test/manual/remote_ssh.py user@hostRequires key authentication and remote Python 3.11 or newer. Exercises staging, kernel boot, tool calls, and connection reuse.
Kernel memorypython3 test/manual/kernel_memory_benchmark.py --scale 1 10 --output /tmp/kernel-memory.jsonMeasures boot and workload memory. Writes measurements for comparison, rather than imposing a universal memory threshold.
Active outputpython3 test/manual/active_output_benchmark.py --baseline /tmp/baseline/albedo-daemon --candidate /tmp/candidate/albedo-daemon --output /tmp/active-output-results.jsonRequires two exported daemon builds and Linux /proc for memory measurements. Compares attachment and hydration performance using a gated local provider.
Interval implementationpython3 test/manual/verify_intervals.py /directory/containing/interval_set.pyRuns five unittest scenarios, including randomized interval algebra. Exits unsuccessfully when the candidate violates the contract.
Provider benchmarkgleam run -m manual/benchmarkRequires ALBEDO_BENCH_URL, ALBEDO_BENCH_MODEL, and ALBEDO_BENCH_KEY. Optional ALBEDO_BENCH_PROTOCOL selects a protocol. Prints request timings and memory measurements.
Stream benchmarkgleam run -m manual/stream_benchmarkOffline. Frames and reduces synthetic Responses and Chat Completions streams and encodes a 1 MB request, printing time per run and throughput. Compare before and after a change to openai_api.
Stream rate benchmarkpython3 test/manual/mock_openai_server.py in one terminal, then ERL_FLAGS="<vm_defaults from priv/bin/albedo-daemon>" gleam run -m manual/stream_rate_benchmarkLocal. Streams Responses, Chat Completions, Claude, Vertex, and Cloud Code Assist through the real transport from a mock server at 500 tokens/s and unthrottled, or ALBEDO_BENCH_PARALLEL streams at once, and prints VM CPU, reductions, and send-to-callback latency per token. ALBEDO_BENCH_TOOLS streams a share of the deltas as tool-call arguments. For https, start the mock with a certificate and key and set ALBEDO_BENCH_ORIGIN=https://localhost:PORT and ALBEDO_BENCH_CA to the issuing CA.
Copy probegleam run -m manual/copy_probeOffline. Boots a runtime and one default session and prints what a spawn over the runtime handle, the installed list, the session, and each managed plugin copies, in KiB. Compare before and after moving a catalog between processes.
Live codinggleam run -m manual/codingRequires the benchmark URL, model, and key, plus ALBEDO_LIVE_WORKSPACE and ALBEDO_LIVE_DATABASE. Optional ALBEDO_LIVE_PROTOCOL selects a protocol. Runs a real model-driven coding scenario.

albedo_openai_bench.erl supports the provider benchmark and live coding tool, and albedo_openai_rate_bench.erl the stream rate benchmark. albedo_live_coding.erl supports the live coding tool. They are native helpers, not independent suites.

The glinter-review.toml and glinter-all.toml files configure advisory lint profiles. Run test/gleam-lint.sh --review or test/gleam-lint.sh --all. See the lint documentation for interpretation.

Do not bulk-import these scripts as a smoke check. Some consume command-line arguments or execute immediately on import. Ruff and ty cover their source in the normal gate; exercise their documented commands when changing them.