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

# Roam integration

> Integrate with the Roam document loader using LangChain Python.

> [ROAM](https://roamresearch.com/) is a note-taking tool for networked thought, designed to create a personal knowledge base.

This notebook covers how to load documents from a Roam database. This takes a lot of inspiration from the example repo [here](https://github.com/JimmyLv/roam-qa).

## 🧑 Instructions for ingesting your own dataset

Export your dataset from Roam Research. You can do this by clicking on the three dots in the upper right hand corner and then clicking `Export`.

When exporting, make sure to select the `Markdown & CSV` format option.

This will produce a `.zip` file in your Downloads folder. Move the `.zip` file into this repository.

Run the following command to unzip the zip file (replace the `Export...` with your own file name as needed).

```shell theme={null}
unzip Roam-Export-1675782732639.zip -d Roam_DB
```

```python theme={null}
from langchain_community.document_loaders import RoamLoader
```

```python theme={null}
loader = RoamLoader("Roam_DB")
```

```python theme={null}
docs = loader.load()
```

***

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

<Callout icon="terminal-2">
  [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
</Callout>