Repolode
Submit
livebook-dev

livebook-dev/livebook

A web-based notebook for writing and running interactive, collaborative Elixir code with Markdown, charts and tables.

View on GitHubWebsite
Stars
5,911
Forks
527
Open issues
23
Last commit
2 days ago

What is it?

Livebook is a web application for writing code notebooks. Documents mix Markdown text with Code cells, and Elixir code runs on demand, so a reader can run, change and re-run each part of an analysis or document.

The editor is built on CodeMirror and offers autocompletion, inline documentation and code formatting. Results can be rendered as Vega-Lite charts, tables and maps through the Kino library. Smart cells provide form-based helpers for tasks such as querying databases or building charts. Livebook tracks which cells are stale and runs code in a predictable order, including package management. Several users can edit the same notebook at once.

Notebooks are saved as .livemd files, a Markdown subset that supports Mermaid diagrams and KaTeX formulas and works with version control. Code can run in a fresh Elixir instance, attach to an existing node, or run inside an existing Elixir project to use its modules and dependencies. It can be installed as a desktop app, run with Docker, or started from the Elixir escript or source.

Key features

  • 01Elixir code cells that evaluate on demand alongside Markdown text
  • 02CodeMirror-based editor with autocompletion and inline documentation
  • 03Interactive charts, tables and maps rendered through Kino and Vega-Lite
  • 04Smart cells for common tasks such as querying databases and plotting data
  • 05Real-time collaboration where several users edit one notebook
  • 06Notebooks saved as .livemd files that work with version control

Use cases

  • Exploring and visualizing data with Elixir
  • Documenting or introspecting an existing Elixir project with access to its modules
  • Writing shareable, runnable tutorials and guides
  • Running a team's analysis notebooks together on a shared server

Quick start

  1. 1

    Run Livebook with Docker using the default configuration

    docker run -p 8080:8080 -p 8081:8081 --pull always ghcr.io/livebook-dev/livebook
  2. 2

    Install Elixir v1.18 or later, then install the Livebook escript

    mix escript.install hex livebook
  3. 3

    Start the Livebook server

    livebook server

Things to know

  • Livebook runs arbitrary code, so anyone with access to an instance can run any code on the machine.
  • Direct installation requires Elixir v1.18 or later and several Erlang applications.

In collections

Data science courses & toolsStatic site generators & documentation tools

Topics

#elixir#notebooks#data-visualization#collaboration#markdown#liveview#charts#collaborative#distributed-computing#math

FAQ

What is livebook?
A web-based notebook for writing and running interactive, collaborative Elixir code with Markdown, charts and tables. Livebook is a web application for writing code notebooks. Documents mix Markdown text with Code cells, and Elixir code runs on demand, so a reader can run, change and re-run each part of an analysis or document.
Is livebook free to use? What license does it have?
livebook is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is livebook still maintained?
Actively maintained. The last commit to livebook was on Nov 6, 2026.
What can I use livebook for?
Exploring and visualizing data with Elixir Documenting or introspecting an existing Elixir project with access to its modules Writing shareable, runnable tutorials and guides Running a team's analysis notebooks together on a shared server
How do I install livebook?
Run Livebook with Docker using the default configuration: docker run -p 8080:8080 -p 8081:8081 --pull always ghcr.io/livebook-dev/livebook Install Elixir v1.18 or later, then install the Livebook escript: mix escript.install hex livebook Start the Livebook server: livebook server
Where can I get livebook?
The source code and installation instructions are on GitHub: https://github.com/livebook-dev/livebook

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

Related projects