Personal desktop install

Personal is niuniu’s single-machine local edition: all data lives in a SQLite file on your computer — no server, no PostgreSQL required. Download, launch, and you’re ready to go.

System requirements

• macOS 11+ (Apple Silicon or Intel) — WKWebView is part of the OS, no extra dependencies
• Windows 10+ x64 — requires the Microsoft Edge WebView2 Runtime
  • Stock Win10 / Win11 Home / Pro bundle WebView2 Runtime
  • LTSC, Enterprise stripped-down, Windows Server, IoT, and similar SKUs ship without it — install the “Evergreen Standalone Installer” (x64) manually
  • If missing, niuniu-personal will show a native dialog with a button to open the download page — install it, then relaunch
• Linux glibc 2.31+ x64 — requires the system WebKitGTK library (without it the dynamic linker fails before our process even starts)
  • Debian / Ubuntu: sudo apt install libwebkit2gtk-4.1-0
  • Fedora / RHEL: sudo dnf install webkit2gtk4.1
  • Arch / Manjaro: sudo pacman -S webkit2gtk
  • Server / minimal images typically don’t include this package
• Claude CLI installed
• git ≥ 2.30 installed

Download

Go to GitHub Releases, find the latest release, and download the binary for your platform:

Platform	File
macOS Apple Silicon	niuniu-personal-<version>-darwin-arm64
macOS Intel	niuniu-personal-<version>-darwin-amd64
Windows	niuniu-personal-<version>-windows-amd64.exe
Linux	niuniu-personal-<version>-linux-amd64

<version> is the release tag, e.g. v1.0.7.

First launch

macOS / Linux: mark the downloaded file executable (chmod +x niuniu-personal-*) and double-click. On macOS you may need to allow the unsigned binary in System Settings → Privacy & Security on first run.
Windows: double-click the .exe — you may need to approve the SmartScreen prompt.

After launch, your browser will automatically open http://localhost:3000.

Default credentials

• Username: niuniu
• Password: niuniu123

After logging in, go to Settings → Users and change the password.

Data directory

All data is stored under ~/.niuniu/:

~/.niuniu/
├── config.yaml          # configuration
├── niuniu.db            # SQLite database
├── personal.boot.lock   # single-instance lock
└── users/<id>/          # your workspace and repository directories

To migrate to a new machine, copy the entire ~/.niuniu/ directory.

Upgrading

Download the new binary and replace the old one. The database migrates automatically — no manual steps needed. Back up ~/.niuniu/ before upgrading.

Next steps

• 5-minute quickstart — get your first workspace running
• For team collaboration, see Team Edition