Cloud quickstart

Connect an agent to hosted memory.

Create a Cloud account, issue a workspace-scoped API key, and make your first commit and recall calls without exposing secrets.

Install pathPyPI package
RuntimeHosted Bilinc Cloud
InterfacePython + CLI + MCP
AccessBILINC_API_KEY
Account

Start from a confirmed Cloud account.

Sign up with your work email, confirm the address, then open the Cloud console. Public signup starts a 7-day Cloud trial; paid plans are managed from the authenticated billing console.

First run path

Six steps from signup to first memory.

1. Start 7-day Cloud trial

Create a public Bilinc Cloud account at /signup.

2. Confirm email

Use the confirmation link, then return to the Cloud dashboard.

3. Create workspace/API key

Bootstrap a workspace and issue one hosted key per runtime.

4. pip install bilinc

Install the cloud-only Python SDK, CLI, and MCP adapter.

5. Set BILINC_API_KEY

Store the key in your server, CI, or agent runtime secret manager.

6. Run commit and recall

Write one durable memory, then recall it through the hosted API.

API key

Issue one key per runtime or environment.

Create

Open API keys, name the key after the runtime, and copy the value while it is shown once.

Store

Save it as BILINC_API_KEY in your server or agent environment. Do not put it in browser code.

Rotate

Revoke old keys when an agent, CI job, or workspace boundary changes.

Observe

Usage, billing, and audit events are visible in the Cloud console.

Commit

Write one durable memory.

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" }
  }'
Recall

Read the state back through a recall profile.

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
  }'
Agent handoff

Give this prompt to your coding agent.

Paste this into Codex, Claude Code, Cursor, or another trusted agent runtime after you have stored the API key in that runtime's secret manager.

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