xianjianlf2 / MindGeniusAI
An AI agent that reads your PDFs and draws editable mind maps — visible tool-calling loop, built-in RAG, bring-your-own-key, multi-provider (OpenAI / Claude / DeepSeek / Kimi). Self-hostable.
Why this job: says: rag; topics: rag

What it does
- Self-hosted & private. ships as one Docker image you run anywhere; your PDFs are chunked/embedded in memory and your key lives in the browser. Nothing is written to the server's disk, no telemetry on your content.
- Real agent, not a prompt wrapper. multi-step tool loop (Vercel AI SDK v5) that decides when to search docs, generate the map, and expand branches, each shown as a live tool card.
- Surgical edits. "rename the pricing branch" patches exact nodes by id, so your manual tweaks survive (no full re-render).
- Two-way canvas. edit nodes by hand (rename, add, drag, delete) and Hermas sees *exactly what you changed* on your next message, then builds on it like a collaborator — not just the latest snapshot.
- Reads your PDFs. attach one or more PDFs (📎): chunk → embed → in-memory retrieval (~100 lines, no LangChain). rag_query searches across all attached docs at once.
Get started
pnpm install
pnpm setup
# pick a provider, paste a key → writes apps/server/.env
pnpm dev
# web on :5173, api on :3000 - Maintenance
- Active
- Last commit 4 months ago
- Stars
- 286
- +2 this week
- Licence
- Custom
- Read before business use
- Downloads for
- None listed
- No release files
- Latest version
- v2.0.0
- Released 5 months ago
- Built with
- TypeScript
- 95% of the code
Is it looked after?
- Contributors
- Not stated
- Last 90 days
- Issues
- 92% closed
- 1 still open
- Pull requests
- 8 merged
- 0 waiting
- Releases
- 4
- 1 in the last year
- Contributing guide (opens in new tab)
- No security policy
- No code of conduct
More: languages, topics and project record
Languages
- TypeScript 95%
- CSS 3%
- JavaScript 1%
- Dockerfile 1%
Topics
- chatgpt
- mindmap
- agent
- ai-agent
- claude
- deepseek
- hono
- llm
- rag
- react
- typescript
- vercel-ai-sdk
Project record
- JobRAG and search
- StatusListed
- Commits97
- Forks61
- Watching8
- Stars in 28 days+3
- CreatedMay 26, 2023
- First seen by usNov 7, 2026
- CheckedNov 8, 2026
