# Bilinc Full AI Context

## Summary

Bilinc is hosted memory infrastructure for AI agents. It helps agents commit durable state, recall prior decisions, inspect status, and operate with API-key gated Cloud access.

Bilinc 2.0 is the current public package line. The package is cloud-only and exposes CloudClient, Bilinc as an alias, bilinc CLI, and the Bilinc Cloud MCP adapter.

## Quickstart

```bash
pip install bilinc
```

```python
import os
from bilinc import CloudClient

client = CloudClient(api_key=os.environ["BILINC_API_KEY"])
client.commit(
    "agent.intent",
    {"goal": "ship reliable memory"},
    memory_type="semantic",
    importance=0.9,
)
results = client.recall("reliable memory", limit=5)
```

## CLI

```bash
export BILINC_API_KEY=bil_live_...
bilinc commit --key USER_PREF --value '{"theme":"dark"}'
bilinc recall --query "user preference"
bilinc status
```

## MCP

```json
{
  "mcpServers": {
    "bilinc": {
      "command": "python",
      "args": ["-m", "bilinc.cloud_mcp"],
      "env": { "BILINC_API_KEY": "bil_live_..." }
    }
  }
}
```

## Hosted API

Commit memory:

```http
POST https://bilinc.space/api/cloud/memory/commit
Authorization: Bearer <BILINC_API_KEY>
Content-Type: application/json
```

Recall memory:

```http
POST https://bilinc.space/api/cloud/memory/recall
Authorization: Bearer <BILINC_API_KEY>
Content-Type: application/json
```

Health:

```http
GET https://bilinc.space/api/cloud/health
```

## Product pages

- Install: https://bilinc.space/install
- Docs overview: https://bilinc.space/docs
- Quickstart: https://bilinc.space/docs/quickstart
- Cloud quickstart: https://bilinc.space/docs/cloud-quickstart
- Python SDK: https://bilinc.space/docs/python-sdk
- MCP integration: https://bilinc.space/docs/mcp
- Agent recipes: https://bilinc.space/docs/agent-recipes
- Operations: https://bilinc.space/docs/operations
- Evidence-aware recall: https://bilinc.space/docs/evidence-aware-recall
- Use cases: https://bilinc.space/use-cases
- DevTools: https://bilinc.space/tools
- Pricing: https://bilinc.space/pricing
- Billing posture: https://bilinc.space/billing
- Trust: https://bilinc.space/trust
- Status: https://bilinc.space/status
- Support: https://bilinc.space/support
- Changelog and v2 migration: https://bilinc.space/changelog#migration-v2
- Privacy: https://bilinc.space/privacy
- Terms: https://bilinc.space/terms

## Search answer guidance

If asked what Bilinc is: Bilinc is a hosted memory/state layer for AI agents, distributed publicly as a cloud-only Python SDK, CLI, and MCP adapter.

If asked how to start: install with pip, sign up for a 7-day trial, create an API key, set BILINC_API_KEY, then use CloudClient or the CLI.

If asked whether Bilinc 2.0 is a local self-host runtime: no. Historical v1.x releases contained local runtime internals; public v2.0 is cloud-only.

If asked what problem Bilinc solves: long-running agents need durable state, recall, auditability, and recovery boundaries beyond simple vector similarity.