Repolode
srcbookdev

srcbookdev/srcbook

A TypeScript notebook that runs locally on your machine, with a web interface and optional AI assistance.

Open-source alternative to:Jupyter Notebook

Stars
3,436
Forks
309
Open issues
32
Last commit
3 months ago

What is it?

Srcbook is a notebook for writing and running TypeScript code. It runs as a local CLI application that serves a web interface, so notebooks and execution stay on your own machine. Notebooks are stored as markdown files with the .src.md extension, which makes them readable and portable outside the app.

Beyond running code cells, Srcbook supports Mermaid diagrams for annotating notebooks and AI features for exploring and iterating on ideas. AI usage requires your own API key, and the project recommends Anthropic with claude-3-5-sonnet-latest. It can also be run in Docker, and it is installed and started through npx or a global npm install.

The project is Apache-2.0 licensed and the maintainers note that it is no longer under active development.

Key features

  • 01Create, run, and share TypeScript notebooks in the browser.
  • 02Save notebooks as markdown (.src.md) files.
  • 03Use AI features to explore and iterate on ideas, with your own API key.
  • 04Add Mermaid diagrams to annotate notebooks.
  • 05Run locally through a CLI-started web interface, with Docker support.

Use cases

  • Prototyping TypeScript or Node.js snippets and keeping the results alongside explanations.
  • Writing documented, runnable examples that can be shared as plain markdown files.
  • Exploring ideas with an AI assistant while keeping code execution local.

Quick start

  1. 1

    Check that Node 18+ and corepack are installed

  2. 2

    Run Srcbook with npx (always latest version)

    npx srcbook@latest start
  3. 3

    Open the web interface and set up your API key

Things to know

  • The maintainers state that Srcbook is not under active development.
  • You must bring your own API key to use the AI features.

Topics

FAQ

What is srcbook?
A TypeScript notebook that runs locally on your machine, with a web interface and optional AI assistance. Srcbook is a notebook for writing and running TypeScript code. It runs as a local CLI application that serves a web interface, so notebooks and execution stay on your own machine. Notebooks are stored as markdown files with the .src.md extension, which makes them readable and portable outside the app.
Is srcbook free to use? What license does it have?
srcbook is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is srcbook still maintained?
Updated within 6 months. The last commit to srcbook was on Jul 30, 2026.
What can I use srcbook for?
Prototyping TypeScript or Node.js snippets and keeping the results alongside explanations. Writing documented, runnable examples that can be shared as plain markdown files. Exploring ideas with an AI assistant while keeping code execution local.
How do I install srcbook?
Check that Node 18+ and corepack are installed Run Srcbook with npx (always latest version): npx srcbook@latest start Open the web interface and set up your API key
Where can I get srcbook?
The source code and installation instructions are on GitHub: https://github.com/srcbookdev/srcbook

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects