hulunote - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #typescript #llm #android #nodejs #macos #cli #vue #awesome-list #pytorch #ios #mcp #open-source

hulunote

(★ 84)

AI + Note Hippocampus — Your second brain, powered by AI

파일 탐색기

최종 버전 다운로드 (.zip)

- - hulunote-notes.md
- config.clj.default
- externs.js
- issues-and-prs.md
- plugin-development.md
- wechat-article-gpt.md
- - AgentRunner.js
  - AgentState.js
  - createDeepAgent.js
  - index.js
- - openRouterClient.js
- - icon.png
  - icon_128x128.png
  - icon_16x16.png
  - icon_256x256.png
  - icon_32x32.png
  - icon_48x48.png
  - icon_512x512.png
  - icon_64x64.png
- - mcpClientManager.js
- build.js
- create-placeholder-icons.js
- generate-icons.sh
- main.js
- package.json
- preload.js
- README.md
- import-data-example.json
- demo-tui.png
- demo1-mcp-chat.png
- demo1-mcp-setting.png
- demo1.png
- graph-sidebar.png
- ios-demo-all.png
- hacknews_v1.1.0.md
- slack_v0.1.0.md
- slack_v1.1.0.md
- v0.1.0_git_release.md
- v1.1.0_git_release.md
- .keep
- cljrun
- cljrun2
- cljrunjar
- cljsrun
- deploy_dev
.gitignore
AGENTS.md
build_dev.sh
build_electron.sh
clean_build_electron.sh
CONTRIBUTING.md
demo.png
deps.edn
hulunote-cli.js
LICENSE
package.json
processes.json
README.md
shadow-cljs.edn
UI_DESIGN_SYSTEM.md
update_css.sh
yarn.lock

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/hulunote/hulunote

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd hulunote

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

cd hulunote && yarn && npx shadow-cljs watch hulunote

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Hulunote

**AI + Note Hippocampus** — Your second brain, powered by AI.

Hulunote is an open-source outliner note-taking application with bidirectional linking. Inspired by Roam Research, designed for networked thought. Like the hippocampus organizes memories in the brain, Hulunote organizes your knowledge — and now AI helps you build, connect, and retrieve it.

![](https://raw.githubusercontent.com/hulunote/hulunote/master/images/demo1.png)
![](https://raw.githubusercontent.com/hulunote/hulunote/master/images/graph-sidebar.png)
![](https://raw.githubusercontent.com/hulunote/hulunote/master/images/ios-demo-all.png)

## Features

- **Outliner Structure** — Organize thoughts in hierarchical bullet points with infinite nesting
- **Bidirectional Links** — Connect ideas with `[[wiki-style links]]` and backlinks
- **Daily Notes** — Journaling with automatic date-based pages
- **Multiple Databases** — Separate workspaces for different projects
- **Built-in MCP Client** — Connect to AI models and MCP servers directly from the app
- **AI Note Generation** — Let AI organize, summarize, and generate notes for you

## AI Integration

Hulunote embraces the **AI + Note Hippocampus** philosophy: AI acts as your cognitive co-pilot, helping you capture, organize, and retrieve knowledge just like the hippocampus does for memory.

### MCP Server — For Claude Desktop & MCP Clients

[hulunote-mcp-server](https://github.com/hulunote/hulunote-mcp-server) lets any MCP-compatible client (Claude Desktop, etc.) read and write your Hulunote notes via natural language:

```bash
pip install -r requirements.txt
python hulunote_mcp.py
```

```
"List my databases" → "Create a note about quantum computing" → "Add outline nodes with key concepts"
```

### OpenClaw Plugin — For AI Agents

[openclaw-hulunote-assistant](https://github.com/hulunote/openclaw-hulunote-assistant) brings Hulunote into the OpenClaw AI agent platform, enabling autonomous note management:

```bash
openclaw plugins install --link /path/to/openclaw-hulunote-assistant
```

AI agents can browse databases, create notes, manage outlines, search across your knowledge base, and auto-organize information — all through natural conversation.

### What AI + Hulunote Can Do

- **Auto-organize research** — AI reads sources and creates structured notes with bidirectional links
- **Knowledge summarization** — Condense long documents into concise outline nodes
- **Smart Q&A** — Ask questions about your notes, get answers with references
- **Note generation** — Describe a topic, AI creates a full note with hierarchical outline
- **Cross-database search** — AI finds and connects related ideas across all your databases

## Quick Start

```bash
# 1. Initialize database
createdb hulunote_open
psql -d hulunote_open -f hulunote-rust/init.sql

# 2. Start backend
cd hulunote-rust && cargo run

# 3. Start frontend dev server
cd hulunote && yarn && npx shadow-cljs watch hulunote

# 4. Open browser at http://localhost:6689
```

**Test Account (for local/dev use):** `chanshunli@gmail.com` / `123456`

## Configuration

- **Backend API Base URL (dev):** configured via `:closure-defines` in `shadow-cljs.edn` (`hulunote.http/API_BASE_URL`).

## Screenshots

TUI:
![](https://raw.githubusercontent.com/hulunote/hulunote/master/images/demo-tui.png)

MCP client:
![](https://raw.githubusercontent.com/hulunote/hulunote/master/images/demo1-mcp-chat.png)
![](https://raw.githubusercontent.com/hulunote/hulunote/master/images/demo1-mcp-setting.png)

## Repositories

| Repository | Description |
|------------|-------------|
| [hulunote](https://github.com/hulunote/hulunote) | Frontend (this repo) |
| [hulunote-rust](https://github.com/hulunote/hulunote-rust) | Backend (Rust) |
| [hulunote-mcp-server](https://github.com/hulunote/hulunote-mcp-server) | MCP Server for Claude Desktop & MCP clients |
| [openclaw-hulunote-assistant](https://github.com/hulunote/openclaw-hulunote-assistant) | OpenClaw AI agent plugin |
| [hulunote-tui](https://github.com/hulunote/hulunote-tui) | Terminal UI |
| [hulunote-app](https://github.com/hulunote/hulunote-app) | Desktop App (Electron) |
| [hulunote-android](https://github.com/hulunote/hulunote-android) | Android |
| [hulunote-ios](https://github.com/hulunote/hulunote-ios) | iOS |

## Contributing

See `CONTRIBUTING.md`.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.