← All help

Explore a Folder or Document with AI

Point Filamental at a folder of documents, or a single document, and the AI you've connected reads it and builds a project: every person, organisation, idea and decision becomes a node, and the relationships between them connectors.

Where: Projects › Start Something… › Use AI › Folder Exploration or Document Exploration

What it is

Folder Exploration reads a whole folder. Document Exploration reads one document and lays out its themes, arguments, claims and decisions and how they connect, with a clear summary in each node's notes. Both read .md, .txt, .docx and .pdf files.

Your documents are only ever read, never moved or changed. They go straight from your computer to the provider you chose, which bills the reading to you, and never pass through us.

You need an AI connected in Filamental AI, either a hosted provider or a model on your own computer.

How to use it

  1. Choose the folder or the document.
  2. Name it. A new project is named after what you chose and made inside the folder, or beside the document. You can change both. If that location is inside an Obsidian vault, Filamental says so first, since the project would become part of it.
  3. Choose an AI, or click Connect an AI to connect one, then Read the folder.
  4. Review the structure. Before anything is read, the AI proposes the project's classifications and connectors. Rename, recolour, remove or add any of them, choose Both ways or One way for each connector, and set how strongly it pulls things together: Light, Normal or Strong.
  5. Check the estimate: roughly how many documents, requests and tokens, on which AI. If there are PDFs, choose how to treat them (below).
  6. Click Start. You'll see which document it's reading, and you can Pause whenever you like. Keep Filamental open until it finishes.

When it's done, Filamental lays the new project out and shows a report: what was added, anything it couldn't read, and a Structure section describing the result. Each node's Source property lists the documents it came from.

PDFs are your choice each time:

  • Read their text. The AI reads them, and they count in the estimate. PDF text can come out jumbled, especially tables and columns, and a scanned page has none, so check anything important against the original.
  • Add them as file nodes. Each PDF is copied into the project and opens in your PDF app. No AI, no tokens.

Pausing and carrying on

Pause stops once the requests already in flight come back. If your provider reports a problem, the run pauses by itself and shows the provider's own words, and Resume tries again.

Quit part way, and Filamental asks Carry on with an import? the next time you open that project. Continue reads only what's left. Discard stops the run and keeps whatever was already added.

Tips

  • It's a first draft. Expect to arrange it and tidy up afterwards.
  • On the free plan an exploration runs to the end, however many documents there are. Nodes you add yourself afterwards count toward the node limit, see Plans: Free and Pro.
  • On a local model documents are read in smaller pieces, one at a time, so it's slower. A model that can't call tools stops at the first step, since proposing the structure is itself a tool call.
  • Opening the source folder later shows a project built inside it as a single bridge node that takes you straight there, not its nodes a second time.

How this helps you

Use it when you inherit a client's whole file or a research folder and want to see who and what is in it before you read every page, or on one long report to see its argument laid out.

Related

Still stuck? Email [email protected].