dsh-data-agent: A Conversational Data Analysis Plugin for DeepSeek Harness
omdsh-dev/dsh-data-agent
DSH plugin connecting databases for conversational data analysis and business insights.
Connect DeepSeek Harness to databases for natural-language queries, SQL execution, and business insights, lowering the barrier to data analysis.
dsh plugin --profile web add github:omdsh-dev/dsh-data-agent- Category
- Tools & Capabilities
- Platform
- DSH-Plugin
- Author
- omdsh-dev
- Distribution
- Plugin
dsh-data-agent Key Features
dsh-data-agent Repository
dsh-data-agent Repo Summary
dsh-data-agent is a data analysis plugin (DSH plugin) for DeepSeek Harness (DSH) that connects DSH to databases for conversational data analysis and actionable business insights. Maintained by omdsh-dev, it is written in TypeScript, licensed under MIT, and last updated in 2026-08. It solves the problem of high barriers and complex workflows in traditional data analysis, allowing business users to obtain data conclusions through conversation. Core capabilities include automatic table inspection, SQL generation and execution, and continuous analysis based on real results, with support for both Web UI and dsh-tui.
What core features does the dsh-data-agent DSH plugin support?
The plugin enables conversational data analysis: DSH understands questions, breaks down steps, queries real data, and summarizes conclusions. It also automatically finds business insights, such as comparing trends, spotting anomalies, and identifying high-value customers. It is fully compatible with Web UI and dsh-tui without modifying DSH source code. It supports common databases including MySQL, PostgreSQL, SQLite, Oracle, Hive, and Impala. DSH automatically completes the analysis loop, adjusting SQL based on errors or results. The plugin also provides a data-focused mode that reduces irrelevant tool interference and supports read-only mode to protect real data.
How to install the dsh-data-agent DSH plugin?
Installation depends on the interface you use. If you use both Web UI and dsh-tui, run both commands. The recommended method is via npm, but you can also install from GitHub. Use the following commands:
dsh plugin --profile web add github:omdsh-dev/dsh-data-agent
dsh plugin --profile dsh-tui add github:omdsh-dev/dsh-data-agent
The plugin automatically installs the "data mode" preset; no local build is required.
How to use dsh-data-agent in the Web UI?
After starting the Web UI, create a new session and select "Data Mode", fill in the connection details in the database workbench, and once connected, ask analysis questions directly in the chat. For example, input "Analyze order changes in the last 30 days, find regions and products with the most significant sales decline", and DSH will inspect relevant tables, generate and execute queries, and complete the analysis based on real results. The Web UI also includes an embedded database workbench for browsing tables, viewing field structures, or running ad-hoc SQL.
How to use dsh-data-agent in dsh-tui?
In the terminal interface, switch to data mode and connect to the database:
/preset data-agent
/database connect
The connection form supports Tab to switch inputs; use arrow keys to select database type and read-only mode. After connecting, ask business questions directly. Common commands include /database status, /database test, and /database disconnect. Passwords are always hidden and never restored.
What preparations are needed before using dsh-data-agent?
DSH requires local access to the target database and the corresponding client tools, such as mysql for MySQL and psql for PostgreSQL. It is recommended to prepare a read-only database account and enable read-only mode. If you encounter a failed to mount error, ensure the plugin is installed for the corresponding profile.