selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Srcbook logo

Self-host Srcbook

0.0.19

TypeScript notebook with AI that runs locally

AlphaOpen SourceApache-2.0
Updated3 months ago
LanguageTypescript
Setup difficultyEasy
Stars
3 437
Port
2150 (web interface)
Requires
SQLite (better-sqlite3)
Install with Docker

What is Srcbook?

Srcbook is a TypeScript notebook you run on your own machine. It provides a web-based interface where you create and execute notebooks backed by a local Node.js process, giving you full access to the file system, databases, and network. Notebooks can be exported as Markdown (.src.md) and shared. AI features assist with writing and editing code, though you must supply your own Anthropic API key. Mermaid diagramming adds visual annotations. Installation options include npx (always current), a global npm/pnpm install, or building the Docker image from source. The project uses a local SQLite database for persistence and collects optional usage analytics that can be disabled. The maintainers note the project is not under active development. Licensed Apache-2.0.

Should you self-host Srcbook?

Srcbook scores 51/100 on selfhost.directory (how scoring works) and ranks #72 of 166 in Developer Tools. It has 3 437 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. It is Apache-2.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is openhands (87/100, 92 079 stars). It scores higher overall, so compare the two before you pick. See Srcbook vs openhands side by side.

Features

  • AI-assisted codingRequires user-provided Anthropic API key
  • Export to Markdown
  • Local Node.js execution
  • Mermaid diagramming
  • Optional analytics opt-out
  • TypeScript notebooks

Srcbook README

How to install Srcbook

Install Srcbook with Docker

Docker

docker build -t srcbook . docker run -p 2150:2150 -v ~/.srcbook:/root/.srcbook -v ~/.npm:/root/.npm srcbook

Build image locally, then run container with persisted data and npm cache

How to configure Srcbook

  • SRCBOOK_DISABLE_ANALYTICSDisable behavioral analytics collection

    Disable behavioral analytics collection

    values: true/false

FAQ

Can I write React Components or other UI logic in Srcbook?

Currently no, because code runs in Node.js not the browser; UI component rendering is not supported yet but is being designed.

How is Srcbook different from Observable?

Srcbook runs code in Node.js (backend-capable) while Observable runs in the browser; Srcbook targets everyday software development (learning, exploring npm, testing APIs) while Observable targets data visualization and dashboards.

More in Notes & Editors

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…