> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-5e9cc07a-preview-docsby-1791319236-3be7a15.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Nia Toolkit integration

> Integrate with the Nia search and index API using LangChain JavaScript.

[Nia](https://trynia.ai) is a search and index API that continuously provides context from docs, research papers, datasets, codebases, and more—so agents never rely on stale data. Scalable, 5x cheaper, and reliable.

## Overview

### Integration details

| Class | Package | [PY support](/oss/javascript/integrations/tools/nia) | Version |
| :- | :- | :-: | :-: |
| [`NiaToolkit`](https://github.com/nozomio-labs/nia-langchain) | [`@nozomioai/langchain-nia`](https://www.npmjs.com/package/@nozomioai/langchain-nia) | ✅ | ![NPM - Version](https://img.shields.io/npm/v/@nozomioai/langchain-nia?style=flat-square\&label=%20&) |

## Setup

The integration lives in the `@nozomioai/langchain-nia` package:

<CodeGroup>
  ```bash npm theme={null}
  npm install @nozomioai/langchain-nia @langchain/core
  ```

  ```bash yarn theme={null}
  yarn add @nozomioai/langchain-nia @langchain/core
  ```

  ```bash pnpm theme={null}
  pnpm add @nozomioai/langchain-nia @langchain/core
  ```
</CodeGroup>

### Credentials

Sign up at [trynia.ai](https://trynia.ai) to get an API key.

```typescript theme={null}
process.env.NIA_API_KEY = "nk_...";
```

It's also helpful (but not needed) to set up [LangSmith](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=oss-javascript-integrations-tools-nia) for best-in-class observability:

```typescript theme={null}
process.env.LANGSMITH_TRACING = "true";
process.env.LANGSMITH_API_KEY = "your-api-key";
```

## Instantiation

### Using the toolkit

```typescript theme={null}
import { NiaToolkit } from "@nozomioai/langchain-nia";

const toolkit = new NiaToolkit({
  includeSearch: true,        // 5 search tools
  includeSources: true,       // 7 source management tools
  includeGithub: true,        // 4 GitHub tools
  includeContexts: true,      // 2 context/memory tools
  includeDependencies: true,  // 2 dependency tools
});

const tools = toolkit.getTools(); // 20 tools
```

### Using individual tools

```typescript theme={null}
import { NiaSearch } from "@nozomioai/langchain-nia";

const tool = new NiaSearch();
```

## Invocation

### Search across indexed sources

```typescript theme={null}
import { NiaSearch } from "@nozomioai/langchain-nia";

const tool = new NiaSearch();
const result = await tool.invoke({ query: "how to use React hooks" });
```

### Search the web

```typescript theme={null}
import { NiaWebSearch } from "@nozomioai/langchain-nia";

const tool = new NiaWebSearch();
const result = await tool.invoke({ query: "latest Node.js release", numResults: 5 });
```

### Within an agent

```typescript theme={null}
import { NiaToolkit } from "@nozomioai/langchain-nia";
import { ChatOpenAI } from "@langchain/openai";

const toolkit = new NiaToolkit({ includeSearch: true });
const tools = toolkit.getTools();

const llm = new ChatOpenAI({ model: "gpt-4o" });
const llmWithTools = llm.bindTools(tools);

const result = await llmWithTools.invoke("Search for React hooks best practices");
```

## Available tools

| Tool | Description |
| - | - |
| `NiaSearch` | Semantic search across indexed repos, docs, and data sources |
| `NiaWebSearch` | Web search with category filtering and date range |
| `NiaDeepResearch` | Multi-step comprehensive research |
| `NiaUniversalSearch` | Search all sources simultaneously |
| `NiaAdvisor` | Analyze code against indexed documentation |
| `NiaIndex` | Index new sources (repos, docs, papers, datasets) |
| `NiaSourceList` | List indexed sources with filtering |
| `NiaSourceSubscribe` | Subscribe to pre-indexed public sources |
| `NiaSourceSync` | Re-sync sources to pull latest changes |
| `NiaRead` | Read files/pages from indexed sources |
| `NiaGrep` | Regex search within indexed sources |
| `NiaExplore` | Browse file tree of indexed sources |
| `NiaGitHubSearch` | Search code in GitHub repositories |
| `NiaGitHubRead` | Read files from GitHub repos |
| `NiaGitHubGlob` | Find files matching glob patterns |
| `NiaGitHubTree` | Browse repo file tree |
| `NiaContextSave` | Save context for cross-agent sharing |
| `NiaContextSearch` | Semantic search over saved contexts |
| `NiaDependencySubscribe` | Auto-subscribe to docs for project dependencies |
| `NiaDependencyAnalyze` | Preview indexable dependencies from a manifest |

## API reference

For detailed documentation, see the [langchain-nia GitHub repository](https://github.com/nozomio-labs/nia-langchain).

***

<div className="source-links">
  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to your agent of choice via MCP for real-time answers.
  </Callout>

  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/oss/javascript/integrations/tools/nia.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>