Files
Add a file from a path, bytes or an upload: a PDF, a Word, PowerPoint or Excel file, or a text file.
mem.memories.add_file("Pricing.pdf") # a path, bytes, or a file opened "rb"
mem.memories.add_file(upload.read(), filename="Pricing.pdf", title="Pricing, October")import { readFile } from "node:fs/promises";
await mem.memories.addFile(await readFile("Pricing.pdf"), { filename: "Pricing.pdf" });
await mem.memories.addFile(file, { title: "Pricing, October" }); // a File from a form keeps its namecurl https://api.geniffy.com/v1/memories/file \
-H "Authorization: Bearer $GENIFFY_API_KEY" \
-H "X-Geniffy-Space: customer_1042" \
-F file=@Pricing.pdfWhat is read
| File | What Geniffy reads |
|---|---|
| The text of every page | |
Word .docx |
Paragraphs, then each table row |
PowerPoint .pptx |
Each slide's text and tables, and its speaker notes |
Excel .xlsx |
Each sheet's rows, cells joined by a vertical bar, values as last calculated |
Text .txt, .md, .csv, .tsv, .html |
The words, in UTF-8 (or UTF-16 with its mark); CSV rows keep their cells, and HTML becomes its readable text, as a saved web page does |
Up to 25 MB, and up to 2 million characters of text. Unpacked, a Word or PowerPoint file can hold up to 10 MB
of text and layout and an Excel file up to 20 MB, and a saved web page (.html) can be up to 2 MB. Past that,
split it, or save it as a PDF (an Excel sheet as CSV). A text file is known by its name, so it needs one of
those endings.
A file that can't be read is refused rather than guessed at: a scan with no text in it, an old .doc,
.ppt or .xls file, a damaged one, or bytes that aren't text under a text file's name. The call fails with
unreadable, and the source it leaves says why, so your app can show the reason.
To keep a file's text and read it back exactly as it was written, such as the notes an agent keeps for itself, put it under a path instead: see Files kept exactly.