clsplusplus 4.0.0__tar.gz → 4.0.2__tar.gz

{clsplusplus-4.0.0 → clsplusplus-4.0.2}/PKG-INFO

@@ -1,24 +1,33 @@
 Metadata-Version: 2.4
 Name: clsplusplus
-Version: 4.0.0
-Summary: Brain-inspired, model-agnostic persistent memory architecture for LLMs
+Version: 4.0.2
+Summary: Brain-inspired, model-agnostic persistent memory for LLMs. Learn, recall, forget — like a brain. Works with OpenAI, Claude, Gemini, Llama.
 Author-email: AlphaForge AI Labs <contact@alphaforge.ai>
+Maintainer-email: Rajamohan Jabbala <contact@alphaforge.ai>
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/rajamohan1950/CLSplusplus
 Project-URL: Documentation, https://github.com/rajamohan1950/CLSplusplus/wiki
 Project-URL: Repository, https://github.com/rajamohan1950/CLSplusplus
 Project-URL: Bug Tracker, https://github.com/rajamohan1950/CLSplusplus/issues
 Project-URL: Changelog, https://github.com/rajamohan1950/CLSplusplus/releases
-Keywords: llm,memory,ai,cls,continuous-learning,langchain,persistent-memory,model-agnostic
-Classifier: Development Status :: 3 - Alpha
+Project-URL: API Reference, https://github.com/rajamohan1950/CLSplusplus/blob/main/docs/API_DOCUMENTATION.md
+Project-URL: Source Code, https://github.com/rajamohan1950/CLSplusplus/tree/main/src
+Project-URL: Download, https://github.com/rajamohan1950/CLSplusplus/releases
+Keywords: llm,memory,ai,persistent-memory,model-agnostic,brain,openai,anthropic,claude,gemini,langchain,continuous-learning,semantic-search,vector-database,conversational-ai,rag,context-window
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -67,7 +76,9 @@ Dynamic: license-file
 </p>
 
 <p align="center">
-  <a href="https://render.com/deploy?repo=https://github.com/rajamohan1950/CLSplusplus"><img src="https://render.com/images/deploy-to-render-button.svg" alt="Deploy to Render" height="32" /></a>
+  <a href="https://pypi.org/project/clsplusplus/"><img src="https://img.shields.io/pypi/v/clsplusplus?style=flat-square&label=PyPI&color=6366f1" alt="PyPI" /></a>
+  <a href="https://www.npmjs.com/package/clsplusplus"><img src="https://img.shields.io/npm/v/clsplusplus?style=flat-square&label=npm&color=cb3837" alt="npm" /></a>
+  <a href="https://pypi.org/project/clsplusplus/"><img src="https://img.shields.io/pypi/pyversions/clsplusplus?style=flat-square" alt="Python" /></a>
   <a href="https://www.clsplusplus.com/docs"><img src="https://img.shields.io/badge/API-Live-22c55e?style=flat-square" alt="API" /></a>
   <a href="https://github.com/rajamohan1950/CLSplusplus/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License" /></a>
   <a href="https://github.com/rajamohan1950/CLSplusplus"><img src="https://img.shields.io/badge/Patent-Oct%202025-blue?style=flat-square" alt="Patent" /></a>
@@ -95,73 +106,93 @@ Memory is **external** to the model. **Switch models anytime.** No reset.
 
 ## Quick Start
 
-### Option A: SDK Client Only (talk to a running CLS++ server)
+### Install
 
 ```bash
-pip install clsplusplus          # lightweight: only httpx + pydantic
+pip install clsplusplus          # Python (lightweight: only httpx + pydantic)
+npm install clsplusplus          # JavaScript / TypeScript (zero dependencies)
 ```
 
+### Python SDK
+
 ```python
-from clsplusplus import CLS
+from clsplusplus import Brain
 
-client = CLS(base_url="http://localhost:8080", api_key="your_api_key")
-client.write("User prefers dark mode", namespace="user-123")
-results = client.read("user preferences", namespace="user-123")
-for item in results.items:
-    print(item.text, item.confidence)
-```
+brain = Brain("alice")
 
-### Option B: Run the Full Server Locally
+# Teach it anything in natural language
+brain.learn("I work at Google as a senior engineer")
+brain.learn("I prefer Python over JavaScript")
 
-```bash
-# Clone and install with server dependencies
-git clone https://github.com/rajamohan1950/CLSplusplus.git
-cd CLSplusplus
-pip install -e ".[server]"
+# Ask it anything — semantic recall, not keyword matching
+brain.ask("What's my job?")           # ["I work at Google as a senior engineer"]
 
-# Start infrastructure (Redis + PostgreSQL)
-docker compose up -d redis postgres
+# Get LLM-ready context for any prompt
+brain.context("coding help")
+# "Known facts about this user:\n- I work at Google..."
 
-# Start the API server
-uvicorn clsplusplus.api:app --host 0.0.0.0 --port 8080
+# Forget (GDPR right to be forgotten)
+brain.forget("I work at Google as a senior engineer")
 ```
 
-#### Create an API key
+### JavaScript / TypeScript SDK
 
-```bash
-# Register an integration and get your API key
-curl -X POST http://localhost:8080/v1/integrations \
-  -H "Content-Type: application/json" \
-  -d '{"name": "my-app", "namespace": "default"}'
+```typescript
+import { Brain } from "clsplusplus";
+
+const brain = new Brain("alice");
 
-# Response includes your API key (shown only once):
-# {"id": "...", "keys": [{"key": "cls_live_xxxxxxxx", ...}], ...}
+await brain.learn("I work at Google as a senior engineer");
+const facts = await brain.ask("What's my job?");
+const context = await brain.context("coding help");
+await brain.forget("I work at Google as a senior engineer");
 ```
 
-#### Write and read memories
+### Use with OpenAI
 
-```bash
-# Write a memory
-curl -X POST http://localhost:8080/v1/memory/write \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer cls_live_xxxxxxxx" \
-  -d '{"text": "User prefers dark mode", "namespace": "user-123"}'
-
-# Read memories
-curl -X POST http://localhost:8080/v1/memory/read \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer cls_live_xxxxxxxx" \
-  -d '{"query": "user preferences", "namespace": "user-123"}'
+```python
+from clsplusplus import Brain
+
+brain = Brain("alice")
+
+# Wrap any LLM function — auto-injects memory, auto-learns
+@brain.wrap
+def chat(system_prompt, user_message):
+    return openai.chat(system=system_prompt, user=user_message)
+
+response = chat("You are a helpful assistant", "Help me with Python")
+# Brain auto-recalls relevant memory, injects into prompt,
+# calls your LLM, learns from the exchange, returns response.
 ```
 
-#### Python SDK (3-line integration)
+### Full API
 
-```python
-from clsplusplus import CLS
+| Method | Description |
+|--------|-------------|
+| `brain.learn(fact)` | Teach a fact. Returns memory ID. |
+| `brain.ask(question)` | Query for relevant facts. Returns list. |
+| `brain.context(topic)` | Get LLM-ready context string. |
+| `brain.forget(fact)` | Forget by text or ID. |
+| `brain.absorb(text)` | Bulk-learn from document or conversation. |
+| `brain.who()` | Auto-generated user profile. |
+| `brain.correct(old, new)` | Update a belief. |
+| `brain.chat(message, llm)` | Full conversation handler with memory. |
+| `brain.teach(dict)` | Learn from structured data. |
+| `brain.watch(messages)` | Learn from chat message history. |
+| `brain.wrap(fn)` | Wrap any LLM function with auto-memory. |
+
+### Run the Full Server Locally
 
-client = CLS(base_url="http://localhost:8080", api_key="cls_live_xxxxxxxx")
-client.memories.encode(content="User prefers dark mode", agent_id="a1")
-results = client.memories.retrieve(query="user preferences", agent_id="a1")
+```bash
+git clone https://github.com/rajamohan1950/CLSplusplus.git
+cd CLSplusplus
+pip install -e ".[server]"
+
+# Start infrastructure (Redis + PostgreSQL)
+docker compose up -d redis postgres
+
+# Start the API server
+uvicorn clsplusplus.api:create_app --factory --host 0.0.0.0 --port 8080
 ```
 
 ---

{clsplusplus-4.0.0 → clsplusplus-4.0.2}/README.md

@@ -16,7 +16,9 @@
 </p>
 
 <p align="center">
-  <a href="https://render.com/deploy?repo=https://github.com/rajamohan1950/CLSplusplus"><img src="https://render.com/images/deploy-to-render-button.svg" alt="Deploy to Render" height="32" /></a>
+  <a href="https://pypi.org/project/clsplusplus/"><img src="https://img.shields.io/pypi/v/clsplusplus?style=flat-square&label=PyPI&color=6366f1" alt="PyPI" /></a>
+  <a href="https://www.npmjs.com/package/clsplusplus"><img src="https://img.shields.io/npm/v/clsplusplus?style=flat-square&label=npm&color=cb3837" alt="npm" /></a>
+  <a href="https://pypi.org/project/clsplusplus/"><img src="https://img.shields.io/pypi/pyversions/clsplusplus?style=flat-square" alt="Python" /></a>
   <a href="https://www.clsplusplus.com/docs"><img src="https://img.shields.io/badge/API-Live-22c55e?style=flat-square" alt="API" /></a>
   <a href="https://github.com/rajamohan1950/CLSplusplus/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License" /></a>
   <a href="https://github.com/rajamohan1950/CLSplusplus"><img src="https://img.shields.io/badge/Patent-Oct%202025-blue?style=flat-square" alt="Patent" /></a>
@@ -44,73 +46,93 @@ Memory is **external** to the model. **Switch models anytime.** No reset.
 
 ## Quick Start
 
-### Option A: SDK Client Only (talk to a running CLS++ server)
+### Install
 
 ```bash
-pip install clsplusplus          # lightweight: only httpx + pydantic
+pip install clsplusplus          # Python (lightweight: only httpx + pydantic)
+npm install clsplusplus          # JavaScript / TypeScript (zero dependencies)
 ```
 
+### Python SDK
+
 ```python
-from clsplusplus import CLS
+from clsplusplus import Brain
 
-client = CLS(base_url="http://localhost:8080", api_key="your_api_key")
-client.write("User prefers dark mode", namespace="user-123")
-results = client.read("user preferences", namespace="user-123")
-for item in results.items:
-    print(item.text, item.confidence)
-```
+brain = Brain("alice")
 
-### Option B: Run the Full Server Locally
+# Teach it anything in natural language
+brain.learn("I work at Google as a senior engineer")
+brain.learn("I prefer Python over JavaScript")
 
-```bash
-# Clone and install with server dependencies
-git clone https://github.com/rajamohan1950/CLSplusplus.git
-cd CLSplusplus
-pip install -e ".[server]"
+# Ask it anything — semantic recall, not keyword matching
+brain.ask("What's my job?")           # ["I work at Google as a senior engineer"]
 
-# Start infrastructure (Redis + PostgreSQL)
-docker compose up -d redis postgres
+# Get LLM-ready context for any prompt
+brain.context("coding help")
+# "Known facts about this user:\n- I work at Google..."
 
-# Start the API server
-uvicorn clsplusplus.api:app --host 0.0.0.0 --port 8080
+# Forget (GDPR right to be forgotten)
+brain.forget("I work at Google as a senior engineer")
 ```
 
-#### Create an API key
+### JavaScript / TypeScript SDK
 
-```bash
-# Register an integration and get your API key
-curl -X POST http://localhost:8080/v1/integrations \
-  -H "Content-Type: application/json" \
-  -d '{"name": "my-app", "namespace": "default"}'
+```typescript
+import { Brain } from "clsplusplus";
+
+const brain = new Brain("alice");
 
-# Response includes your API key (shown only once):
-# {"id": "...", "keys": [{"key": "cls_live_xxxxxxxx", ...}], ...}
+await brain.learn("I work at Google as a senior engineer");
+const facts = await brain.ask("What's my job?");
+const context = await brain.context("coding help");
+await brain.forget("I work at Google as a senior engineer");
 ```
 
-#### Write and read memories
+### Use with OpenAI
 
-```bash
-# Write a memory
-curl -X POST http://localhost:8080/v1/memory/write \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer cls_live_xxxxxxxx" \
-  -d '{"text": "User prefers dark mode", "namespace": "user-123"}'
-
-# Read memories
-curl -X POST http://localhost:8080/v1/memory/read \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer cls_live_xxxxxxxx" \
-  -d '{"query": "user preferences", "namespace": "user-123"}'
+```python
+from clsplusplus import Brain
+
+brain = Brain("alice")
+
+# Wrap any LLM function — auto-injects memory, auto-learns
+@brain.wrap
+def chat(system_prompt, user_message):
+    return openai.chat(system=system_prompt, user=user_message)
+
+response = chat("You are a helpful assistant", "Help me with Python")
+# Brain auto-recalls relevant memory, injects into prompt,
+# calls your LLM, learns from the exchange, returns response.
 ```
 
-#### Python SDK (3-line integration)
+### Full API
 
-```python
-from clsplusplus import CLS
+| Method | Description |
+|--------|-------------|
+| `brain.learn(fact)` | Teach a fact. Returns memory ID. |
+| `brain.ask(question)` | Query for relevant facts. Returns list. |
+| `brain.context(topic)` | Get LLM-ready context string. |
+| `brain.forget(fact)` | Forget by text or ID. |
+| `brain.absorb(text)` | Bulk-learn from document or conversation. |
+| `brain.who()` | Auto-generated user profile. |
+| `brain.correct(old, new)` | Update a belief. |
+| `brain.chat(message, llm)` | Full conversation handler with memory. |
+| `brain.teach(dict)` | Learn from structured data. |
+| `brain.watch(messages)` | Learn from chat message history. |
+| `brain.wrap(fn)` | Wrap any LLM function with auto-memory. |
+
+### Run the Full Server Locally
 
-client = CLS(base_url="http://localhost:8080", api_key="cls_live_xxxxxxxx")
-client.memories.encode(content="User prefers dark mode", agent_id="a1")
-results = client.memories.retrieve(query="user preferences", agent_id="a1")
+```bash
+git clone https://github.com/rajamohan1950/CLSplusplus.git
+cd CLSplusplus
+pip install -e ".[server]"
+
+# Start infrastructure (Redis + PostgreSQL)
+docker compose up -d redis postgres
+
+# Start the API server
+uvicorn clsplusplus.api:create_app --factory --host 0.0.0.0 --port 8080
 ```
 
 ---

{clsplusplus-4.0.0 → clsplusplus-4.0.2}/pyproject.toml

@@ -4,23 +4,34 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clsplusplus"
-version = "4.0.0"
-description = "Brain-inspired, model-agnostic persistent memory architecture for LLMs"
+version = "4.0.2"
+description = "Brain-inspired, model-agnostic persistent memory for LLMs. Learn, recall, forget — like a brain. Works with OpenAI, Claude, Gemini, Llama."
 readme = "README.md"
 requires-python = ">=3.9"
 license = {text = "Apache-2.0"}
 authors = [{name = "AlphaForge AI Labs", email = "contact@alphaforge.ai"}]
-keywords = ["llm", "memory", "ai", "cls", "continuous-learning", "langchain", "persistent-memory", "model-agnostic"]
+maintainers = [{name = "Rajamohan Jabbala", email = "contact@alphaforge.ai"}]
+keywords = [
+    "llm", "memory", "ai", "persistent-memory", "model-agnostic",
+    "brain", "openai", "anthropic", "claude", "gemini", "langchain",
+    "continuous-learning", "semantic-search", "vector-database",
+    "conversational-ai", "rag", "context-window",
+]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
     "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
     "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
 ]
 
 # SDK-only dependencies — lightweight client (~5 MB install)
@@ -67,6 +78,9 @@ Documentation = "https://github.com/rajamohan1950/CLSplusplus/wiki"
 Repository = "https://github.com/rajamohan1950/CLSplusplus"
 "Bug Tracker" = "https://github.com/rajamohan1950/CLSplusplus/issues"
 Changelog = "https://github.com/rajamohan1950/CLSplusplus/releases"
+"API Reference" = "https://github.com/rajamohan1950/CLSplusplus/blob/main/docs/API_DOCUMENTATION.md"
+"Source Code" = "https://github.com/rajamohan1950/CLSplusplus/tree/main/src"
+"Download" = "https://github.com/rajamohan1950/CLSplusplus/releases"
 
 [tool.setuptools.packages.find]
 where = ["src"]

{clsplusplus-4.0.0 → clsplusplus-4.0.2}/src/clsplusplus.egg-info/PKG-INFO

@@ -1,24 +1,33 @@
 Metadata-Version: 2.4
 Name: clsplusplus
-Version: 4.0.0
-Summary: Brain-inspired, model-agnostic persistent memory architecture for LLMs
+Version: 4.0.2
+Summary: Brain-inspired, model-agnostic persistent memory for LLMs. Learn, recall, forget — like a brain. Works with OpenAI, Claude, Gemini, Llama.
 Author-email: AlphaForge AI Labs <contact@alphaforge.ai>
+Maintainer-email: Rajamohan Jabbala <contact@alphaforge.ai>
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/rajamohan1950/CLSplusplus
 Project-URL: Documentation, https://github.com/rajamohan1950/CLSplusplus/wiki
 Project-URL: Repository, https://github.com/rajamohan1950/CLSplusplus
 Project-URL: Bug Tracker, https://github.com/rajamohan1950/CLSplusplus/issues
 Project-URL: Changelog, https://github.com/rajamohan1950/CLSplusplus/releases
-Keywords: llm,memory,ai,cls,continuous-learning,langchain,persistent-memory,model-agnostic
-Classifier: Development Status :: 3 - Alpha
+Project-URL: API Reference, https://github.com/rajamohan1950/CLSplusplus/blob/main/docs/API_DOCUMENTATION.md
+Project-URL: Source Code, https://github.com/rajamohan1950/CLSplusplus/tree/main/src
+Project-URL: Download, https://github.com/rajamohan1950/CLSplusplus/releases
+Keywords: llm,memory,ai,persistent-memory,model-agnostic,brain,openai,anthropic,claude,gemini,langchain,continuous-learning,semantic-search,vector-database,conversational-ai,rag,context-window
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -67,7 +76,9 @@ Dynamic: license-file
 </p>
 
 <p align="center">
-  <a href="https://render.com/deploy?repo=https://github.com/rajamohan1950/CLSplusplus"><img src="https://render.com/images/deploy-to-render-button.svg" alt="Deploy to Render" height="32" /></a>
+  <a href="https://pypi.org/project/clsplusplus/"><img src="https://img.shields.io/pypi/v/clsplusplus?style=flat-square&label=PyPI&color=6366f1" alt="PyPI" /></a>
+  <a href="https://www.npmjs.com/package/clsplusplus"><img src="https://img.shields.io/npm/v/clsplusplus?style=flat-square&label=npm&color=cb3837" alt="npm" /></a>
+  <a href="https://pypi.org/project/clsplusplus/"><img src="https://img.shields.io/pypi/pyversions/clsplusplus?style=flat-square" alt="Python" /></a>
   <a href="https://www.clsplusplus.com/docs"><img src="https://img.shields.io/badge/API-Live-22c55e?style=flat-square" alt="API" /></a>
   <a href="https://github.com/rajamohan1950/CLSplusplus/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square" alt="License" /></a>
   <a href="https://github.com/rajamohan1950/CLSplusplus"><img src="https://img.shields.io/badge/Patent-Oct%202025-blue?style=flat-square" alt="Patent" /></a>
@@ -95,73 +106,93 @@ Memory is **external** to the model. **Switch models anytime.** No reset.
 
 ## Quick Start
 
-### Option A: SDK Client Only (talk to a running CLS++ server)
+### Install
 
 ```bash
-pip install clsplusplus          # lightweight: only httpx + pydantic
+pip install clsplusplus          # Python (lightweight: only httpx + pydantic)
+npm install clsplusplus          # JavaScript / TypeScript (zero dependencies)
 ```
 
+### Python SDK
+
 ```python
-from clsplusplus import CLS
+from clsplusplus import Brain
 
-client = CLS(base_url="http://localhost:8080", api_key="your_api_key")
-client.write("User prefers dark mode", namespace="user-123")
-results = client.read("user preferences", namespace="user-123")
-for item in results.items:
-    print(item.text, item.confidence)
-```
+brain = Brain("alice")
 
-### Option B: Run the Full Server Locally
+# Teach it anything in natural language
+brain.learn("I work at Google as a senior engineer")
+brain.learn("I prefer Python over JavaScript")
 
-```bash
-# Clone and install with server dependencies
-git clone https://github.com/rajamohan1950/CLSplusplus.git
-cd CLSplusplus
-pip install -e ".[server]"
+# Ask it anything — semantic recall, not keyword matching
+brain.ask("What's my job?")           # ["I work at Google as a senior engineer"]
 
-# Start infrastructure (Redis + PostgreSQL)
-docker compose up -d redis postgres
+# Get LLM-ready context for any prompt
+brain.context("coding help")
+# "Known facts about this user:\n- I work at Google..."
 
-# Start the API server
-uvicorn clsplusplus.api:app --host 0.0.0.0 --port 8080
+# Forget (GDPR right to be forgotten)
+brain.forget("I work at Google as a senior engineer")
 ```
 
-#### Create an API key
+### JavaScript / TypeScript SDK
 
-```bash
-# Register an integration and get your API key
-curl -X POST http://localhost:8080/v1/integrations \
-  -H "Content-Type: application/json" \
-  -d '{"name": "my-app", "namespace": "default"}'
+```typescript
+import { Brain } from "clsplusplus";
+
+const brain = new Brain("alice");
 
-# Response includes your API key (shown only once):
-# {"id": "...", "keys": [{"key": "cls_live_xxxxxxxx", ...}], ...}
+await brain.learn("I work at Google as a senior engineer");
+const facts = await brain.ask("What's my job?");
+const context = await brain.context("coding help");
+await brain.forget("I work at Google as a senior engineer");
 ```
 
-#### Write and read memories
+### Use with OpenAI
 
-```bash
-# Write a memory
-curl -X POST http://localhost:8080/v1/memory/write \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer cls_live_xxxxxxxx" \
-  -d '{"text": "User prefers dark mode", "namespace": "user-123"}'
-
-# Read memories
-curl -X POST http://localhost:8080/v1/memory/read \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer cls_live_xxxxxxxx" \
-  -d '{"query": "user preferences", "namespace": "user-123"}'
+```python
+from clsplusplus import Brain
+
+brain = Brain("alice")
+
+# Wrap any LLM function — auto-injects memory, auto-learns
+@brain.wrap
+def chat(system_prompt, user_message):
+    return openai.chat(system=system_prompt, user=user_message)
+
+response = chat("You are a helpful assistant", "Help me with Python")
+# Brain auto-recalls relevant memory, injects into prompt,
+# calls your LLM, learns from the exchange, returns response.
 ```
 
-#### Python SDK (3-line integration)
+### Full API
 
-```python
-from clsplusplus import CLS
+| Method | Description |
+|--------|-------------|
+| `brain.learn(fact)` | Teach a fact. Returns memory ID. |
+| `brain.ask(question)` | Query for relevant facts. Returns list. |
+| `brain.context(topic)` | Get LLM-ready context string. |
+| `brain.forget(fact)` | Forget by text or ID. |
+| `brain.absorb(text)` | Bulk-learn from document or conversation. |
+| `brain.who()` | Auto-generated user profile. |
+| `brain.correct(old, new)` | Update a belief. |
+| `brain.chat(message, llm)` | Full conversation handler with memory. |
+| `brain.teach(dict)` | Learn from structured data. |
+| `brain.watch(messages)` | Learn from chat message history. |
+| `brain.wrap(fn)` | Wrap any LLM function with auto-memory. |
+
+### Run the Full Server Locally
 
-client = CLS(base_url="http://localhost:8080", api_key="cls_live_xxxxxxxx")
-client.memories.encode(content="User prefers dark mode", agent_id="a1")
-results = client.memories.retrieve(query="user preferences", agent_id="a1")
+```bash
+git clone https://github.com/rajamohan1950/CLSplusplus.git
+cd CLSplusplus
+pip install -e ".[server]"
+
+# Start infrastructure (Redis + PostgreSQL)
+docker compose up -d redis postgres
+
+# Start the API server
+uvicorn clsplusplus.api:create_app --factory --host 0.0.0.0 --port 8080
 ```
 
 ---