Skip to content
Divinci-AIPublic

About

Official TypeScript SDKs, CLI, MCP server and docs for Divinci AI — the @divinci-ai/* npm packages. Docs: sdk.divinci.ai

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Divinci AI SDK

Official SDKs for integrating Divinci AI into your applications

TypeScript License

Packages

Package Description npm
@divinci-ai/cli Official CLI for managing workspaces, chat, RAG, and releases npm
@divinci-ai/client Browser SDK for headless chat integration npm
@divinci-ai/server Node.js SDK for full platform access npm
@divinci-ai/mcp MCP protocol SDK for AI assistants npm
@divinci-ai/types Shared TypeScript type definitions npm
@divinci-ai/embed-chat-ui Framework-agnostic embeddable chat widget for a Divinci Release npm
@divinci-ai/extension-bridge Talk to the Divinci Local Inference browser extension, with cloud fallback npm
@divinci-ai/robot-avatar The Divinci robot mascot as a react-three-fiber component npm
@divinci-ai/trustbench-verifier Verify signed TrustBench benchmark run manifests (browser, Node, Workers, Deno) npm

Also here: the documentation site behind sdk.divinci.ai, examples, and the divinci agent skill.

Quick Start

Browser Chat (Client SDK)

import { DivinciClient } from "@divinci-ai/client";

const client = new DivinciClient({
  releaseId: "rel_your-release-id",
  apiKey: "divinci_key_...",
});

// Simple message
const response = await client.chat.send("What is machine learning?");
console.log(response.content);

// Streaming
for await (const chunk of client.chat.stream("Tell me a story")) {
  process.stdout.write(chunk.content);
}

Server-Side Operations (Server SDK)

import { DivinciServer } from "@divinci-ai/server";

const divinci = new DivinciServer({
  apiKey: process.env.DIVINCI_API_KEY,
});

// Manage workspaces
const workspace = await divinci.workspaces.create({
  name: "My AI Assistant",
});

// Upload documents to RAG
await divinci.rag.uploadDocument({
  workspaceId: workspace._id,
  ragVectorId: "rag_xyz",
  file: fs.createReadStream("./knowledge.pdf"),
});

// Create and publish a release
const release = await divinci.releases.create({
  workspaceId: workspace._id,
  name: "Support Bot v1",
  systemPrompt: "You are a helpful assistant...",
});

MCP Integration (MCP SDK)

import { McpClient } from "@divinci-ai/mcp";

const client = new McpClient({
  serverUrl: "https://mcp.divinci.app",
  apiKey: "divinci_key_...",
});

await client.connect();

// List available tools
const tools = await client.listTools();

// Call a tool
const result = await client.callTool("search_knowledge", {
  query: "return policy",
});

Which SDK Do I Need?

Use Case SDK Example
Terminal chat & management @divinci-ai/cli divinci chat, divinci rag search
Chat widget in browser @divinci-ai/client React app, Vue app
Custom chat UI @divinci-ai/client Headless chat integration
Backend API integration @divinci-ai/server Express, Fastify, NestJS
RAG document management @divinci-ai/server Document upload, search
Workspace administration @divinci-ai/server Create workspaces, releases
Claude Desktop integration @divinci-ai/mcp MCP tool access
Cursor AI integration @divinci-ai/mcp MCP tool access
x402 payment handling @divinci-ai/mcp or @divinci-ai/server Premium tool payments

SDK Comparison

Feature CLI Client Server MCP
Environment Terminal Browser Node.js Both
Chat Messages Yes Yes - Yes
Streaming Yes Yes Yes -
Workspace Management Yes - Yes -
Release Management Yes - Yes -
RAG Operations Yes - Yes Yes
API Key Management - - Yes -
x402 Payments - - Yes Yes
Auth0 PKCE - Yes - Yes
MCP Protocol - - - Yes
Raw API Access Yes - Yes -

Installation

# CLI (global install)
npm install -g @divinci-ai/cli

# Browser SDK
npm install @divinci-ai/client

# Server SDK
npm install @divinci-ai/server

# MCP SDK
npm install @divinci-ai/mcp

Authentication

API Key (Recommended for Server)

const divinci = new DivinciServer({
  apiKey: process.env.DIVINCI_API_KEY,
});

API Key + External User (Embed)

const client = new DivinciClient({
  releaseId: "rel_abc123",
  apiKey: "divinci_key_...",
  externalUser: {
    id: "user_123",
    email: "user@example.com",
    tier: "premium",
  },
});

JWT Token (Browser with Backend)

const client = new DivinciClient({
  releaseId: "rel_abc123",
  getToken: async () => {
    const res = await fetch("/api/divinci-token");
    return res.json().token;
  },
});

Development

Prerequisites

  • Node.js >= 18.0.0
  • pnpm >= 8.0.0

Setup

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

Project Structure

├── packages/            # the nine @divinci-ai/* npm packages
├── docs/                # sdk.divinci.ai (Astro + Starlight)
├── examples/            # runnable examples
├── skills/divinci/      # agent skill for Claude Code and other agents
├── templates/           # starter templates
└── tests/integration/   # contract tests against a live API (needs credentials)

Documentation

Full documentation available at sdk.divinci.ai

Examples

More code samples live in the documentation.

Related

Contributing

Issues and pull requests are welcome here. This repository is published from Divinci's internal monorepo: a maintainer applies an accepted pull request there, and the next sync brings it back here with your authorship credited. See CONTRIBUTING.md.

License

MIT - see LICENSE for details.

About

Official TypeScript SDKs, CLI, MCP server and docs for Divinci AI — the @divinci-ai/* npm packages. Docs: sdk.divinci.ai

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages