Skip to main content

Quickstart

Create Account​

Visit the Nomic Atlas website and sign up for a free account. You'll then be asked to choose a name for your Atlas organization, after which you can upload datasets and create data maps in Atlas.

Atlas Dashboard​

Once you are signed up for Atlas and logged in, visit https://atlas.nomic.ai/data to open your Atlas Dashboard.

Alteratively, on the Nomic Atlas homepage click the Dashboard button.

Your organization's data maps will live here. For new organizations with no datasets yet, you will be prompted to get started uploading your first dataset.

Data upload​

Here are a few pathways available to bring data into Atlas:

Data connector upload​

This path involves using a connector to bring in a dataset from an external platform (e.g. using the Hugging Face integration).

Drag & drop upload​

Atlas lets you take a dataset file (in CSV, TSV JSON, or JSONL format) and upload it directly.

Visit our Atlas Dataset docs for more information about acceptable data formats and options for dataset upload and configuration.

SDK upload​

Here is an example of using the Atlas Python SDK to upload data for an Atlas data map.

First, login to Nomic with your API key at your terminal/command line:

nomic login nk-...

Then, use the atlas.map_data() function to upload your data (e.g. as a pandas DataFrame) to Atlas and create a map from it:

from nomic import atlas
import pandas

news_articles = pandas.read_csv(
    'https://raw.githubusercontent.com/nomic-ai/maps/main/data/ag_news_25k.csv'
)

atlas.map_data(
    data=news_articles, 
    indexed_field='text', 
    identifier="Example-text-dataset-news"
)

Developers can see more examples of uploading data to Atlas in our Python SDK documentation.