Tools

Awareness SDK

Name: Awareness SDK
Rating: 3.5 (1 reviews)
Author: edwin-hao-ai

By edwin-hao-ai ⭐ 1 stars 👁 61 views ▲ 0 votes

Official SDKs & plugins for Awareness Memory Cloud — persistent, cross-session memory for AI agents. Python, TypeScript, MCP, Claude Code, OpenClaw, Cursor, Windsurf. Drop-in memory layer for LangChain, CrewAI, AutoGen & more.

Homepage GitHub

Install

npm install @awareness-sdk/memory-cloud

README

# Awareness SDK

Official SDKs and plugins for [Awareness Memory Cloud](https://awareness.market) — persistent, cross-session memory for AI agents.

## SDKs

### Python SDK

```bash
pip install awareness-memory-cloud
```

```python
from memory_cloud import MemoryCloudClient

client = MemoryCloudClient(
    base_url="https://awareness.market/api/v1",
    api_key="aw_your-api-key",
)

session = client.begin_memory_session(
    memory_id="your-memory-id",
    source="python-sdk",
)
session.add_event(role="user", content="Hello!")
session.add_event(role="assistant", content="Hi there!")
session.flush()
```

[Full documentation](python/README.md) | [PyPI](https://pypi.org/project/awareness-memory-cloud/)

### TypeScript SDK

```bash
npm install @awareness-sdk/memory-cloud
```

```typescript
import { MemoryCloudClient } from "@awareness-sdk/memory-cloud";

const client = new MemoryCloudClient({
  baseUrl: "https://awareness.market/api/v1",
  apiKey: "aw_your-api-key",
});

const session = client.beginMemorySession({
  memoryId: "your-memory-id",
  source: "typescript-sdk",
});
session.addEvent({ role: "user", content: "Hello!" });
session.addEvent({ role: "assistant", content: "Hi!" });
await session.flush();
```

[Full documentation](typescript/README.md) | [npm](https://www.npmjs.com/package/@awareness-sdk/memory-cloud)

## Plugins

### Claude Code Plugin

Persistent cross-session memory for Claude Code.

```bash
claude plugin install -l ./claudecode
```

Skills: `/awareness-memory:session-start`, `/awareness-memory:recall`, `/awareness-memory:save`, `/awareness-memory:done`

[Full documentation](claudecode/README.md)

### OpenClaw Plugin

Memory plugin for [OpenClaw](https://openclaw.ai) agents.

```bash
openclaw plugins install @awareness-sdk/openclaw-memory
```

[Full documentation](openclaw/README.md) | [npm](https://www.npmjs.com/package/@awareness-sdk/openclaw-memory)

## Environment Variables

All SDKs and plugins share the same environment variable naming:

| Variable | Description | Default |
|----------|-------------|---------|
| `AWARENESS_API_BASE_URL` | API endpoint | `https://awareness.market/api/v1` |
| `AWARENESS_MCP_URL` | MCP endpoint | `https://awareness.market/mcp` |
| `AWARENESS_API_KEY` | API key (`aw_...`) | — |
| `AWARENESS_MEMORY_ID` | Memory ID | — |
| `AWARENESS_AGENT_ROLE` | Agent role filter | — |

## Contributing

Contributions are welcome! Please open an issue or pull request on [GitHub](https://github.com/edwin-hao-ai/Awareness).

## License

Apache 2.0

tools