Open-Notebook Roadmap: Upcoming Features and Development Plan

The open-notebook roadmap outlines four major upcoming features—live front-end updates, async processing, cross-notebook sources, and bookmark integration—alongside recently completed milestones like the Next.js frontend and REST API, all documented in the repository's README.md.

Open Notebook is an open-source research platform built on a three-tier architecture that separates concerns between the user interface, API layer, and data store. The project maintains a public roadmap in the top-level README.md under the "## 🗺️ Roadmap" section (lines 776-785), which serves as the canonical source for development priorities. This living document tracks both recently shipped capabilities and planned enhancements that extend the platform's AI-powered research capabilities.

Where to Find the Open-Notebook Roadmap

The roadmap lives in the repository's central documentation file. According to the source code analysis, the specific section spans lines 776-785 in README.md, where you will find a structured breakdown of upcoming features and completed milestones.

To view the roadmap directly in your browser, navigate to:

open "https://github.com/lfnovo/open-notebook/blob/main/README.md#L776"

Or retrieve it programmatically via the GitHub API:

import requests
import re

url = "https://api.github.com/repos/lfnovo/open-notebook/contents/README.md"
resp = requests.get(url, headers={"Accept": "application/vnd.github.v3.raw"})
readme = resp.text

# Extract the roadmap markdown block

roadmap = re.search(r"## 🗺️ Roadmap(.*?)(?:\n##|$)", readme, re.DOTALL).group(1)

print(roadmap.strip())

Three-Tier Architecture Supporting the Roadmap

Understanding the open-notebook roadmap requires familiarity with the system's architectural foundation. The project is explicitly designed as three distinct layers that interact through well-defined interfaces.

Frontend Layer

The frontend is a modern Next.js 16 / React 19 application located in the frontend/ directory. It uses Zustand for state management and TanStack Query for data fetching, providing the responsive interface necessary for the upcoming live update features.

API Layer

The API consists of an asynchronous FastAPI service housed in api/ and open_notebook/. This layer exposes a full REST interface, drives LangGraph workflows, and handles AI-provider orchestration through the Esperanto library. Files like api/search_service.py demonstrate the endpoint patterns that will benefit from async processing improvements.

Database Layer

SurrealDB runs as a graph database container, storing notebooks, sources, notes, and vector embeddings for semantic search. This graph structure enables the complex relationships required for upcoming cross-notebook source sharing.

Upcoming Features on the Open-Notebook Roadmap

The roadmap specifies four priority features currently in development. These items represent the core focus for upcoming releases.

Live Front-End Updates

Real-time UI refreshes will allow changes in the backend to appear instantly in the browser. This eliminates manual refresh requirements when AI processes complete or collaborators make edits.

Async Processing

Heavy content-ingestion and transformation tasks will shift to background workers. This architectural improvement will create a snappier UI experience by decoupling long-running operations from synchronous API responses.

Cross-Notebook Sources

Users will gain the ability to share and reuse source material across multiple notebooks. This feature leverages the underlying SurrealDB graph relationships to link sources to multiple notebook entities without duplication.

Bookmark Integration

Sync capabilities with popular bookmarking services will allow direct import of saved URLs. This streamlines the research workflow by bridging external knowledge management tools with the open-notebook ecosystem.

Recently Completed Milestones

The roadmap documents several major achievements already shipped to production:

• Next.js Frontend: Complete migration to the modern React 19-based frontend stack
• Comprehensive REST API: Full API coverage with FastAPI and async support
• Multi-Model AI Support: Integration of multiple AI providers through the Esperanto library
• Advanced Podcast Generator: AI-powered audio content generation from notebook sources
• Richer Citation Handling: Improved academic and web citation formatting

These completed items form the foundation upon which the upcoming roadmap features will be built.

How to Query the Roadmap Programmatically

For CI/CD pipelines or automated documentation checks, you can extract roadmap data without manual browsing:

# View the roadmap directly in terminal using curl and grep

curl -s https://raw.githubusercontent.com/lfnovo/open-notebook/main/README.md \
  | grep -A20 "## 🗺️ Roadmap"

This command fetches the raw README content and filters for the roadmap section, useful for automated changelog generation or compliance checking.

Key Files Related to Roadmap Implementation

The following source files are central to roadmap development and will see active modification as features progress:

• README.md: Central project overview containing the roadmap section (lines 776-892)
• CLAUDE.md: Architectural guide for contributors detailing frontend, API, and database patterns
• CONFIGURATION.md: Environment-variable definitions and model configuration for upcoming AI features
• docs/7-DEVELOPMENT/maintainer-guide.md: Detailed maintainer guide referencing roadmap priorities
• api/search_service.py: FastAPI endpoint example that will utilize async processing improvements
• frontend/next.config.ts: Frontend configuration file that will evolve with live-update capabilities

Summary

• The open-notebook roadmap is maintained in README.md lines 776-785 and tracks both completed and upcoming work.
• The architecture consists of a Next.js 16 frontend, FastAPI backend, and SurrealDB graph database.
• Four major features are planned: live front-end updates, async processing, cross-notebook sources, and bookmark integration.
• Recently completed milestones include the Next.js migration, REST API completion, and multi-model AI support.
• Contributors can programmatically access roadmap data via the GitHub API or raw file URLs for automation.

Frequently Asked Questions

Where is the open-notebook roadmap documented?

The roadmap is documented in the repository's README.md file under the "## 🗺️ Roadmap" heading, specifically between lines 776-785. This section contains a feature matrix outlining upcoming development priorities and recently completed milestones.

What are the priority features coming to open-notebook?

The roadmap prioritizes four features: Live Front-End Updates for real-time UI synchronization, Async Processing for background task handling, Cross-Notebook Sources for sharing materials across notebooks, and Bookmark Integration for importing external saved URLs.

How does the three-tier architecture support the roadmap?

The separation of frontend (Next.js/React), API (FastAPI/LangGraph), and database (SurrealDB) layers enables independent development of roadmap features. For example, async processing improvements target the API layer while live updates involve both the frontend and API communication patterns.

How can I programmatically check the roadmap status?

You can query the roadmap using the GitHub Contents API to retrieve README.md, then parse the markdown for the "## 🗺️ Roadmap" section. Alternatively, use curl with grep to filter the raw file content directly in shell scripts or CI pipelines.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}