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

# Ingest helpers

> toradb.ingest module

## `add_file(table, path, chunk_by="paragraph") -> int`

Read a UTF-8 file and ingest chunks.

<ParamField path="chunk_by" type="str" default="paragraph">
  `paragraph` (split on blank lines) or `line`.
</ParamField>

```python theme={null}
from toradb.ingest import add_file
add_file(table, "notes.txt", chunk_by="paragraph")
```

## `add_dataframe(table, df) -> int`

Convert a pandas DataFrame with `to_dict(orient="records")` and call `table.add`.

## `add_arrow(table, arrow_table) -> int`

Prefer `table.add_arrow` when available; otherwise falls back to row-wise conversion. Requires `pyarrow`.

See [Ingest guide](/guides/ingest).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.