# @nomic-ai/atlas

> This library provides a TypeScript client for the Nomic API that allows you to work with datasets and embedding models hosted at atlas.nomic.ai.

Latest version **0.12.0** (published 2024-11-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nomic-ai/atlas
pnpm add @nomic-ai/atlas
yarn add @nomic-ai/atlas
bun add @nomic-ai/atlas
```

## Health

**Score 40/100 (D)** — status: maintenance-mode.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads; pre 1.0.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.12.0 |
| Published | 2024-11-08 |
| First published | 2023-05-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 3 |
| Unpacked size | 317.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | rlesser, benmschmidt, nomic_ben |

## Links

- npm: https://www.npmjs.com/package/@nomic-ai/atlas
- npm.io page: https://npm.io/package/@nomic-ai/atlas

## Dependencies (3)

- [dotenv](https://npm.io/package/dotenv.md) ^16.0.3
- [js-yaml](https://npm.io/package/js-yaml.md) ^4.1.0
- [apache-arrow](https://npm.io/package/apache-arrow.md) ^13.0.0

## Recent versions

- 0.12.0 (latest) — 2024-11-08
- 0.12.1-next.20 (next) — 2025-09-16
- 0.12.1-next.19 — 2025-08-08
- 0.12.1-next.18 — 2025-06-17
- 0.13.0-next.0 — 2025-06-07
- 0.12.1-next.17 — 2025-05-22
- 0.12.1-next.16 — 2025-05-19
- 0.12.1-next.15 — 2025-05-19
- 0.12.1-next.14 — 2025-05-02
- 0.12.1-next.13 — 2025-04-15
- 0.12.1-next.12 — 2025-04-14
- 0.12.1-next.11 — 2025-04-04
- 0.12.1-next.10 — 2025-03-24
- 0.12.1-next.9 — 2025-03-17
- 0.12.1-next.8 — 2025-02-12
- … 72 more at https://npm.io/package/@nomic-ai/atlas/versions

## README

# Nomic-ts

This library provides a TypeScript client for the Nomic API that
allows you to work with datasets and embedding models hosted at atlas.nomic.ai.

## Quick Start

Quick start:

```js
import { embed } from '@nomic-ai/atlas';

embed(['so much depends upon', 'a red wheel barrow'], `nk-123456789`).then(
  (embeddings) => console.log({ embeddings })
);
```

or if your key is already in an environment variable at ATLAS_API_KEY:

```js
import { embed } from '@nomic-ai/atlas';

embed(['glazed with rain water', 'beside the white chickens']).then(
  (embeddings) => console.log({ embeddings })
);
```

## Managing API keys

All operations require a nomic API key linked to your account.
To generate an API key, visit https://atlas.nomic.ai/ while logged in to your account and click on the API key tab under the organization.

### API key as env variable

Once you have the API key, create a file in project root directory called `.env`
In it, put the following line:

```
ATLAS_API_KEY=your-api-key
```

If running in an environment like Vercel or Heroku, you can set the environment variable through the hosting environment.

### API key as argument

Alternatively, pass the api key as a param to `AtlasUser`:

```js
AtlasUser({ apiKey: 'your-api-key' });
```

## Setting the tenant environment

By default, this will access the production version of Atlas. This is probably what you want.

If you are using a custom tenant of Atlas, you will define the following additional variables:

```
ATLAS_FRONTEND_DOMAIN=your.frontend.domain
ATLAS_API_DOMAIN=your.api.domain
```

# Design

This library is designed to be used in a browser or in Node.js. It is written in TypeScript and compiled to JavaScript.

Since the precise mechanism for calls differs in the browser as opposed to node,
all calls are handler by an `AtlasUser` interface.

---
_Source: https://npm.io/package/@nomic-ai/atlas · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._