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. If you previously saw CERTIFICATE_VERIFY_FAILED, upgrade to Bilinc 2.1.4 or newer.

Start 7-day Cloud trial Open PyPI MCP setup

Bilinc 2.1.4bilinc start

Agent bridgeMCP config

Trial7 days

TLS fixcertifi-backed

Install

Install the Cloud SDK and CLI into the shell where your agent runs. Version 2.1.4 includes the certifi-backed TLS fix for Python SSL trust-store failures.

pip install -U bilinc

Create a Cloud account

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

https://bilinc.space/signup

Verify with quicktest

Save the key locally, then prove hosted commit and recall before wiring an agent.

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

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.

SDK quickstart Cloud quickstart Agent recipes DevTools Trust posture

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

Environment quicktest

export BILINC_API_KEY=bil_live_...
bilinc quicktest

Python SDK

from bilinc import CloudClient

client = CloudClient()
print(client.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
  }'