SDKs & Integrations

Sulcus is API-first. All SDKs are open-source HTTP clients — they talk to the Sulcus Cloud API or your self-hosted instance.

Quick Start

Node.js / TypeScript

npm install @digitalforgestudios/sulcus

OpenClaw Plugin

openclaw plugin install @digitalforgestudios/openclaw-sulcus

Python

pip install sulcus

REST API

curl -H "Authorization: Bearer $KEY" api.sulcus.ca/api/v1/agent/nodes

Available Now

Python SDK

v2.0.0

Core Python client. Store, search, and manage proactive memories with sync and async support. Zero required dependencies.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=sdks/python"
GitHub →Registry →

Node.js SDK

v2.0.0

Zero-dependency TypeScript/Node client with reactive triggers, mainstay search, and XML context building.

npm install ./sdks/node
GitHub →Registry →

LangChain

v0.1.0

SulcusCallbackHandler and SulcusMemory integration for LangChain with turn-inbound recall and turn-outbound capture.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=integrations/langchain"
GitHub →Registry →

CrewAI

v0.1.0

SulcusCrewHooks and SulcusContextTool for shared proactive memory & context in multi-agent crews.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=integrations/crewai"
GitHub →Registry →

Deep Agents

v0.1.0

Thermodynamic memory middleware for LangChain Deep Agents — replaces flat AGENTS.md with a real memory engine.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=integrations/deepagents"
GitHub →Registry →

Vercel AI SDK

v0.1.0

LanguageModelV3Middleware for automatic memory retrieval and episodic turn capture with wrapLanguageModel.

npm install ./integrations/vercel-ai
GitHub →Registry →

LlamaIndex

v0.1.0

Thermodynamic memory store and query engine integration for LlamaIndex.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=integrations/llamaindex"
GitHub →Registry →

OpenClaw Plugin

v7.2.1

Drop-in memory backend for OpenClaw agents. Auto-recall, auto-capture, heat decay, SIU v2 pipeline integration, and cross-agent sync.

openclaw plugin install @digitalforgestudios/openclaw-sulcus
GitHub →Registry →

Sulcus CLI & Sidecar

v7.3.1

Standalone native client binary and MCP server (stdio / HTTP). Available via GitHub Releases or cargo install --git.

curl -L https://github.com/digitalforgeca/sulcus/releases/download/bin-v7.3.1/sulcus-macos-arm64.tar.gz | tar xz
GitHub →Registry →

REST API

v2.9 server

Direct HTTP API. Works with any language or tool. 87 endpoints, AGE knowledge graph, interaction-based decay, SIU v2 pipeline.

curl -H "Authorization: Bearer $KEY" https://api.sulcus.ca/api/v1/agent/nodes
GitHub →Registry →

Coming Soon

Semantic Kernel

Microsoft Semantic Kernel memory connector

AutoGen

Microsoft AutoGen multi-agent memory backend

Spring AI

Java / Spring Boot AI memory integration

API Reference

All SDKs are thin HTTP clients over the Sulcus REST API. You can also call the API directly:

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.sulcus.ca/api/v1/agent/nodes

See the full documentation for API endpoints, authentication, and configuration.