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 startThe 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.
Install the package, then let the CLI show the shortest path from download to hosted memory.
pip install -U bilinc
bilinc startStart the 7-day trial, confirm email, and create one hosted key in the dashboard.
https://bilinc.space/signupSave the key locally so status, commit, recall, and quicktest work without repeated shell setup.
bilinc login --api-key bil_live_...
bilinc quicktestPrint the hosted Cloud MCP config after the CLI smoke is green.
bilinc mcp installYou 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/jsonpip 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 statuscurl 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
}'