9e60f73c7f
* chore: add changelog and version updates API: 3.0.12 -> 3.1.0 Python/TS SDK: 2.3.0 -> 2.4.0 CLI: 0.1.3 -> 0.1.3 (updated docs) * docs: add scopes to README architecture and fix changelog prefix --------- Co-authored-by: ajspig <dragon@monstercode.com> |
||
|---|---|---|
| .. | ||
| __tests__ | ||
| examples | ||
| src | ||
| .gitignore | ||
| CHANGELOG.md | ||
| README.md | ||
| biome.json | ||
| bun.lock | ||
| bunfig.toml | ||
| package.json | ||
| tsconfig.json | ||
README.md
Honcho TypeScript SDK
A high-level, ergonomic TypeScript SDK for the Honcho conversational memory platform. Provides a user-friendly API for managing peers, sessions, and conversational context.
Installation
npm install @honcho-ai/sdk
Usage
import { Honcho } from "@honcho-ai/sdk";
const honcho = new Honcho({
apiKey: process.env.HONCHO_API_KEY,
baseURL: "http://localhost:8000",
workspaceId: "test",
});
const assistant = await honcho.peer("bob");
const alice = await honcho.peer("alice");
await honcho.peers();
const session = await honcho.session("session_1");
await session.addPeers([alice, assistant]);
await session.addMessages([
assistant.message("What did you have for breakfast today, alice?"),
alice.message("I had oatmeal."),
]);
const response = await alice.chat("what did alice have for breakfast today?");
console.log(response);
See examples/ for more.
Development
Type checking
bun run typecheck
Testing
Tests for the SDK live in tests/ at the monorepo root and are run via pytest, which orchestrates a test server. Do not run bun test directly.
# From the monorepo root
uv run pytest tests/ -k typescript