> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# TypeScript SDK

> PraisonAI TypeScript SDK - Complete AI Agent Framework

# PraisonAI TypeScript SDK

The PraisonAI TypeScript SDK provides a complete framework for building AI agents, workflows, and applications.

## Installation

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
npm install praisonai
# or
pnpm add praisonai
```

## Quick Start

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Agent, createAgent } from 'praisonai';

// Create a simple agent
const agent = createAgent({
  name: 'Assistant',
  instructions: 'You are a helpful assistant.',
  llm: 'openai/gpt-4o-mini'
});

// Chat with the agent
const response = await agent.chat('Hello!');
console.log(response.text);
```

## Features

### Core Features

* **[Agents](/docs/sdk/typescript/agents)** - Create and manage AI agents
* **[Workflows](/docs/sdk/typescript/workflows)** - Multi-agent orchestration
* **[Tools](/docs/sdk/typescript/tools)** - Extend agent capabilities
* **[Memory](/docs/sdk/typescript/memory)** - Persistent conversation memory
* **[Sessions](/docs/sdk/typescript/sessions)** - Conversation management

### Specialized Agents

* **[AutoAgents](/docs/sdk/typescript/auto-agents)** - Auto-generate agents from topics
* **[ImageAgent](/docs/sdk/typescript/image-agent)** - Image generation and analysis
* **[DeepResearchAgent](/docs/sdk/typescript/research-agent)** - Comprehensive research
* **[QueryRewriterAgent](/docs/sdk/typescript/query-rewriter)** - Query optimization
* **[PromptExpanderAgent](/docs/sdk/typescript/prompt-expander)** - Prompt enhancement
* **[RouterAgent](/docs/sdk/typescript/router-agent)** - Request routing
* **[ContextAgent](/docs/sdk/typescript/context-agent)** - Context management

### Advanced Features

* **[Handoff](/docs/sdk/typescript/handoff)** - Agent-to-agent handoff
* **[Guardrails](/docs/sdk/typescript/guardrails)** - Content validation
* **[Planning](/docs/sdk/typescript/planning)** - Task planning
* **[Telemetry](/docs/sdk/typescript/telemetry)** - Usage monitoring

### Integrations

* **[Vector Stores](/docs/sdk/typescript/vector-stores)** - Embedding databases
* **[Observability](/docs/sdk/typescript/observability)** - Monitoring and tracing
* **[Voice](/docs/sdk/typescript/voice)** - TTS and STT
* **[Reranker](/docs/sdk/typescript/reranker)** - Document reranking
* **[GraphRAG](/docs/sdk/typescript/graph-rag)** - Graph-based RAG
* **[Cache](/docs/sdk/typescript/cache)** - Response caching
* **[Database Adapters](/docs/sdk/typescript/db-adapters)** - Persistence

## CLI

The SDK includes a full CLI. See [TypeScript CLI Reference](/docs/cli/typescript-cli).

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Install globally
npm install -g praisonai

# Use the CLI
praisonai-ts chat "Hello!"
praisonai-ts auto "Build a web scraper"
praisonai-ts research "AI trends 2024"
```

## LLM Providers

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { createProvider, getAvailableProviders } from 'praisonai';

// List available providers
const providers = getAvailableProviders();

// Create a provider
const openai = createProvider('openai/gpt-4o-mini');
const anthropic = createProvider('anthropic/claude-3-sonnet');
const google = createProvider('google/gemini-pro');
```

## Environment Variables

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
PRAISONAI_MODEL=openai/gpt-4o-mini
```