Reading the repo

Opening the box…

How to install karakeep on macOS (karakeep-app/karakeep) · gitmanual

How to install on macOS

karakeep-app/karakeep

A self-hostable bookmark-everything app (links, notes and images) with AI-based automatic tagging and full text search

Node.js#bookmark-manager#bookmarks#bookmarks-manager#nextjs

Difficulty: Moderate
Time: about 15 min
Stars: ★ 30,338
Activity: Updated this month
License: AGPL-3.0
Open issues: 732
Got it running: Be the first
Looked up: 13 h ago

GitHub didn't answer, so this is the saved copy from 13 h ago

Start here

Website ↗karakeep.comThe project's own site.

Launch script in the repo

The maintainers included start-dev.sh. Run it from the cloned folder after reading it.

bash start-dev.sh

Will it work on my device?

Yes, it runs on macOS

You'll build it yourself with Node.js.

Checking for

macOS Windows Linux

6 steps on macOS

Download setup.sh

Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

Clone the repository

Needs Git: xcode-select --install

git clone https://github.com/karakeep-app/karakeep.git
cd karakeep

Install the required runtimes

Node.js 24

# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm)
nvm install
nvm use

3
Configure environment variables
Fill in secrets: MEILI_MASTER_KEY, NEXTAUTH_SECRET, KARAKEEP_API_KEY, OPENAI_API_KEY
```
cp .env.sample .env
```
4
Install dependencies
```
corepack enable
pnpm install
```
5
Run it
```
pnpm dev
```
6
Run the tests
```
pnpm test
```

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 24runtime
1×pnpm pnpm@11.28.9package manager

16× settings in .env

DATA_DIR
MEILI_ADDR
MEILI_MASTER_KEYsecret
NEXTAUTH_URL
NEXTAUTH_SECRETsecret
KARAKEEP_API_KEYsecret
KARAKEEP_SERVER_ADDR
COMPARISON_MODE
MODEL1_NAME
MODEL2_NAME
OPENAI_API_KEYsecret
OPENAI_BASE_URL
COMPARE_LIMIToptional
INFERENCE_CONTEXT_LENGTHoptional
INFERENCE_MAX_OUTPUT_TOKENSsecretoptional
INFERENCE_USE_MAX_COMPLETION_TOKENSsecretoptional

Share this manual

Is this your repo?

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

[![Setup manual](https://gitmanual.com/karakeep-app/karakeep/badge.svg)](https://gitmanual.com/karakeep-app/karakeep)

Good to know

Monorepo (workspaces) — install from the repo root.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: apps/browser-extension/package.json, apps/cli/package.json, apps/landing/package.json, apps/mcp/package.json and 11 more

package.json scripts (25)

buildturbo build
devturbo dev --parallel
cleangit clean -xdf node_modules
clean:workspacesturbo clean
db:generatepnpm --filter @karakeep/db run generate
db:migratepnpm --filter @karakeep/db run migrate
db:migrate:queuepnpm --filter @karakeep/workers run migrate:queue
db:studiopnpm --filter @karakeep/db studio
seed:applypnpm --filter @karakeep/seed-snapshot run apply
seed:snapshotpnpm --filter @karakeep/seed-snapshot run snapshot
workerspnpm --filter @karakeep/workers run start
webpnpm --filter @karakeep/web run dev
web:portlesspnpm --filter @karakeep/web run dev:portless
dev:worktreebash scripts/dev-worktree.sh
androidpnpm --filter @karakeep/mobile android
iospnpm --filter @karakeep/mobile ios
preparehusky
formatturbo format --continue
format:fixturbo format:fix --continue
lintturbo lint --continue
lint:fixturbo lint:fix --continue
testturbo test
typecheckturbo typecheck
preflightturbo run typecheck lint format
preflight:fixturbo run typecheck lint:fix format:fix

Files we read (14)

.env.sample

.github/workflows/android.yml

.github/workflows/chrome.yml

.github/workflows/ci.yml

.github/workflows/cli.yml

.github/workflows/docker.yml

.github/workflows/extension.yml

.nvmrc

CONTRIBUTING.md

README.md

docker/.env.sample

package.json

pnpm-workspace.yaml

tools/compare-models/.env.example

Branch main · 2,332 files in the repo

Opening the box…

Start here

Yes, it runs on macOS

6 steps on macOS

Clone the repository

Install the required runtimes

Configure environment variables

Install dependencies

Run it

Run the tests

Did you get it running?

Still stuck? Ask an AI