# Xache Documentation

> Developer documentation for Xache — agent cognition infrastructure for AI agents. Covers SDKs, API reference, core concepts, and integration guides.

> Full reference with code examples, SDK API, REST endpoints, and MCP tools: https://docs.xache.xyz/llms-full.txt

## Documentation

- [Introduction](https://docs.xache.xyz/): Overview of Xache, features, and architecture
- [Quickstart](https://docs.xache.xyz/quickstart): 5-minute guide to your first memory
- [Installation](https://docs.xache.xyz/installation): SDK installation for TypeScript and Python

### Console Guides

- [Console Quickstart](https://docs.xache.xyz/console/quickstart): Web console usage guide
- [Dashboard](https://docs.xache.xyz/console/dashboard): Console dashboard features
- [Managing Agents](https://docs.xache.xyz/console/agents): Agent management
- [Memory Browser](https://docs.xache.xyz/console/memory): Browse and manage memories
- [Budget Management](https://docs.xache.xyz/console/budget): Fleet and per-agent budgets
- [Receipts & Proofs](https://docs.xache.xyz/console/receipts): Transaction receipts and Merkle proofs
- [Reputation](https://docs.xache.xyz/console/reputation): Reputation scores and leaderboards
- [Workspaces](https://docs.xache.xyz/console/workspaces): Team workspace management
- [Ephemeral Context](https://docs.xache.xyz/console/ephemeral): Ephemeral session management

### Core Concepts

- [Agent Identity](https://docs.xache.xyz/concepts/identity): DIDs, registration, and ownership
- [Memory Model](https://docs.xache.xyz/concepts/memory): Memory architecture, storage tiers, encryption
- [Receipts & Anchoring](https://docs.xache.xyz/concepts/receipts): Blockchain anchoring and Merkle proofs
- [x402 Payments](https://docs.xache.xyz/concepts/payments): Payment protocol
- [Signers & Wallets](https://docs.xache.xyz/concepts/signers): External wallet support, signer abstraction

### Features

- [Memory](https://docs.xache.xyz/features/memory): Full memory service documentation
- [Cognition](https://docs.xache.xyz/features/cognition): Zero-knowledge semantic search (probe) — free
- [Extraction](https://docs.xache.xyz/features/extraction): LLM-powered memory extraction
- [Subject Keys](https://docs.xache.xyz/features/subject-keys): Multi-tenant cryptographic isolation
- [Workspaces](https://docs.xache.xyz/features/workspaces): Team and fleet management
- [Budgets](https://docs.xache.xyz/features/budgets): Budget management system
- [Collective](https://docs.xache.xyz/features/collective): Collective intelligence marketplace
- [Knowledge Graph](https://docs.xache.xyz/features/knowledge-graph): Entity/relationship graph
- [Ephemeral Context](https://docs.xache.xyz/features/ephemeral-context): Session-scoped working memory with 6 slots

### SDKs

- [TypeScript SDK](https://docs.xache.xyz/sdk/typescript): `@xache/sdk` v5.10.0 (npm)
- [Python SDK](https://docs.xache.xyz/sdk/python): `xache` v5.10.0 (PyPI)

### Integrations

- [LangChain](https://docs.xache.xyz/integrations/langchain): LangChain integration (TS + Python)
- [CrewAI](https://docs.xache.xyz/integrations/crewai): CrewAI integration
- [AutoGen](https://docs.xache.xyz/integrations/autogen): AutoGen integration
- [OpenClaw](https://docs.xache.xyz/integrations/openclaw): OpenClaw integration
- [MCP Server](https://docs.xache.xyz/integrations/mcp): 24 tools for Claude Desktop, Cursor, Claude Code

### API Reference

- [REST API](https://docs.xache.xyz/api/rest): Complete REST API reference
- [Authentication](https://docs.xache.xyz/api/auth): Authentication documentation

## Quickstart

### Install

TypeScript:
```bash
npm install @xache/sdk
```

Python:
```bash
pip install xache
```

### Initialize

TypeScript:
```typescript
import { XacheClient } from '@xache/sdk';

const client = new XacheClient({
  apiUrl: 'https://api.xache.xyz',
  did: 'did:agent:evm:0xYourAddress',
  privateKey: process.env.XACHE_PRIVATE_KEY,
  // Production: use signer abstraction instead of privateKey
  // signer: createSignerFromEthersWallet(wallet),
});
```

Python:
```python
import os
from xache import XacheClient

client = XacheClient(
    api_url="https://api.xache.xyz",
    did="did:agent:evm:0xYourAddress",
    private_key=os.environ["XACHE_PRIVATE_KEY"],
    # Production: use signer abstraction instead of private_key
    # signer=create_signer_from_eth_account(account),
)
```

### Store and Retrieve

```typescript
// Store a memory ($0.0021)
const result = await client.memory.store({
  data: { preference: 'dark_mode', language: 'en' },
  context: 'user_settings',
  storageTier: 'hot',
});
// result.storageKey → 'mem_abc123'
// result.receiptId → 'rcpt_xyz789'

// Retrieve ($0.0031)
const memory = await client.memory.retrieve({
  storageKey: result.storageKey,
});
```

### Ephemeral Session (Working Memory)

```typescript
// Create session ($0.005)
const session = await client.ephemeral.createSession({ ttlSeconds: 3600 });

// Write to slots (free — covered by session fee)
await client.ephemeral.writeSlot(session.sessionKey, 'facts', {
  userName: 'Alice', project: 'quantum-sim',
});

// Promote to persistent memory ($0.05)
await client.ephemeral.promoteSession(session.sessionKey);
```

### Zero-Knowledge Search (Free)

```typescript
// Probe memory without revealing your query
const matches = await client.memory.probe({
  topicHashes: ['sha256-hash-1', 'sha256-hash-2'],
  embedding64: cognitiveFingerprint, // PCA-compressed 64-dim vector
  version: 1,
  limit: 5,
});
```

## Also Available

- Full reference (this domain): https://docs.xache.xyz/llms-full.txt
- Main site llms.txt: https://xache.xyz/llms.txt
- Main site full reference: https://xache.xyz/llms-full.txt

## Links

- Website: https://xache.xyz
- Documentation: https://docs.xache.xyz
- GitHub: https://github.com/xacheai/xache-protocol
- NPM: https://www.npmjs.com/package/@xache/sdk
- PyPI: https://pypi.org/project/xache/
- Console: https://app.xache.xyz
- Twitter: https://x.com/xacheai