anyproto /anytype-ts

Official Anytype client for MacOS, Linux, and Windows

★ 9,099⑂ 607👁 33⑃ 1,768● 498▤ 304
TypeScriptNOASSERTIONCreated 2023-05-22anytype.io
More from this author
Download: v0.57.8-alphav0.57.8-alpha ↓v0.57.8-alpha2026-11-10
+5
Daily
9,099
stars
607
forks
33
watchers
1,768
prs
498
issues
304
releases

README

Anytype Desktop

 Local‑first, peer‑to‑peer & end‑to‑end‑encrypted knowledge OS for macOS, Windows & Linux.






Anytype is a personal knowledge base—your digital brain—that lets you gather, connect and remix all kinds of information. Create pages, tasks, wikis, journals—even entire apps—and define your own data model while your data stays offline‑first, private and encrypted across devices.


 ✨ Key Features

- Offline‑first, local storage with optional peer‑to‑peer sync.
- Zero‑knowledge encryption powered by any‑sync.
- Composable blocks: text, databases, kanban, calendar & custom Types.
- Cross‑platform desktop client built with Electron + TypeScript.
- Extensible through a gRPC API and AI "Agents" (see AGENTS.md).
- Open code under the Any Source Available License 1.0.

 📚 Table of Contents

- Quick Start
- Prerequisites
- Building from Source
- Development Workflow
  - Updating Middleware
  - Updating Protobuf Bindings
- Localisation
- Contributing
- Community & Support
- License


 🚀 Quick Start

Just want to try it? Grab the latest installer from the releases page or head to download.anytype.io and log in with your Any‑ID.

 🏗 Building from Source

On ARM systems, node package keytar needs to be rebuilt during installation, so make sure that your system has a C++ compiler, Python3 and Python package setuptools. E.g. on Debian/Ubuntu: sudo apt install python3-setuptools. Alternatively, on any system, create a Python virtual environment (venv) and inside the venv: pip install setuptools. Then build from source inside the venv.

Linux also needs the protobuf compiler with the well-known .proto files (used to generate the gRPC bindings in step 5):
- Fedora: sudo dnf install protobuf-compiler protobuf-devel jq
- Debian / Ubuntu: sudo apt install protobuf-compiler libprotobuf-dev jq

bash
 1 – Clone & open this repository
git clone https://github.com/anyproto/anytype-ts.git && cd anytype-ts

 2 - Install JavaScript dependencies
bun install

 3 – Fetch the prebuilt middleware binary + proto/JSON assets into dist/
./update.sh  

 4 – Build the core engine
cd .. && git clone https://github.com/anyproto/anytype-heart.git && cd anytype-heart
make install-dev-js CLIENT_DESKTOP_PATH=../anytype-ts && cd ../anytype-ts

 5 – Generate protobuf bindings (middleware/) + service registry (src/ts/lib/api/service.ts)
     From the anytype-heart checkout built in step 4:
bun run generate:protos
     …or, to skip the anytype-heart checkout entirely, generate from the assets fetched in step 3:
     bash scripts/generate-protos.sh --from-dist

 6 - Update locale
bun run update:locale

 7 – Build the Electron desktop app (see package.json for more options)
bun run dist:


 Steps 3–5 produce middleware/ and src/ts/lib/api/service.ts, which are git-ignored. Skipping step 5 causes Failed to resolve import "./service" from src/ts/lib/api/dispatcher.ts. See Updating Protobuf Bindings and scripts/README.md for details.

 Environment flags

| Variable                 | E

Top issues

Latest release

v0.57.8-alpha v0.57.8-alpha 2026-11-10
Summary: 0 tasks, 1 commits, 2 merged PRs

 Other Commits

- 72af77e 0.57.8-alpha

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON