Installation

Core SDK

Python

pip install novyx

Requirements: Python 3.9+

The Python SDK includes the CLI — after installing, you can use both from novyx import Novyx and the novyx command in your terminal.

Async support

For async/await with httpx:

pip install novyx[async]

from novyx import AsyncNovyx

nx = AsyncNovyx(api_key="nram_your_key")
await nx.remember("User prefers dark mode")
results = await nx.recall("user preferences")

AsyncNovyx has full parity with the sync client — every method is available as an async variant.

TypeScript

npm install novyx

Requirements: Node.js 18+ or any modern browser

import { Novyx } from "novyx";
const nx = new Novyx({ apiKey: "nram_your_key" });

Zero dependencies. Full TypeScript types included. Dual CJS/ESM — works everywhere. 50+ methods with full API parity (eval methods coming soon).

Framework integrations

LangChain

pip install novyx-langchain

from novyx_langchain import NovyxMemory
from langchain.chains import ConversationChain
from langchain_openai import ChatOpenAI

memory = NovyxMemory(api_key="nram_your_key", session_id="user-123")
chain = ConversationChain(llm=ChatOpenAI(), memory=memory)

CrewAI

pip install novyx-crewai

from novyx_crewai import NovyxStorage
from crewai import Crew

storage = NovyxStorage(api_key="nram_your_key", memory_type="short_term")
crew = Crew(agents=[...], tasks=[...], memory=True, storage=storage)

LlamaIndex

pip install novyx-llamaindex

from novyx_llamaindex import NovyxChatStore
from llama_index.core.memory import ChatMemoryBuffer

chat_store = NovyxChatStore(api_key="nram_your_key")
memory = ChatMemoryBuffer.from_defaults(
    chat_store=chat_store,
    chat_store_key="user-123",
    token_limit=3000,
)

MCP Server

For Cursor, Claude Code, Claude Desktop, or any MCP-compatible client:

pip install novyx-mcp

No API key needed

novyx-mcp runs locally with SQLite — just install and go. Memories are stored in ~/.novyx/local.db. Add a Novyx API key later to sync to the cloud.

Claude Code

claude mcp add novyx-memory -- uvx novyx-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "novyx-memory": {
      "command": "uvx",
      "args": ["novyx-mcp"]
    }
  }
}

Claude Desktop

Add to your MCP config:

{
  "mcpServers": {
    "novyx-memory": {
      "command": "uvx",
      "args": ["novyx-mcp"]
    }
  }
}

Verify installation

Python

from novyx import Novyx
nx = Novyx(api_key="nram_your_key")
print(nx.usage())  # Shows your plan, limits, and current usage

TypeScript

import { Novyx } from "novyx";
const nx = new Novyx({ apiKey: "nram_your_key" });
console.log(await nx.usage());

curl

curl https://novyx-ram-api.fly.dev/v1/usage \
  -H "Authorization: Bearer nram_your_key"

All packages

Package	Install	Description
novyx	pip install novyx	Python SDK + CLI (78 methods)
novyx[async]	pip install novyx[async]	Async client with httpx
novyx (npm)	npm install novyx	TypeScript/JavaScript SDK
novyx-mcp	pip install novyx-mcp	MCP server (23 tools)
novyx-langchain	pip install novyx-langchain	LangChain memory backend
novyx-crewai	pip install novyx-crewai	CrewAI storage backend
novyx-llamaindex	pip install novyx-llamaindex	LlamaIndex chat store