hdsp-jupyter-extension 2.1.21

HDSP Agent JupyterLab Extension - Thin client for Agent Server

HDSP Jupyter Extension

JupyterLab extension for AI-powered code assistance with embedded agent services.

Architecture

This extension runs agent services in-process:

• Provides the JupyterLab frontend UI
• Handles Jupyter-specific integration (kernel communication, notebook manipulation)
• Runs LLM-based agent services directly via hdsp_agent_core

Prerequisites

• JupyterLab: Version 4.0 or higher

Installation

Development Installation

# Install dependencies
yarn install

# Build extension
yarn build

# Install in JupyterLab (development mode)
pip install -e .
jupyter labextension develop . --overwrite

Starting the Development Environment

cd extensions/jupyter
jupyter lab

Configuration

Configure LLM settings in ~/.jupyter/hdsp_agent_config.json:

{
  "provider": "vllm",
  "vllm": {
    "endpoint": "https://openrouter.ai/api/v1",
    "apiKey": "",
    "model": "openai/gpt-4o"
  }
}

Development

Watch Mode

# Terminal 1: Watch TypeScript
yarn watch:src

# Terminal 2: Watch labextension
yarn watch:labextension

Testing

# Run UI tests
yarn test:ui

# Run UI tests with browser visible
yarn test:ui:headed

License

MIT