# pyobservablejs

> Reactive Observable notebooks from Python

This file contains links to documentation sections following the llmstxt.org standard.

## Table of Contents

- [Examples](/pyobservablejs/examples/): Complete notebooks for data, shared inputs, composed views, and local files.
- [Load an existing notebook with local files](/pyobservablejs/examples/notebook-with-files/): Load Notebook Kit HTML from disk and embed its FileAttachment data.
- [Coordinate Python and browser inputs](/pyobservablejs/examples/python-and-browser-inputs/): Drive one chart from a marimo control and an Observable input, and read state back.
- [Python data to an interactive chart](/pyobservablejs/examples/python-data-and-chart/): Publish Python records as a graph variable and explore them with an Observable input.
- [Split one notebook into several views](/pyobservablejs/examples/split-notebook-views/): Mount focused views side by side and drive them from one Python control.
- [Use pyobservablejs with agents](/pyobservablejs/guide/agents/): Read the packaged Agent Skill and discover it from an optional marimo code-mode session.
- [Choose a library](/pyobservablejs/guide/choose-a-library/): Compare pyobservablejs and pyobsplot by the unit you want to render.
- [Read browser results](/pyobservablejs/guide/connect/browser-results/): Read pending, successful, and failed cell results from one view state.
- [Inspect dependencies](/pyobservablejs/guide/connect/dependencies/): Inspect keyed cells, variable dependencies, and diagram exports.
- [Send Python values](/pyobservablejs/guide/connect/python-values/): Publish Python values and update the reactive browser graph.
- [Share inputs across Python and Observable](/pyobservablejs/guide/connect/shared-inputs/): Set one named browser input from Python and read browser changes back.
- [Author notebook cells](/pyobservablejs/guide/create/cells/): Create Notebook Kit cells with obs.js, obs.ojs, obs.md, and obs.html.
- [Add files and local modules](/pyobservablejs/guide/create/files-and-modules/): Register FileAttachment files and embed local JavaScript modules.
- [Load Notebook Kit HTML](/pyobservablejs/guide/create/notebook-kit-html/): Create source-backed notebooks from Notebook Kit HTML strings.
- [Import ObservableHQ notebooks](/pyobservablejs/guide/create/observable-notebooks/): Fetch public observablehq.com notebooks and render them from Python.
- [Browser execution and network access](/pyobservablejs/guide/customize/browser-execution/): Runtime profiles, builtins, module imports, and the network boundary.
- [Export Notebook Kit HTML](/pyobservablejs/guide/customize/export-html/): Serialize notebooks to Notebook Kit documents and round-trip them.
- [Style notebooks and show source](/pyobservablejs/guide/customize/themes-and-source/): Apply Notebook Kit themes and show selected pinned cell source.
- [Select cells](/pyobservablejs/guide/display/cells/): Render keyed cells and run the cells they depend on.
- [Compose views](/pyobservablejs/guide/display/compose-views/): Place independent views from one shared notebook controller.
- [Display a notebook](/pyobservablejs/guide/display/notebooks/): Mount NotebookView in anywidget hosts and manage each browser runtime.
- [How pyobservablejs works](/pyobservablejs/guide/how-it-works/): Notebook controllers, cell identity, browser runtimes, and state snapshots.
- [Quickstart](/pyobservablejs/guide/quickstart/): Render a keyed notebook, update a variable, and read structured results.
- [Troubleshooting](/pyobservablejs/guide/troubleshooting/): Symptoms, causes, and fixes for common pyobservablejs failures.
- [Cell helpers](/pyobservablejs/reference/cell-helpers/): Authored Cell identity, source modes, and Notebook Kit metadata.
- [File attachments](/pyobservablejs/reference/file-attachments/): files mappings, local path resolution, FileAttachment access, and source HTML discovery.
- [API reference](/pyobservablejs/reference/): Public Python API reference for pyobservablejs.
- [NotebookView and NotebookCell](/pyobservablejs/reference/notebook-view-and-cell/): Renderable views, cell handles, and observable browser state.
- [Notebook](/pyobservablejs/reference/notebook/): Notebook construction, keyed views, controller state, and mutation methods.
- [Source constructors](/pyobservablejs/reference/source-constructors/): Contracts for Notebook Kit HTML and ObservableHQ notebook sources.
- [Themes](/pyobservablejs/reference/themes/): Notebook Kit theme names accepted by pyobservablejs.
- [observablejs.types](/pyobservablejs/reference/types/): Typed input mappings, selector aliases, and immutable state records.
- [View state and graph](/pyobservablejs/reference/values-and-graph/): Browser progress, structured cell results, errors, and dependencies.
- [Variables and serialization](/pyobservablejs/reference/variables-and-serialization/): Mapping-only variable updates, read-only snapshots, and browser value conversion.