Practical overview
When it fits
Use it when a PDF-based research or knowledge task benefits from both document-grounded questions and a mind map that can be refined by people and the agent.
Who it is for
- Researchers and knowledge workers who want to question PDFs and organize findings visually.
- Self-hosters and teams handling sensitive research, legal documents or internal specifications.
Documented uses
- Ask questions across one or more attached PDFs using retrieval.
- Convert document material into a mind map and expand branches.
- Manually edit map nodes or ask the agent to change specific nodes while preserving other edits.
- Import Markdown or OPML maps and export maps in PNG, SVG, Markdown, OPML or Mermaid formats.
Requirements & limits
The repository offers a live demo that requires visitors to bring their own API key. Local development requires Node.js 20 or later and pnpm; the README also documents a Docker image. The repository identifies the license as BSL 1.1.
- The README documents OpenAI and Claude with full RAG; DeepSeek and Kimi lack embeddings in this setup, with an OpenAI-compatible embedding endpoint offered as a way to keep retrieval enabled.
- The app uses user-supplied model keys and supports OpenAI, Claude, DeepSeek, Kimi and OpenAI-compatible endpoints.
- The canvas supports manual edits that the agent can take into account on a later message.
- The project describes a self-hosted deployment and in-memory PDF processing; choose the infrastructure you control if that operating model matters.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Start Mindgeniusai locally with pnpm
Install and start the documented local development setup.
Before you start
- Node.js 20 or later
- pnpm
- A model provider and API key, configured during setup or later in the app
Steps
Run
pnpm install.Run
pnpm setupand select a provider and key; the wizard writesapps/server/.env.Run
pnpm devto start the web app on port 5173 and API on port 3000.
Expected outcome
The local web app and API are started for development.
Guide limitations
- The README documents the development startup path, not a production deployment procedure.
- DeepSeek and Kimi lack embeddings in the documented setup; configure an OpenAI-compatible embedding endpoint to keep RAG enabled.
Run the app with Docker
Start the documented single-image application locally.
Before you start
- Docker
- A model API key, or a plan for visitors to provide their own key in Settings
Steps
Run the documented Docker image with port 3000 mapped to port 3000; provide
OPENAI_API_KEYas an environment variable if using a server key.Open
http://localhost:3000.
Expected outcome
The web application and API are served from the Docker image.
Guide limitations
- The documented example uses an OpenAI key; the README also describes omitting the key so each visitor can provide one in Settings.
- This recipe follows the README's documented command and is not a deployment or compatibility test.
Compare options for Retrieval-augmented applications
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Mindgeniusai | Ask questions across one or more attached PDFs using retrieval. | Docker, Self-hosted, Web | The repository offers a live demo that requires visitors to bring their own API key. Local development requires Node.js 20 or later and pnpm; the README also documents a Docker image. The repository identifies the license as BSL 1.1. |
| Vectaurant | Find menu options by describing preferences, such as asking what is vegan or spicy. | CLI, Docker, Linux, macOS | |
| Aml Multiagent Rag | Ingest PDF regulations, extract and chunk their text, and build a searchable vector collection. | Docker, Self-hosted | The repository is public and specifies the MIT license. The documented setup is self-hosted and requires Python 3.11 or later, Docker Desktop and an OpenAI API key. |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- xianjianlf2/MindGeniusAI · Official homepage title · retained in its source language

