# Mindolph

**Repository Path**: mirrors/Mindolph

## Basic Information

- **Project Name**: Mindolph
- **Description**: Mindolph 是一个支持多平台的开源的个人知识库管理软件
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: https://www.oschina.net/p/mindolph
- **GVP Project**: No

## Statistics

- **Stars**: 14
- **Forks**: 3
- **Created**: 2023-04-07
- **Last Updated**: 2026-01-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p>
	<a title="Releases" target="_blank" href="https://github.com/mindolph/Mindolph/releases"><img src="https://img.shields.io/github/release/mindolph/Mindolph.svg?style=flat-square&color=9CF"></a>
	<a title="Downloads" target="_blank" href="https://github.com/mindolph/Mindolph/releases"><img src="https://img.shields.io/github/downloads/mindolph/Mindolph/total.svg?style=flat-square&color=blueviolet"></a>
	<a title="GitHub Commits" target="_blank" href="https://github.com/mindolph/Mindolph/commits/main/"><img src="https://img.shields.io/github/commit-activity/m/mindolph/Mindolph.svg?style=flat-square"></a>
	<a title="Last Commit" target="_blank" href="https://github.com/mindolph/Mindolph/commits/main/"><img src="https://img.shields.io/github/last-commit/mindolph/Mindolph.svg?style=flat-square&color=FF9900"></a>
</p>

### Mindolph

![](./DemoWorkspace/app_30.png)

Mindolph is an open source personal knowledge management software with Gen-AI support for all desktop platforms. [简体中文](./docs/README_zh_CN.md)


### Features
* Create and manage your own files in separate workspaces with saving in your local storage, which means you have full control of your knowledge compared to cloud solutions.
* Organize your files as a tree in your workspaces.
* GenAI support for Mind Map, Markdown, PlantUML and plain text editors, you can generate or summarize text content by API of LLM. supported LLM providers:
	* OpenAI  
	* Ali Qwen  
	* Ollama  
	* Google Gemini API  
	* Hugging Face API  
	* ChatGLM
	* DeepSeek
	* Moonshot
* Multiple tabs for opening files instead of a single file window, making it easy to switch back and forth between files.
* Supports Mind Map(`*.mmd`), Markdown(`*.md`), PlantUML(`*.puml`), CSV sheet(`*.csv`) and plain text(`*.txt`) file formats, more formats will be supported in the future.
* Save opened files  as a named `Collection` to manage related files even from different workspaces.
* Outline view for active opened file.
* Snippet feature to quickly insert pre-defined or user-defined snippets to Mind Map, PlantUML and Markdown files.
* Quickly navigate to any file and search text in files under any specific folder.
* Mind Map:
	* Edit mind map easily and quickly with key shortcuts.
	* Supports themes and provides some pre-defined themes(`Classic`, `Light` and `Dark`), customizing themes by duplicating existing themes and setup the style of any element freely.
	* Supports note, file link, URI link, image and emoticon for topic node.
	* Import from other mind map formats like Freemind, Mindmup, XMind, Coggle, Novamind.
	* Export to other file formats like Freemind, Markdown, image files(png/svg), AsciiDoc, etc.
	* Compatible with mind map files created by `netbeans-mmd-plugin`.
* PlantUML:
	* Syntax highlighting.
	* Preview results instantly while editing.
	* Export to image file and ASCII image.
* Markdown
	* Syntax highlighting.
	* Preview results instantly while editing.
	* Export to PDF and HTML files.
* CSV Sheet
	* Show and edit CSV file visually.
* Supports multiple desktop platforms, including `macOS`, `Windows` and `Linux`.


### Screenshots
* Mind Map
<p float="left">
	<img src="docs/screenshots/mindmap_light_snippet.jpg" width="45%"/>
	&nbsp;&nbsp;&nbsp;&nbsp;
	<img src="docs/screenshots/mindmap_dark_outline.jpg" width="45%"/>
</p>

* Markdown
<p float="left">
	<img src="docs/screenshots/markdown1.jpg" width="45%"/>
	&nbsp;&nbsp;&nbsp;&nbsp;
	<img src="docs/screenshots/markdown2.jpg" width="45%"/>
</p>

* PlantUML
<p float="left">
	<img src="docs/screenshots/puml_sequence.jpg" width="45%"/>
	&nbsp;&nbsp;&nbsp;&nbsp;
	<img src="docs/screenshots/puml_component2.jpg" width="45%"/>
</p>
<p float="left">
	<img src="docs/screenshots/puml_state.jpg" width="45%"/>
	&nbsp;&nbsp;&nbsp;&nbsp;
	<img src="docs/screenshots/puml_activity_snippet.jpg" width="45%"/>
</p>

* Gen-AI
<p float="left">
	<img src="docs/release-notes/v1.11/v1.11_genai_streaming.gif" width="36%"/>
	&nbsp;&nbsp;&nbsp;&nbsp;
	<img src="docs/release-notes/v1.11/v1.11_genai_summarize.gif" width="54%"/>
</p>

* Others
<p float="left">
	<img src="docs/screenshots/find_in_files.jpg" width="45%"/>
	&nbsp;&nbsp;&nbsp;&nbsp;
</p>

[See More](docs/screenshots.md)


### Releases

#### Release Notes

* Stable Version: [v1.12](docs/release-notes/v1.12/v1.12.md)
* Unstable Version: [v1.13](docs/release-notes/v1.13/v1.13.md)

#### Downloads

|Platform|Type|Stable|Unstable|Note|
|----|----|----|----|----|
|macOS|.dmg|[v1.12.13](https://github.com/mindolph/Mindolph/releases/download/v1.12.13/Mindolph-1.12.13-x64.dmg) |[v1.13.3](https://github.com/mindolph/Mindolph/releases/download/v1.13.3/Mindolph-1.13.3-x64.dmg) | Intel |
|macOS|.dmg|[v1.12.13](https://github.com/mindolph/Mindolph/releases/download/v1.12.13/Mindolph-1.12.13-aarch64.dmg) |[v1.13.3](https://github.com/mindolph/Mindolph/releases/download/v1.13.3/Mindolph-1.13.3-aarch64.dmg) | Apple Silicon </br>for supporting PlantUML, install graphviz first:</br>`brew install graphviz`|
|Windows|.msi|[v1.12.13](https://github.com/mindolph/Mindolph/releases/download/v1.12.13/Mindolph-1.12.13.msi) |[v1.13.3](https://github.com/mindolph/Mindolph/releases/download/v1.13.3/Mindolph-1.13.3.msi) | |
|Debian/Ubuntu|.deb|[v1.12.13](https://github.com/mindolph/Mindolph/releases/download/v1.12.13/Mindolph-1.12.13.deb)|[v1.13.3](https://github.com/mindolph/Mindolph/releases/download/v1.13.3/Mindolph-1.13.3.deb)|	for supporting PlantUML, install graphviz first:</br>  `sudo apt install graphviz`|
|Fedora|.rpm|[v1.12.13](https://github.com/mindolph/Mindolph/releases/download/v1.12.13/Mindolph-1.12.13.rpm)|[v1.13.3](https://github.com/mindolph/Mindolph/releases/download/v1.13.3/Mindolph-1.13.3.rpm)| |
|Java Executable|.jar|[v1.12.13](https://github.com/mindolph/Mindolph/releases/download/v1.12.13/Mindolph-1.12.13.jar)|[v1.13.3](https://github.com/mindolph/Mindolph/releases/download/v1.13.3/Mindolph-1.13.3.jar)| see [how to run](./docs/INSTALL.md) |


[Change Logs](docs/change_logs.md)


### Development

Mindolph is developed based on JavaFX, see [code/README.md](code/README.md) for more details.

Future Plan:  

* 1.13: AI agent based on personal knowledge base (preview).
* 1.14: Improvement of AI agent.

### Buy me a cup of coffee

<img src="docs/bmc_qr.png" width="30%"/>