Pyplan Documentation
website·Indexed 33 days ago
https://docs.pyplan.comA platform for building data analytics and planning applications using a mix of no-code, low-code, and AI-driven workflows. Pyplan features a hierarchical influence diagram for code organization, a task manager for scheduled activities, and a Model Context Protocol (MCP) for AI client connectivity. The platform includes tools for manual data input, interface design with customizable components, and enterprise security management including SSO and role-based access control.
What's inside Pyplan
- The Index component in Pyplan allows users to filter or select one or multiple values from a predefined list of index values (such as dates, categories, or labels). It is primarily used to drive dynamic filtering in dashboards or interfaces by linking the component to nodes or data views to update content dynamically.
Overview of the HTML Visualization component
The HTML Visualization component is a data-bound tool that transforms the output of a Pyplan node into a custom HTML view rendered inside aniframe. Unlike static components, it reacts to changes in the Pyplan node and interface filters. It is ideal for bespoke KPI dashboards, styled summary cards, and mixed chart-and-table panels where full control over markup, CSS, and JavaScript is required.Overview of Pyplan Interfaces
An interface in Pyplan is a dashboard or screen used to visualize results, filter data, input information, and trigger actions. Technically, an interface is linked to a specific application version, consists of components arranged on a grid, and interacts with data via nodes in the influence diagram.Overview of Pyplan Application Structure
A Pyplan application is an analytical or planning solution consisting of two primary components:
- Code Side: Business logic organized as an influence diagram of nodes. This includes node definitions (Python code) and their resulting outputs.
- Interface Side: User-facing dashboards and pages containing components such as tables, charts, indicators, filters, forms, buttons, and menus.
Applications also include associated files, resources, versions, and scenarios for comparison and cycle management.
Overview of the HTML Menu component
The HTML Menu component allows you to embed custom HTML (cards, buttons, alerts, banners, etc.) into a Pyplan interface. It connects HTML elements to application logic without requiring additional integration code by mapping HTML attributes to specific Pyplan actions.Overview of the Scheduled Tasks component
The Scheduled Tasks component is used to monitor and control scheduled jobs that execute code automatically at predefined times or intervals. It is typically used in administrative interfaces for IT teams or operations dashboards to ensure data loads, model runs, and notifications are executing on time.Overview of Pyplan platform
Pyplan is a no-code/low-code platform designed for building and sharing Planning and Analytics applications. It allows users to connect to data sources (files, databases, APIs), transform and model data using nodes arranged in an influence diagram, and build interactive interfaces such as dashboards, forms, and charts. The platform supports what-if and scenario analysis, as well as the orchestration of processes and scheduled jobs. While each node contains Python code or configured behavior, non-coding users can interact with the platform via AI agents, wizards, and forms.Overview of the Pyplan platform
Pyplan is a no-code / low-code platform designed for building and sharing Planning and Analytics applications.Overview of Pyplan MCP Architecture
Pyplan uses the Model Context Protocol (MCP) to allow AI clients to connect to Pyplan instances. It employs a two-level architecture for tool execution:
- MCP Tools: A fixed set of core tools available to the client immediately upon connection.
- Skills and Domain Tools: Domain-specific documentation and tool schemas that are loaded on demand using
get_skill. These tools are not direct MCP tools and must be executed via thecall_toolMCP tool.
Standard workflow: Register server $\rightarrow$ Authenticate (OAuth 2.1) $\rightarrow$ List applications $\rightarrow$ Open application (obtaining an
instance_id) $\rightarrow$ Load skills $\rightarrow$ Execute domain tools viacall_toolusing theinstance_id.Overview of Pyplan platform
Pyplan is a no-code / low-code platform used for building and sharing Planning and Analytics applications. It allows teams to create data-driven applications, planning models, and interactive dashboards without requiring deep programming expertise.Overview of Pyplan Interface Options
Pyplan provides four ways to handle custom presentation, depending on whether you need a full page or a component within a standard grid:
- Component interface: A grid of draggable components (tables, charts, etc.). Best for standard dashboards.
- HTML Menu component: A single HTML block inside a component interface. Best for custom cards or banners.
- HTML Visualization component: A single component inside a component interface where a Python
render()method generates HTML. Best for data-driven visualizations that react to node changes. - HTML interface: A full-screen, self-contained web page with its own logic. Best for fully custom layouts or tailored tools that exceed standard component capabilities.
Overview of the Test Applications tool
The Test Applications tool allows users to run automation tests for multiple applications simultaneously without opening each application individually. It acts as a central registry to launch tests in the background, review logs, and track performance across different applications and versions. Note that this tool executes existing tests built within the applications; it does not create new tests.