Quick Start

Build your first AI-powered application with Orka JS inunder 5 minutes.

Import Methods

Standard Import

import { createOrka, OpenAIAdapter, MemoryVectorAdapter } from 'orkajs';

Optimized Import

Recommended

import { createOrka } from '@orka-js/core';
import { OpenAIAdapter } from '@orka-js/openai';
import { MemoryVectorAdapter } from '@orka-js/memory';

Enables tree-shaking for minimal bundle size in production.

Create the Orka instance

const orka = createOrka({
  llm: new OpenAIAdapter({ apiKey: process.env.OPENAI_API_KEY! }),
  vectorDB: new MemoryVectorAdapter(),
});

Index your documents

await orka.knowledge.create({
  name: 'company-docs',
  source: [
    "Orka JS is a TypeScript framework for building LLM applications.",
    "It supports OpenAI, Anthropic, Mistral, and Ollama as LLM providers.",
    "Vector databases supported include Pinecone, Qdrant, Chroma, and in-memory.",
  ],
});

Ask a question

const result = await orka.ask({
  knowledge: 'company-docs',
  question: "What LLM providers does Orka AI support?",
  includeContext: true,
});
 
console.log(result.answer);
// → "Orka AI supports OpenAI, Anthropic, Mistral, and Ollama."
 
console.log(`Latency: ${result.latencyMs}ms`);
console.log(`Tokens: ${result.usage.totalTokens}`);

Complete Example

complete-example.ts

// Standard import (full package)
import { createOrka, OpenAIAdapter, MemoryVectorAdapter } from 'orkajs';
 
// OR Selective import (smaller bundles)
// import { createOrka } from '@orka-js/core';
// import { OpenAIAdapter } from '@orka-js/openai';
// import { MemoryVectorAdapter } from '@orka-js/memory';
 
async function main() {
  const orka = createOrka({
    llm: new OpenAIAdapter({ apiKey: process.env.OPENAI_API_KEY! }),
    vectorDB: new MemoryVectorAdapter(),
  });
 
  const { chunkCount } = await orka.knowledge.create({
    name: 'docs',
    source: [
      "Orka JS is a TypeScript framework for building LLM applications.",
      "It supports RAG, agents, workflows, evaluation, and multi-model orchestration.",
    ],
  });
  console.log(`Indexed ${chunkCount} chunks`);
 
  const result = await orka.ask({
    knowledge: 'docs',
    question: "What is Orka JS?",
  });
  console.log(result.answer);
}
 
main().catch(console.error);

npx tsx quick-start.ts

Run example

What's Next?

Knowledge & RAG →Workflows →Agents →