Install

Install Bilinc, run start, get to quicktest without reading a manual.

The first path is CLI-led: install, start, create a Cloud key, connect once, then run quicktest. Use CloudClient or MCP after the hosted commit and recall smoke is green.

Bilinc 2.1.3bilinc start
Agent bridgeMCP config
Trial7 days
RuntimePython 3.10+
1

Install and start

Install the package, then let the CLI show the shortest path from download to hosted memory.

pip install -U bilinc
bilinc start
2

Create a Cloud account

Start the 7-day trial, confirm email, and create one hosted key in the dashboard.

https://bilinc.space/signup
3

Connect the CLI

Save the key locally so status, commit, recall, and quicktest work without repeated shell setup.

bilinc login --api-key bil_live_...
bilinc quicktest
4

Attach MCP when ready

Print the hosted Cloud MCP config after the CLI smoke is green.

bilinc mcp install
Agent prompt

Give this to the agent after creating a Cloud key.

You are working with Bilinc Cloud as the hosted memory/state plane.

Use the API key only as a bearer token. Never print, log, commit, or expose it.

Base URL: https://bilinc.space

When durable agent memory matters:
1. Commit important state with POST /api/cloud/memory/commit.
2. Recall prior state with POST /api/cloud/memory/recall.
3. Keep keys stable and namespaced, for example agent.goal, user.preference, project.status.
4. Use semantic memory for durable facts, episodic memory for run outcomes, and procedural memory for reusable workflows.
5. If an operation fails, treat the write as not durable until the API returns success.

Required headers:
Authorization: Bearer <BILINC_API_KEY>
Content-Type: application/json
Next steps

Pick the path that matches the work.

CLI path
pip install -U bilinc
bilinc start
bilinc login --api-key bil_live_...
bilinc quicktest

bilinc commit --key USER_PREF --value '{"theme":"dark"}'
bilinc recall --query "user preference"
bilinc status
Raw API path
curl https://bilinc.space/api/cloud/memory/commit \
  -H "Authorization: Bearer $BILINC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "agent.memory.bootstrap",
    "value": {
      "goal": "keep durable state between runs",
      "owner": "agent-runtime"
    },
    "memoryType": "semantic",
    "importance": 0.8,
    "metadata": { "source": "cloud-quickstart" }
  }'

curl https://bilinc.space/api/cloud/memory/recall \
  -H "Authorization: Bearer $BILINC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "durable state between runs",
    "profile": "balanced",
    "limit": 5
  }'