selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

MindGenius AI logo

Self-host MindGenius AI

v2.0.0

AI agent that turns documents into editable mind maps

ReleaseSource AvailableOther
Updated4 months ago
LanguageTypescript
Setup difficultyEasy
ThemeDark mode
Stars
284
Port
3000 (HTTP server (web UI + API))
Docker
ghcr.io/xianjianlf2/mindgeniusai
Install with Docker
Hermas agent planning and drawing an editable mind map live

What is MindGenius AI?

MindGenius AI is a self-hostable AI agent called Hermas that reads PDF documents and generates editable mind maps in real time. It runs as a single Docker container on your own infrastructure, keeping all documents and API keys local — nothing is uploaded to external servers. The agent uses a visible multi-step tool loop (plan, retrieve, draw, edit) powered by Vercel AI SDK v5, supports surgical node edits by ID, and maintains a two-way canvas where manual changes are seen by the agent on the next turn. It brings your own API keys for OpenAI, Anthropic (Claude), DeepSeek, or Kimi/Moonshot, with optional RAG embeddings via OpenAI-compatible endpoints. Features include keyboard-first canvas navigation, a command palette (⌘K), import/export of Markdown, OPML, PNG, SVG, and Mermaid, bilingual EN/中文 UI, and a dark theme. The license is BSL 1.1, which permits individual, scholarly, research, and non-commercial use at no cost, while commercial use requires a paid license.

Should you self-host MindGenius AI?

MindGenius AI scores 44/100 on selfhost.directory (how scoring works) and ranks #71 of 120 in AI Assistant. It has 284 GitHub stars.

It shipped 1 stable release in the past year. The latest, v2.0.0, came out on 10 June 2026.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Other-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is hermes-agent (89/100, 257 885 stars). It scores higher overall, so compare the two before you pick. See MindGenius AI vs hermes-agent side by side.

Features

  • Bilingual UI
  • Bring Your Own Key
  • Command Palette
  • Import/Export
  • Keyboard-first canvas
  • Multi-Provider LLM Support
  • PDF reading with in-memory RAG
  • Real multi-step agent
  • Self-hosted & private
  • Surgical mind map edits
  • Two-way canvas collaboration

MindGenius AI README

How to install MindGenius AI

Install MindGenius AI with Docker

Docker
Environment variables
OPENAI_API_KEY, EMBEDDING_API_KEY, DEMO_DAILY_LIMIT, etc.

docker run -p 3000:3000 -e OPENAI_API_KEY=sk-... ghcr.io/xianjianlf2/mindgeniusai

Omit the key to let each visitor bring their own from Settings.

How to configure MindGenius AI

  • ANTHROPIC_API_KEYAnthropic (Claude) API key

    Anthropic (Claude) API key

  • ANTHROPIC_MODELAnthropic model name

    Anthropic model name

  • DEEPSEEK_API_KEYDeepSeek API key

    DeepSeek API key

  • DEEPSEEK_MODELDeepSeek model name

    DeepSeek model name

  • DEMO_DAILY_LIMIT0Daily free runs per IP for visitors without their own key (0 = unlimited)

    Daily free runs per IP for visitors without their own key (0 = unlimited)

  • DISABLE_UPLOADDisable PDF upload entirely

    Disable PDF upload entirely

    values: true

  • EMBEDDING_API_KEYEmbedding API key (falls back to OPENAI_API_KEY)

    Embedding API key (falls back to OPENAI_API_KEY)

  • EMBEDDING_BASE_URLEmbedding API base URL (falls back to OPENAI_PROXY_URL)

    Embedding API base URL (falls back to OPENAI_PROXY_URL)

  • EMBEDDING_MODELEmbedding model for RAG

    Embedding model for RAG

  • LLM_PROVIDERopenaiDefault model provider

    Default model provider

    values: openai | anthropic | deepseek | moonshot

  • LOG_LEVELinfoLog level

    Log level

    values: debug | info | warn | error

  • MAX_CHUNKS_PER_DOC200Maximum chunks per document

    Maximum chunks per document

  • MAX_INDEXED_DOCS20Maximum number of documents indexed in memory

    Maximum number of documents indexed in memory

  • MAX_UPLOAD_MB10Maximum single PDF file size in MB

    Maximum single PDF file size in MB

  • MOONSHOT_API_KEYMoonshot (Kimi) API key

    Moonshot (Kimi) API key

  • MOONSHOT_BASE_URLMoonshot API base URL

    Moonshot API base URL

  • MOONSHOT_MODELMoonshot model name

    Moonshot model name

  • OPENAI_API_KEYOpenAI API key

    OpenAI API key

  • OPENAI_MODELOpenAI model name

    OpenAI model name

  • OPENAI_PROXY_URLCustom OpenAI-compatible gateway URL

    Custom OpenAI-compatible gateway URL

  • PORT3000Server port

    Server port

MindGenius AI releases & version history

More in Document Processing

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…