Walleye docs

Connect

Connecting is the stock LanceDB client. There is no Walleye adapter, no plugin, and nothing to install past lancedb itself.

import lancedb

db = lancedb.connect(
    "db://walleye",
    api_key=TOKEN,
    host_override="http://127.0.0.1:8080",
    region="us-east-1",
)
const db = await lancedb.connect({
  uri: "db://walleye",
  apiKey: TOKEN,
  hostOverride: "http://127.0.0.1:8080",
  region: "us-east-1",
});

The client picks its transport from the URI scheme: db:// is a remote database and anything else is a local directory. So the node’s address goes in host_override (hostOverride in JavaScript), never in the URI. The name after db:// is a label the client wants and the node ignores — one node is one database.

The token. Self-hosted, it is WALLEYE_TOKEN, or the one the node generated and printed to standard error at startup. On the managed service it is the instance token, shown once when the instance is created and once each time it is rotated. Either way the client sends it as x-api-key; Authorization: Bearer works too if you are calling the HTTP surface directly.

region. The client requires it and the node ignores it. It is part of the client’s own default addressing, which a host override replaces, so any value will do.

Next: your first table.