holoviz-mcp 0.4.0__py3-none-any.whl

holoviz_mcp/config/models.py

@@ -0,0 +1,208 @@
+"""Configuration models for HoloViz MCP server."""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Literal
+from typing import Optional
+from typing import Union
+
+from pydantic import AnyHttpUrl
+from pydantic import BaseModel
+from pydantic import ConfigDict
+from pydantic import Field
+from pydantic import PositiveInt
+from pydantic import field_validator
+
+
+def _holoviz_mcp_user_dir() -> Path:
+    """Get the default user directory for HoloViz MCP."""
+    return Path(os.environ.get("HOLOVIZ_MCP_USER_DIR", Path.home() / ".holoviz-mcp"))
+
+
+def _holoviz_mcp_default_dir() -> Path:
+    """Get the default configuration directory for HoloViz MCP."""
+    return Path(os.environ.get("HOLOVIZ_MCP_DEFAULT_DIR", Path(__file__).parent.parent / "config"))
+
+
+class FolderConfig(BaseModel):
+    """Configuration for a folder within a repository."""
+
+    url_path: str = Field(default="", description="URL path mapping for this folder (e.g., '' for root, '/reference' for reference docs)")
+
+
+class GitRepository(BaseModel):
+    """Configuration for a Git repository."""
+
+    url: AnyHttpUrl = Field(..., description="Git repository URL")
+    branch: Optional[str] = Field(default=None, description="Git branch to use")
+    tag: Optional[str] = Field(default=None, description="Git tag to use (e.g., '1.7.2')")
+    commit: Optional[str] = Field(default=None, description="Git commit hash to use")
+    folders: Union[list[str], dict[str, FolderConfig]] = Field(
+        default_factory=lambda: {"doc": FolderConfig()},
+        description="Folders to index within the repository. Can be a list of folder names or a dict mapping folder names to FolderConfig objects",
+    )
+    base_url: AnyHttpUrl = Field(..., description="Base URL for documentation links")
+    url_transform: Literal["holoviz", "plotly", "datashader"] = Field(
+        default="holoviz",
+        description="""How to transform file path into URL:
+
+        - holoViz transform suffix to .html: filename.md -> filename.html
+        - plotly transform suffix to /: filename.md -> filename/
+        - datashader removes leading index and transform suffix to .html: 01_filename.md -> filename.html
+        """,
+    )
+    reference_patterns: list[str] = Field(
+        default_factory=lambda: ["examples/reference/**/*.md", "examples/reference/**/*.ipynb"], description="Glob patterns for reference documentation files"
+    )
+
+    @field_validator("tag")
+    @classmethod
+    def validate_tag(cls, v):
+        """Validate git tag format, allowing both 'v1.2.3' and '1.2.3' formats."""
+        if v is not None and v.startswith("v"):
+            # Allow tags like 'v1.7.2' but also suggest plain version numbers
+            pass
+        return v
+
+    @field_validator("folders")
+    @classmethod
+    def validate_folders(cls, v):
+        """Validate and normalize folders configuration."""
+        if isinstance(v, list):
+            # Convert list to dict format for backward compatibility
+            return {folder: FolderConfig() for folder in v}
+        elif isinstance(v, dict):
+            # Ensure all values are FolderConfig objects
+            result = {}
+            for folder, config in v.items():
+                if isinstance(config, dict):
+                    result[folder] = FolderConfig(**config)
+                elif isinstance(config, FolderConfig):
+                    result[folder] = config
+                else:
+                    raise ValueError(f"Invalid folder config for '{folder}': must be dict or FolderConfig")
+            return result
+        else:
+            raise ValueError("folders must be a list or dict")
+
+    def get_folder_names(self) -> list[str]:
+        """Get list of folder names for backward compatibility."""
+        if isinstance(self.folders, dict):
+            return list(self.folders.keys())
+        return self.folders
+
+    def get_folder_url_path(self, folder_name: str) -> str:
+        """Get URL path for a specific folder."""
+        if isinstance(self.folders, dict):
+            folder_config = self.folders.get(folder_name)
+            if folder_config:
+                return folder_config.url_path
+        return ""
+
+
+class DocsConfig(BaseModel):
+    """Configuration for documentation repositories."""
+
+    repositories: dict[str, GitRepository] = Field(default_factory=dict, description="Dictionary mapping package names to repository configurations")
+    index_patterns: list[str] = Field(
+        default_factory=lambda: ["**/*.md", "**/*.rst", "**/*.txt"], description="File patterns to include when indexing documentation"
+    )
+    exclude_patterns: list[str] = Field(
+        default_factory=lambda: ["**/node_modules/**", "**/.git/**", "**/build/**"], description="File patterns to exclude when indexing documentation"
+    )
+    max_file_size: PositiveInt = Field(
+        default=1024 * 1024,  # 1MB
+        description="Maximum file size in bytes to index",
+    )
+    update_interval: PositiveInt = Field(
+        default=86400,  # 24 hours
+        description="How often to check for updates in seconds",
+    )
+
+
+class ResourceConfig(BaseModel):
+    """Configuration for resources (best practices, etc.)."""
+
+    search_paths: list[Path] = Field(default_factory=list, description="Additional paths to search for resources")
+
+
+class PromptConfig(BaseModel):
+    """Configuration for prompts."""
+
+    search_paths: list[Path] = Field(default_factory=list, description="Additional paths to search for prompts")
+
+
+class ServerConfig(BaseModel):
+    """Configuration for the MCP server."""
+
+    name: str = Field(default="holoviz-mcp", description="Server name")
+    version: str = Field(default="1.0.0", description="Server version")
+    description: str = Field(default="Model Context Protocol server for HoloViz ecosystem", description="Server description")
+    log_level: Literal["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"] = Field(default="INFO", description="Logging level")
+    transport: Literal["stdio", "http"] = Field(default="stdio", description="Transport protocol for MCP communication")
+    host: str = Field(default="127.0.0.1", description="Host address to bind to when using HTTP transport (use 0.0.0.0 for Docker)")
+    port: int = Field(default=8000, description="Port to bind to when using HTTP transport")
+    anonymized_telemetry: bool = Field(default=False, description="Enable anonymized telemetry")
+    jupyter_server_proxy_url: str = Field(default="", description="Jupyter server proxy URL for Panel app integration")
+    vector_db_path: Path = Field(
+        default_factory=lambda: (_holoviz_mcp_user_dir() / "vector_db" / "chroma").expanduser(), description="Path to the Chroma vector database."
+    )
+
+
+class HoloVizMCPConfig(BaseModel):
+    """Main configuration for HoloViz MCP server."""
+
+    server: ServerConfig = Field(default_factory=ServerConfig)
+    docs: DocsConfig = Field(default_factory=DocsConfig)
+    resources: ResourceConfig = Field(default_factory=ResourceConfig)
+    prompts: PromptConfig = Field(default_factory=PromptConfig)
+
+    # Environment paths - merged from EnvironmentConfig with defaults
+    user_dir: Path = Field(default_factory=_holoviz_mcp_user_dir, description="User configuration directory")
+    default_dir: Path = Field(default_factory=_holoviz_mcp_default_dir, description="Default configuration directory")
+    repos_dir: Path = Field(default_factory=lambda: _holoviz_mcp_user_dir() / "repos", description="Repository download directory")
+
+    model_config = ConfigDict(extra="forbid", validate_assignment=True)
+
+    def config_file_path(self, location: Literal["user", "default"] = "user") -> Path:
+        """Get the path to the configuration file.
+
+        Args:
+            location: Whether to get user or default config file path
+        """
+        if location == "user":
+            return self.user_dir / "config.yaml"
+        else:
+            return self.default_dir / "config.yaml"
+
+    def resources_dir(self, location: Literal["user", "default"] = "user") -> Path:
+        """Get the path to the resources directory.
+
+        Args:
+            location: Whether to get user or default resources directory
+        """
+        if location == "user":
+            return self.user_dir / "config" / "resources"
+        else:
+            return self.default_dir / "resources"
+
+    def prompts_dir(self, location: Literal["user", "default"] = "user") -> Path:
+        """Get the path to the prompts directory.
+
+        Args:
+            location: Whether to get user or default prompts directory
+        """
+        if location == "user":
+            return self.user_dir / "config" / "prompts"
+        else:
+            return self.default_dir / "prompts"
+
+    def best_practices_dir(self, location: Literal["user", "default"] = "user") -> Path:
+        """Get the path to the best practices directory.
+
+        Args:
+            location: Whether to get user or default best practices directory
+        """
+        return self.resources_dir(location) / "best-practices"

holoviz_mcp/config/resources/best-practices/holoviews.md

@@ -0,0 +1,423 @@
+---
+name: holoviews-development
+description: HoloViews provides a powerful set of features for interactive, complex and publication-quality visualizations.
+metadata:
+  version: "1.0.0"
+  author: holoviz
+  category: data-visualization
+  difficulty: intermediate
+---
+
+
+# hvPlot Development Skill
+
+This document provides best practices for developing plots and charts with HoloViz HoloViews in notebooks and .py files.
+
+Please develop as an **Expert Python Developer** developing advanced data-driven, analytics and testable data visualisations, dashboards and applications would do. Keep the code short, concise, documented, testable and professional.
+
+## Dependencies
+
+Core dependencies provided with the `holoviews` Python package:
+
+- **holoviews**: Declarative data visualization library with composable elements. Best for: complex multi-layered plots, advanced interactivity (linked brushing, selection), when you need fine control over plot composition, scientific visualizations. More powerful but steeper learning curve than hvPlot. hvPlot is built upon holoviews.
+- **colorcet**: Perceptually uniform colormaps
+- **panel**: Provides widgets and layouts enabling tool, dashboard and data app development.
+- **param**: A declarative approach to creating classes with typed, validated, and documented parameters. Fundamental to the reactive programming model of hvPlot and the rest of the HoloViz ecosystem.
+- **pandas**: Industry-standard DataFrame library for tabular data. Best for: data cleaning, transformation, time series analysis, datasets that fit in memory. The default choice for most data work.
+
+Optional dependencies from the HoloViz Ecosystem:
+
+- **hvplot**: Easy to use plotting library with Pandas `.plot` like API. Built on top of HoloViews.
+- **datashader**: Renders large datasets (millions+ points) into images for visualization. Best for: big data visualization, geospatial datasets, scatter plots with millions of points, heatmaps of dense data. Requires hvPlot or HoloViews as frontend.
+- **geoviews**: Geographic data visualization with map projections and tile sources. Best for: geographic/geospatial plots, map-based dashboards, when you need coordinate systems and projections. Built on HoloViews, works seamlessly with hvPlot.
+- **holoviz-mcp**: Model Context Protocol server for HoloViz ecosystem. Provides access to detailed documentation, component search and best practices.
+- **hvsampledata**: Shared datasets for the HoloViz projects.
+
+Optional dependencies from the wider PyData Ecosystem:
+
+- **dask**: Parallel computing library for scaling Pandas DataFrames beyond memory. Best for: processing datasets larger than RAM, parallel computation across multiple cores/machines, lazy evaluation workflows.
+- **duckdb**: High-performance analytical SQL database. Best for: fast SQL queries on DataFrames, aggregations on large datasets, when you need SQL interface, OLAP-style analytics. Much faster than Pandas for analytical queries.
+- **matplotlib**: Low-level, highly customizable plotting library. Best for: publication-quality static plots, fine-grained control over every aspect of visualization, scientific plots, when you need pixel-perfect control.
+- **Plotly**: Interactive, publication-quality visualization library. Best for: 3D plots, complex interactive charts, animations, when you need hover tooltips and interactivity. Works well with Dash and Panel.
+- **polars**: Modern, fast DataFrame library written in Rust. Best for: high-performance data processing, datasets that fit in memory but need speed, when you need lazy evaluation, better memory efficiency than Pandas.
+- **xarray**: N-dimensional labeled arrays and datasets. Best for: multidimensional scientific data (climate, satellite imagery), data with multiple dimensions and coordinates, NetCDF/HDF5 files, geospatial raster data.
+
+## Installation for Development
+
+```bash
+pip install holoviews hvsampledata panel watchfiles
+```
+
+For development in .py files DO always include watchfiles for Panel hotreload.
+
+## Earthquake Sample Data
+
+In the example below we will use the `earthquakes` sample data:
+
+```python
+import hvsampledata
+
+hvsampledata.earthquakes("pandas")
+```
+
+```text
+Tabular record of earthquake events from the USGS Earthquake Catalog that provides detailed
+information including parameters such as time, location as latitude/longitude coordinates
+and place name, depth, and magnitude. The dataset contains 596 events.
+
+Note: The columns `depth_class` and `mag_class` were created by categorizing numerical values from
+the `depth` and `mag` columns in the original dataset using custom-defined binning:
+
+Depth Classification
+
+| depth     | depth_class  |
+|-----------|--------------|
+| Below 70  | Shallow      |
+| 70 - 300  | Intermediate |
+| Above 300 | Deep         |
+
+Magnitude Classification
+
+| mag         | mag_class |
+|-------------|-----------|
+| 3.9 - <4.9  | Light     |
+| 4.9 - <5.9  | Moderate  |
+| 5.9 - <6.9  | Strong    |
+| 6.9 - <7.9  | Major     |
+
+
+Schema
+------
+| name        | type       | description                                                         |
+|:------------|:-----------|:--------------------------------------------------------------------|
+| time        | datetime   | UTC Time when the event occurred.                                   |
+| lat         | float      | Decimal degrees latitude. Negative values for southern latitudes.   |
+| lon         | float      | Decimal degrees longitude. Negative values for western longitudes   |
+| depth       | float      | Depth of the event in kilometers.                                   |
+| depth_class | category   | The depth category derived from the depth column.                   |
+| mag         | float      | The magnitude for the event.                                        |
+| mag_class   | category   | The magnitude category derived from the mag column.                 |
+| place       | string     | Textual description of named geographic region near to the event.   |
+```
+
+## Reference Data Exploration Example
+
+Below is a simple reference example for data exploration.
+
+```python
+import hvsampledata
+# DO import panel if working in .py files
+import panel as pn
+# Do importing hvplot.pandas to add .hvplot namespace to Pandas DataFrames and Series
+import holoviews as hv
+
+# DO always run pn.extension() to load panel javascript extensions
+pn.extension()
+
+# Do keep the extraction, transformation and plotting of data clearly separate
+# Extract: earthquakes sample data
+data = hvsampledata.earthquakes("pandas")
+
+# Transform: Group by mag_class and count occurrences
+mag_class_counts = data.groupby('mag_class').size().reset_index(name='counts')
+
+# Plot: counts by mag_class
+plot = hv.Bars(mag_class_counts, kdims='mag_class', vdims='counts').opts(title='Earthquake Counts by Magnitude Class')
+# If working in notebook DO output to plot:
+plot
+# Else if working in .py file DO:
+# DO provide a method to serve the app with `panel serve`
+if pn.state.served:
+    # DO remember to add .servable to the panel components you want to serve with the app
+    pn.panel(plot, sizing_mode="stretch_both").servable()
+# DON'T provide a `if __name__ == "__main__":` method to serve the app with `python`
+```
+
+If working in a .py file DO serve the plot with hotreload:
+
+```bash
+panel serve path/to/file.py --dev --show
+```
+
+DONT serve with `python path_to_this_file.py`.
+
+## Reference Publication Quality Bar Chart
+
+```python
+# ============================================================================
+# Publication-Quality Bar Chart - HoloViews Best Practices Example
+# ============================================================================
+# Demonstrates:
+# - Data extraction, transformation, and visualization separation
+# - Custom Bokeh themes for consistent styling
+# - Interactive tooltips with formatted data
+# - Text annotations on bars
+# - Professional fonts, grids, and axis formatting
+# - Panel integration for web serving
+# ============================================================================
+
+import hvsampledata
+import panel as pn
+from bokeh.models.formatters import NumeralTickFormatter
+from bokeh.themes import Theme
+
+import holoviews as hv
+from holoviews.plotting.bokeh import ElementPlot
+
+# ============================================================================
+# BOKEH THEME SETUP - Define global styling
+# ============================================================================
+
+ACCENT_COLOR = '#007ACC'  # Professional blue
+FONT_FAMILY = 'Roboto'
+
+def create_bokeh_theme(font_family=FONT_FAMILY, accent_color=ACCENT_COLOR):
+    """Create custom theme with specified font. Default: Roboto"""
+    return Theme(json={
+        'attrs': {
+            'Title': {
+                'text_font': font_family,
+                'text_font_size': '16pt',
+                'text_font_style': 'bold'
+            },
+            'Axis': {
+                'axis_label_text_font': font_family,
+                'axis_label_text_font_size': '12pt',
+                'axis_label_text_font_style': 'bold',
+                'major_label_text_font': font_family,
+                'major_label_text_font_size': '10pt',
+                'major_tick_line_color': "black",  # Remove tick marks
+                'minor_tick_line_color': None
+            },
+            'Plot': {
+                'background_fill_color': '#fafafa',
+                'border_fill_color': '#fafafa'
+            },
+            'Legend': {
+                'label_text_font': font_family,
+                'label_text_font_size': '10pt'
+            },
+            'Toolbar': {
+                "autohide": True,
+                "logo": None,
+                "stylesheets": [
+                    f"""
+                    .bk-OnOffButton.bk-active{{
+                        border-color: {accent_color} !important;
+                    }}
+                    """
+                ]
+            },
+            # Does not work via Theme, so added here for reference purposes until I figure out how to do it
+            'Tooltip': {
+                "stylesheets": [f"""
+                    .bk-tooltip-row-label {{
+                        color: {ACCENT_COLOR} !important;
+            }}"""]
+
+            }
+        }
+    })
+
+# Apply theme globally - affects all plots
+hv.renderer('bokeh').theme = create_bokeh_theme()
+
+# ============================================================================
+# HOLOVIEWS OPTS SETUP - Define global configuration
+# ============================================================================
+
+GLOBAL_BACKEND_OPTS={
+    'plot.xgrid.visible': False,           # Only horizontal grid lines
+    'plot.ygrid.visible': True,
+    'plot.ygrid.grid_line_color': "black",
+    'plot.ygrid.grid_line_alpha': 0.1,
+    'plot.min_border_left': 80,            # Add padding on left (for y-axis label)
+    'plot.min_border_bottom': 80,          # Add padding on bottom (for x-axis label)
+    'plot.min_border_right': 30,           # Add padding on right
+    'plot.min_border_top': 80,             # Add padding on top
+}
+
+ElementPlot.param.backend_opts.default = GLOBAL_BACKEND_OPTS
+ElementPlot.param.yformatter.default = NumeralTickFormatter(format='0a')  # 1k, ...
+
+hv.opts.defaults(
+    hv.opts.Bars(
+        color=ACCENT_COLOR,           # Professional blue
+        line_color=None,            # Remove bar borders
+    ),
+    hv.opts.Labels(
+        text_baseline='bottom',
+        text_font_size='11pt',
+        text_font_style='normal',
+        text_color='#333333',
+    ),
+)
+hv.Cycle.default_cycles["default_colors"] = [ACCENT_COLOR, '#00948A', '#7E59BD', '#FFA20C', '#DA4341', '#D6F1FF', '#DAF5F4', '#F0E8FF', '#FFF8EA', '#FFF1EA', '#001142', '#003336', '#290031', '#371F00', '#3A0C13']
+
+# ============================================================================
+# DATA PIPELINE - Separate extraction, transformation, and plotting
+# ============================================================================
+
+def get_earthquake_data():
+    """Extract raw earthquake data from sample dataset"""
+    return hvsampledata.earthquakes("pandas")
+
+
+def aggregate_by_magnitude(earthquake_data):
+    """Transform: Group earthquakes by magnitude class with statistics"""
+    # Aggregate: count events and calculate average depth per magnitude class
+    aggregated = (
+        earthquake_data
+        .groupby('mag_class', observed=True)
+        .agg({'mag': 'count', 'depth': 'mean'})
+        .reset_index()
+        .rename(columns={'mag': 'event_count', 'depth': 'avg_depth'})
+        .sort_values('event_count', ascending=False)
+    )
+
+    # Add percentage column for tooltips
+    aggregated['percentage'] = (
+        aggregated['event_count'] / aggregated['event_count'].sum() * 100
+    )
+
+    return aggregated
+
+
+def create_bar_chart(aggregated_data):
+    """Create publication-quality bar chart with labels and tooltips"""
+    default_tools=['save']
+
+    # Main bar chart with professional styling
+    bar_chart = hv.Bars(aggregated_data, kdims='mag_class', vdims=['event_count', 'percentage', 'avg_depth']).opts(
+        # Titles and labels
+        title='Earthquake Distribution by Magnitude',
+        xlabel='Magnitude',
+        ylabel='Number of Events',
+
+        # Interactivity
+        # hover_cols = ["mag_class", "event_count", "percentage", "avg_depth"],
+        hover_tooltips=[
+            ('Magnitude', '@mag_class'),
+            ('Events', '@event_count{0,0}'),      # Format: 1,234
+            ('Percentage', '@percentage{0 a}%'), # Format: 45%
+            ('Avg Depth', '@avg_depth{0f} km')  # Format: 99 km
+        ],
+        default_tools=default_tools
+    )
+
+    # Add text labels above bars
+    labels_data = aggregated_data.copy()
+    labels_data['label_y'] = labels_data['event_count'] + 20  # Offset above bars
+
+    text_labels = hv.Labels(labels_data, kdims=['mag_class', 'label_y'], vdims=['event_count', 'percentage', 'avg_depth']).opts(
+        hover_tooltips=[
+            ('Magnitude', '@mag_class'),
+            ('Events', '@event_count{0,0}'),      # Format: 1,234
+            # tooltips below do currently not work on Labels
+            # ('Percentage', '@percentage{0 a}%'), # Format: 45%
+            # ('Avg Depth', '@avg_depth{0f} km'),  # Format: 99 km
+        ],
+        default_tools=default_tools
+    )
+
+    # Overlay: bar chart * text labels
+    return bar_chart * text_labels
+
+
+def create_plot():
+    """Main function: Extract → Transform → Plot"""
+    # Extract: Get raw data
+    earthquake_data = get_earthquake_data()
+
+    # Transform: Aggregate and calculate statistics
+    aggregated = aggregate_by_magnitude(earthquake_data)
+
+    # Visualize: Create publication-quality chart
+    chart = create_bar_chart(aggregated)
+
+    return chart
+
+
+# ============================================================================
+# PANEL APP SETUP
+# ============================================================================
+
+# Serve the chart when running with Panel
+if pn.state.served:
+    # Load Panel JavaScript extensions
+    pn.extension()
+
+    # Apply custom Bokeh theme (override the global theme)
+    # Create and serve the chart
+    plot = create_plot()
+    pn.panel(plot, sizing_mode="stretch_both", margin=25).servable()
+```
+
+## General Instructions
+
+- In a notebook always run `hv.extension()` to load any Javascript dependencies.
+
+```python
+import holoviews as hv
+
+hv.extension()
+...
+```
+
+- Prefer Bokeh > Plotly > Matplotlib plotting backend for interactivity
+- DO use bar charts over pie Charts. Pie charts are not supported.
+- DO use NumeralTickFormatter and 'a' formatter for easy axis formatting:
+
+```python
+from bokeh.models.formatters import NumeralTickFormatter
+
+plot.opts(
+    yformatter=NumeralTickFormatter(format='0.00a'),  # Format as 1.00M, 2.50M, etc.
+)
+```
+
+
+| Input | Format String | Output |
+| - |  - | - |
+| 1230974 | '0.0a' | 1.2m |
+| 1460 | '0 a' | 1 k |
+| -104000 | '0a' | -104k |
+
+### Recommended Plot Types
+
+Curve - Line plots for time series and continuous data
+Scatter - Scatter plots for exploring relationships between variables
+Bars - Bar charts for categorical comparisons
+Histogram - Histograms for distribution analysis
+Area - Area plots for stacked or filled visualizations
+
+## Workflows
+
+### Lookup additional information
+
+- If the HoloViz MCP server is available DO use the HoloViz MCP server to access relevant documentation (`holoviz_search`), list of plot types available (`hvplot_list_plot_types`), and detailed docstrings (`hvplot_get_docstring`).
+- If the HoloViz MCP server is not available, DO search the web. For example searching the hvplot website for `streaming` related information via https://hvplot.holoviz.org/en/docs/latest/search.html?q=streaming url.
+
+### Test the app with pytest
+
+DO add tests to the `tests` folder and run them with `pytest tests/path/to/test_file.py`.
+
+- DO separate data extraction and transformation from plotting code.
+- DO fix any test errors and rerun the tests
+- DO run the tests and fix errors before displaying or serving the plots
+
+### Serve the plot with panel serve
+
+DO always start and keep running a development server `panel serve path_to_file.py --dev --show` with hot reload while developing!
+
+- Due to `--show` flag, a browser tab will automatically open showing your app.
+- Due to `--dev` flag, the panel server and app will automatically reload if you change the code.
+- The app will be served at http://localhost:5006/.
+- DO make sure the correct virtual environment is activated before serving the app.
+- DO fix any errors that show up in the terminal. Consider adding new tests to ensure they don't happen again.
+- DON'T stop or restart the server after changing the code. The app will automatically reload.
+- If you see 'Cannot start Bokeh server, port 5006 is already in use' in the terminal, DO serve the app on another port with `--port {port-number}` flag.
+- DO remind the user to test the plot on multiple screen sizes (desktop, tablet, mobile)
+- DON'T use legacy `--autoreload` flag
+- DON't run `python path_to_file.py` to test or serve the app.
+- DO use `pn.Column, pn.Tabs, pn.Accordion` to layout multiple plots