Skip to content

Albert v0.2.1

Latest

Choose a tag to compare

@GrumpyChubbyCat GrumpyChubbyCat released this 27 Sep 19:19
· 3 commits to main since this release
c7c0816

Albert can now connect to your own kaeru memory over MCP. Keep memory embedded
as before, or let a separate kaeru server hold it while Albert recalls, learns and
reflects through the same memory tools.


Bring your own memory

  • HTTP or stdio. Connect to a kaeru MCP endpoint over Streamable HTTP, or use
    the local kaeru-mcp --stdio bridge.
  • Token authentication. A protected endpoint takes a bearer token from an
    environment variable; the config stores only its name.
  • Ready on first startup. If the connected memory has no albert initiative,
    Albert creates it through an ordinary memory record. Later starts leave an
    existing initiative unchanged.
  • One memory interface. Recall, capture and automatic reflection use the
    selected backend. MCP memory is a dedicated connection, separate from the
    world-facing connector catalog.

Connection failures stay visible

  • Connection and tool calls have time limits. A disconnected session is
    re-established on the next call.
  • A failed write is not automatically replayed: it may already have reached the
    server. Albert does not silently switch to an empty local memory when MCP fails.

Upgrading from v0.2.0

Embedded memory remains the default. To use a kaeru MCP server:

[memory]
backend = "mcp"
transport = "http"
url = "http://127.0.0.1:9876/mcp"
token_env = "ALBERT_MEMORY_TOKEN" # omit for an endpoint without authentication
timeout_secs = 30

Set ALBERT_MEMORY_TOKEN in the environment or .env to match the server's token,
then restart Albert. Use HTTPS for a remote endpoint. Switching backends does not
copy existing memories; configure cloud endpoints on the MCP server when using
external memory.

Use kaeru-mcp 0.7.4 or later. If you maintain a custom system.md, update the
old tool names: kaeru_remember → kaeru_episode, kaeru_read → kaeru_at,
kaeru_test → kaeru_evidence, and follow their current argument schemas.

Full configuration, including stdio:
memory backend.

Built on Octo v0.2.0, kaeru v0.7.4 and rig 0.35.

Early and in active testing — feedback and issues are very welcome.


Binary

albert-v0.2.1-x86_64-linux-gnu — a release build for x86_64 Linux with glibc 2.39
or newer (e.g. Ubuntu 24.04). It links the system libcurl.so.4, OpenSSL 3 and
libstdc++. Long recordings and videos also need ffmpeg. Deployment:
docs/deploy.md.

SHA-256:

330adbd2955a03be5559cc298b00e34497b74f6f0a917161eef6cbe9056ba839  albert-v0.2.1-x86_64-linux-gnu

Verify: sha256sum -c albert-v0.2.1-x86_64-linux-gnu.sha256