Heptabase can work with a book as a PDF or as imported text documents. For long books, use bounded page ranges instead of sending the entire file to AI Agent at once.
Choose a file format
PDF: The best option when you want to preserve page layout, read and highlight the book, or select exact page ranges for AI.
EPUB: Native EPUB reading and parsing are not currently supported. Convert the book to PDF first.
Text documents: If the book is mainly text, you can convert individual chapters to
.md,.txt, or.docx, then choose Import → Text documents at the bottom of the left sidebar.
Each uploaded file can be up to 2GB. PDF parsing supports files up to 350MB, so a larger PDF may upload successfully but still be too large to parse.
Recommended workflow
Open and parse the PDF.
Start a new AI conversation through Ask AI.
Use the page-range context selector to add one chapter or about 20 pages.
Ask AI to create a chapter summary, key concepts, questions, or cards for your whiteboard.
Review the result before processing the next section.
After finishing the sections, start a new conversation with the chapter summaries and ask AI to synthesize the whole book.
About 20 pages is a conservative starting point, not a fixed product limit. If several sections work successfully, you can gradually increase the range.
AI credits and a low-risk first test
PDF parsing and AI analysis are separate steps. Running Parse extracts text and OCR content and does not use AI credits. Asking AI to identify chapters, create an outline, summarize pages, or create cards does use AI credits. There is no prompt that can automatically divide a book into meaningful chapters without using AI credits.
For a cautious first test, start a new conversation through Ask AI, use the page-range context selector to add only 5–10 pages, and try:
“Please analyze only pages 1–10. Identify the main sections and return a concise outline with their page ranges. Do not create or edit any cards, and do not continue beyond these pages.”
This request still uses AI credits. After it finishes, go to Settings → AI Features → View usage to check the cost before processing the next range.
There is no reliable fixed estimate for a 100-page book. Usage varies with the selected model, text density, images, tables, Skill instructions, attachments, and existing conversation history. Images and graphics do not change the fact that PDF parsing itself is credit-free.
Context limits and token usage
There is no fixed page or word count that guarantees success. Text density, images, tables, Skill instructions, attachments, and existing conversation history all use context.
If you use your own API key, requests use your provider project’s usage, billing, and rate limits and do not consume Heptabase AI credits. See How can I get an API key to use AI in Heptabase?
If the request is too large
Start a fresh conversation and select a smaller page range. Avoid repeatedly pressing Continue in a conversation that has already reached the context limit. If smaller page ranges still fail, split the PDF into smaller files.