Supported files and limits
Which file types Breno reads, the size and page limits, link types, and the limits on exports, trash, tokens and sync.
Files you can upload#
| Kind | Types | Notes |
|---|---|---|
| Documents | PDF, DOCX, PPTX | PDFs are read as text; scanned PDFs go through OCR. |
| Spreadsheets | XLSX, CSV | |
| Web and text | HTML, TXT, Markdown | |
| Images | PNG, JPG, WEBP | Read with a vision provider, when one is configured. |
| Audio | M4A, MP3, WAV, OGG | Transcribed first. Needs transcription to be configured. |
- Size: up to 25 MB per file. The limits are shown in the upload dialog.
- Names: any Unicode filename works.
- Scanned PDFs: read from the embedded page images, up to 30 pages. JBIG2 and JPEG 2000 images are not supported.
- Audio and OCR run as part of the upload request, so large ones take longer to finish.
Each page added costs one coin. See Billing and coins.
Links#
| Link to | What is read |
|---|---|
| An article or web page | The readable content. |
| A YouTube video or a podcast | Its transcript or audio, read like a recording. |
| A PDF, Office file, CSV, image or audio file | The file, by its type. |
An unsupported type is refused with a clear reason before anything is queued. Pages that only render with JavaScript are not supported yet. Addresses are normalized, so the same page is recognized as a duplicate.
Bulk import#
A zip of Markdown or text files, up to 200 files, plus Breno archives, Obsidian vaults and Notion exports. See Import knowledge.
Limits at a glance#
| Thing | Limit |
|---|---|
| File size | 25 MB |
| Scanned PDF pages | 30 |
| Bulk Markdown zip | 200 files |
| Synchronous ZIP export | 500 items |
| Export jobs | 3 running, 10 a day, per caller |
| Export download window | 7 days |
| Trash | 30 days, then purged |
| API rate | 120 requests a minute per token; 300 a minute per IP for token traffic |
GET /documents page size | 200 |
list_documents (MCP) page size | 100 |
| Sync logs kept | 30 days |
| Finished sync jobs kept | 90 days |
| Contact form message | 5,000 characters |
What is not supported yet#
- JavaScript-rendered pages as links.
- Bulk import of file types other than Markdown and text (add other files one at a time, or sync them from a source).
- Retention and legal hold on knowledge items (they apply to search history and some other records). See Known limits.