What changed in v2.0?
Bilinc v1.x exposed local runtime internals through the public package. Bilinc 2.0 keeps the public install path thin: Python SDK, CLI, and MCP adapter. Durable memory operations run through hosted Bilinc Cloud with a workspace-scoped API key.
Migration checklist
Install v2
Upgrade the public package with pip install -U bilinc==2.0.0.
Create Cloud access
Start the 7-day hosted trial, confirm email, and create a hosted API key.
Set runtime key
Export BILINC_API_KEY in the agent runtime, CI job, or MCP environment.
Replace imports
Use from bilinc import CloudClient instead of local StatePlane imports.
Move writes
Commit, recall, and status now call hosted Bilinc Cloud endpoints.
Update MCP
Point agent config at python -m bilinc.cloud_mcp.
Common substitutions
StatePlane()
CloudClient(api_key=os.environ["BILINC_API_KEY"])
plane.commit_sync(...)
client.commit(key, value, memory_type="semantic")
plane.recall(...)
client.recall(query, limit=5)
python -m bilinc.mcp_server.server_v2
python -m bilinc.cloud_mcp
Minimal v2 SDK path
import os
from bilinc import CloudClient
client = CloudClient(api_key=os.environ["BILINC_API_KEY"])
client.commit("agent.memory", {"status": "active"}, memory_type="semantic")
results = client.recall("agent status", limit=5)
print(results)