Check its license. It has its own license: read it before using it for work.

Is AFFiNE still maintained?

Yes, active. Last change today. Latest release v2026.11.7-canary.904, today.

Widely used. 74k stars, 4 years old, by an organization. As with any download, get it from the official repo.

gitmanual

Reading the repo

Opening the box…

How to install AFFiNE on macOS (toeverything/AFFiNE) · gitmanual

How to install on macOS

toeverything/AFFiNE

There can be more than Notion and Miro. AFFiNE(pronounced [ə‘fain]) is a next-gen knowledge base that brings planning, sorting and creating all together. Privacy first, open-source, customizable and ready to use.

Node.jsViteRust#app#crdt#editor#electron

Difficulty: Moderate
Time: about 15 min
Stars: ★ 74,291
Activity: Updated this month
License: Not detected
Open issues: 804
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Before you start

Is it free?: Check its licenseIt has its own license: read it before using it for work.
Still maintained?: Yes, activeLast change today. Latest release v2026.11.7-canary.904, today.
Can I trust it?: Widely used74k stars, 4 years old, by an organization. As with any download, get it from the official repo.

Start here

Website ↗affine.proThe project's own site.Docs ↗docs.affine.proLinked from the README.In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

macOS Windows Linux

Download for macOS

2026.11.7-canary.904 (pre-release) · 11/7/2026 ↗

affine-2026.11.7-canary.904-canary-macos-arm64.dmg

dmg · Apple Silicon · 169.4 MB · 1 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/toeverything/AFFiNE/releases/download/v2026.11.7-canary.904/affine-2026.11.7-canary.904-canary-macos-arm64.dmg"
open "affine-2026.11.7-canary.904-canary-macos-arm64.dmg"

Other macOS downloads (3)

affine-2026.11.7-canary.904-canary-macos-arm64.zip

zip · Apple Silicon · 209.2 MB · 1 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/toeverything/AFFiNE/releases/download/v2026.11.7-canary.904/affine-2026.11.7-canary.904-canary-macos-arm64.zip"
unzip "affine-2026.11.7-canary.904-canary-macos-arm64.zip"

affine-2026.11.7-canary.904-canary-macos-x64.dmg

dmg · Intel · 182.3 MB · 1 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/toeverything/AFFiNE/releases/download/v2026.11.7-canary.904/affine-2026.11.7-canary.904-canary-macos-x64.dmg"
open "affine-2026.11.7-canary.904-canary-macos-x64.dmg"

affine-2026.11.7-canary.904-canary-macos-x64.zip

zip · Intel · 216.9 MB · 1 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/toeverything/AFFiNE/releases/download/v2026.11.7-canary.904/affine-2026.11.7-canary.904-canary-macos-x64.zip"
unzip "affine-2026.11.7-canary.904-canary-macos-x64.zip"

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 22.23.4runtime
1×Rust 1.97.1runtime
1×yarn yarn@4.18.0package manager

4× settings in .env

DB_VERSION
DB_PASSWORDsecret
DB_USERNAME
DB_DATABASE_NAME

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/toeverything/AFFiNE/badge.svg)](https://gitmanual.com/toeverything/AFFiNE)

Good to know

Monorepo (workspaces) — install from the repo root.
Cargo workspace — pick a crate with cargo run -p <name>.
Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Nested projects: blocksuite/affine/all/package.json, blocksuite/affine/blocks/attachment/package.json, blocksuite/affine/blocks/bookmark/package.json, blocksuite/affine/blocks/callout/package.json and 11 more

package.json scripts (15)

affiner affine.ts
afr affine.ts
devyarn affine dev
buildyarn affine build
lint:formatoxfmt --check .
lint:format:fixoxfmt --write .
lint:oxoxlint --deny-warnings
lint:ox:fixyarn lint:ox --fix
lintyarn lint:ox && yarn lint:format
lint:fixyarn lint:ox:fix && yarn lint:format:fix
testvitest --run
test:uivitest --ui
test:coveragevitest run --coverage
typechecktsc -b tsconfig.json --verbose
postinstallyarn affine init && yarn husky

Files we read (14)

.devcontainer/devcontainer.json

.docker/dev/.env.example

.github/workflows/auto-labeler.yml

.github/workflows/build-images.yml

.github/workflows/build-test.yml

.github/workflows/copilot-test-automatically.yml

.github/workflows/copilot-test.yml

.github/workflows/pr-title-lint.yml

.nvmrc

Cargo.toml

README.md

docs/BUILDING.md

package.json

rust-toolchain.toml

Branch canary · 10,241 files in the repo