@unispec-ai/sdk

The official TypeScript SDK for the Unispec platform — memory & retrieval for AI agents. One account, four products:

• Memory — long-term memory: add, semantic search, manage.
• Vector Database — indexes + vector/ANN search, integrated embedding.
• Knowledge — upload docs, get grounded answers with citations.
• Agents — Knowledge-grounded assistants with rules and HTTP tools.

Renamed from @libra-memory/sdk (never published under that name). This package no longer ships the libra bin — the CLI now lives in @unispec-ai/cli (bin unispec), which mounts this SDK's product command groups (unispec memory …, unispec vector …, unispec kb …, unispec agents …).

Install

npm install @unispec-ai/sdk

Quickstart

import { createMemoryClient } from "@unispec-ai/sdk";

const memory = createMemoryClient({ apiKey: process.env.UNISPEC_API_KEY });

await memory.add("My favorite color is teal.", { userId: "u_123" });
const hits = await memory.search("what color do I like?", { userId: "u_123" });

Each product has its own client:

import {
  createIndexClient,
  createKnowledgeClient,
  createAgentClient,
} from "@unispec-ai/sdk";

const vectors = createIndexClient({ apiKey: process.env.UNISPEC_API_KEY });
const knowledge = createKnowledgeClient({ apiKey: process.env.UNISPEC_API_KEY });
const agents = createAgentClient({ apiKey: process.env.UNISPEC_API_KEY });

All clients authenticate with a Unispec API key (lb-sk_…), created in the console or supplied via the UNISPEC_API_KEY environment variable.

Environment variables

• UNISPEC_API_KEY — API key (canonical).
• UNISPEC_BASE_URL — platform base URL (defaults to https://unispec.ai).

The legacy LIBRA_API_KEY / LIBRA_BASE_URL names are still honored as deprecated fallbacks for one release cycle — migrate to the UNISPEC_* names.

CLI

The CLI ships in @unispec-ai/cli:

npm install -g @unispec-ai/cli

unispec login --api-key lb-sk_xxx      # store credentials
unispec memory add "remember this"     # Memory
unispec vector list                    # Vector Database
unispec kb upload docs ./faq.pdf       # Knowledge
unispec agents chat my-agent "hello"   # Agents

Run unispec <group> --help for details. Add --json (or --agent) after the group name for machine-readable output suitable for scripts and LLM agents, e.g. unispec memory --agent search "preferences".

Documentation

Full guides, SDK reference, and API reference: https://docs.unispec.ai

License

Apache-2.0. This package began as a fork of the Apache-2.0 mem0 Node CLI and has since been retargeted and substantially rewritten for the Unispec platform. See LICENSE and NOTICE.