Nether Free and Open Source Desktop App CookApps CookApps Marketplace

Overview

Nether is a free, AGPL-3.0 self-hostable and local-first workspace combining Obsidian's plain Markdown vault philosophy with Notion's relational databases and team collaboration. Notes stay on your disk with YAML frontmatter while powering Table, Board, Calendar, Timeline, Gallery, and List views alongside Yjs CRDT real-time sync, TipTap block editing, and native MyGO desktop apps for macOS, Windows, and Linux.

How It Works

Nether operates through structured, deterministic execution stages:

Local-First Markdown Vault: Stores every note as clean plain Markdown with YAML frontmatter in a user-selected folder, natively readable by Obsidian, VS Code, or any text editor with zero vendor lock-in.

Structured Multi-View Databases: Transforms notes into structured databases featuring Table, Board (Kanban), Calendar, Timeline, Gallery, and List views with typed properties, relations, rollups, and formulas.

TipTap Block Editor & Synced Blocks: Powers effortless block editing via TipTap/ProseMirror with remark AST parsing, bidirectional backlinks, tag indexing, interactive graph view, and synced reusable blocks.

Self-Hosted End-to-End Encrypted Sync: Merges multi-device edits with zero conflict dialogs using Yjs CRDTs over Hocuspocus with Fastify, PostgreSQL 16, and optional enterprise SSO / audit logs.

Key Technical Features & Capabilities

Plain-Markdown Local Vaults: Stores every note locally as standard Markdown with YAML frontmatter, preserving full interoperability with Obsidian, Notion, Logseq, HTML, and CSV importers.

Six Database Views, Relations & Formulas: Structures notes with typed properties, cross-table relations, rollups, formulas, query blocks, synced blocks, and an interactive backlink graph view.

Conflict-Free Yjs CRDT Co-Editing: Merges offline edits across multiple devices without manual conflict dialogs using Yjs CRDTs paired with Hocuspocus synchronization and end-to-end encryption.

Full-Featured AGPL Enterprise Self-Hosting: Includes spaces, page permissions, comments, server search, single sign-on (SSO), audit logs, and automated backups with zero paid tiers or telemetry.

Architecture & Technology Stack

Primary Languages: TypeScript (Node.js 24, pnpm 10, Turborepo), Go 1.27

Frameworks & UI Runtime: MyGO Desktop Native WebView Shell, TipTap / ProseMirror Block Editor + remark

Sync, Database & Backend Engine: Fastify Server, Yjs CRDTs + Hocuspocus, PostgreSQL 16, Redis / Valkey, S3 Storage

Supported Platforms: macOS Universal (DMG), Windows 10/11 x64 (Setup EXE), Linux (AppImage, Flatpak, .deb)

System Requirements

Specification	Minimum Requirement	Recommended Specification
Operating System	macOS (Universal DMG), Windows 10/11 x64, Linux	Latest stable release build
Processor Architecture	4-Core x86_64 or Apple Silicon M1	8-Core Apple Silicon / Core i7+
Memory (RAM)	4 GB Unified Memory	16 GB+ High-Speed RAM
Disk Space	1 GB free SSD storage	5 GB+ free SSD storage

Installation & Setup Guide

2 Redit

Desktop App Installation

macOS: Download nether-0.0.1-darwin-universal.dmg directly from CookApps and drag Nether.app to /Applications.

Windows: Download nether-0.0.1-windows-amd64-setup.exe and follow the Windows installer wizard.

Building from Source

bash

git clone https://github.com/fzn0x/Nether.git
cd Nether
pnpm install
pnpm test
pnpm --filter @nether/desktop dev

Installation & Setup Guide

Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.

How to Use & Workflow

2 Redit

Create or Import Vault: Open a local Markdown folder or import existing Obsidian vaults and Notion/Logseq/CSV exports.

Compose Blocks & Backlinks: Edit richly formatted blocks in TipTap, tag entities, link pages, and visualize clusters in the interactive Graph view.

Structure Multi-View Databases: Convert collections into Table, Board, Calendar, Timeline, Gallery, or List views powered by relational formulas.

Configure BYO-AI or Sync: Connect an OpenAI-compatible, Anthropic, or local LLM endpoint, or attach a self-hosted PostgreSQL + Fastify sync server.

How to Use & Workflow

Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.

Troubleshooting & Common Issues

Issue: Self-hosted server refuses to boot without backing database.

*Cause*: Nether's Fastify collaboration server requires PostgreSQL 16+ and Redis/Valkey endpoints configured.

*Resolution*: Follow apps/server/README.md to provision PostgreSQL 16+ or run the local desktop app in offline vault mode.

Issue: Desktop build fails on host missing Go toolchain.

*Cause*: @nether/desktop wraps the UI inside a compiled MyGO WebView runtime requiring Go 1.27+.

*Resolution*: Install Node.js 24, pnpm 10, and Go 1.27+ before running pnpm --filter @nether/desktop dev.

Nether

Overview

How It Works

Key Technical Features & Capabilities

Architecture & Technology Stack

System Requirements

Installation & Setup Guide

Desktop App Installation

Building from Source

Installation & Setup Guide

How to Use & Workflow

How to Use & Workflow

Troubleshooting & Common Issues

How to Use & Getting Started

How to Use & Getting Started

Ready to run Nether?

More in productivity

IDX

Ardia

DeckCraft