Knowledge Stack

uv tool install kscli
kscli login --api-key sk-user-...

pip install ksapi

npm install @knowledge-stack/ksapi

uv tool install ks-mcp

kscli documents ingest --file report.pdf --path-part-id <folder-path-part-id>
kscli chunks search --query "key findings" --limit 5

from ksapi import KSApi

ks = KSApi(api_key="sk-user-...")
ks.documents.ingest(file=open("report.pdf", "rb"), parent_path_part_id="...")
hits = ks.chunks.search(query="key findings", top_k=5)
for h in hits:
    print(f"[{h.score:.2f}] {h.content[:120]}")

import { KSApi } from "@knowledge-stack/ksapi";

const ks = new KSApi({ apiKey: "sk-user-..." });
await ks.documents.ingest({
  file: fs.createReadStream("report.pdf"),
  parentPathPartId: "...",
});
const hits = await ks.chunks.search({ query: "key findings", topK: 5 });
hits.forEach((h) => console.log(`[${h.score.toFixed(2)}] ${h.content.slice(0, 120)}`));

curl -X POST https://api.knowledgestack.ai/v1/documents/ingest \
  -H "Authorization: Bearer sk-user-..." \
  -F "file=@report.pdf" \
  -F "parent_path_part_id=<folder-path-part-id>"

curl -X POST https://api.knowledgestack.ai/v1/chunks/search \
  -H "Authorization: Bearer sk-user-..." \
  -H "Content-Type: application/json" \
  -d '{"query": "key findings", "top_k": 5}'