git404hub

what is data-agent fr?

libambu/data-agent — explained in plain English

Analysis updated 2026-05-18

14JavaAudience · developerComplexity · 5/5Setup · hard

tl;dr

Data Agent lets you ask data questions in plain text and returns working SQL or Python code plus a Markdown report, powered by a 13-node multi-agent pipeline with PostgreSQL and vector search.

vibe map

mindmap
  root((Data Agent))
    Input
      Plain-language question
      Human plan approval
    Agent pipeline
      Schema retrieval
      Feasibility check
      Planner node
      SQL sub-agent
      Python sub-agent
      Report sub-agent
    Knowledge base
      Database schema
      Business glossary
      Historical QA pairs
    Output
      SQL queries
      Python analysis
      Markdown reports

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Type a plain-language question about your database and receive a working SQL query and analysis report without writing any code.

VIBE 2

Test natural-language-to-SQL accuracy on the included BIRD-SQL benchmark dataset with 11 databases and 1,534 questions.

VIBE 3

Give non-technical team members a chat interface for querying structured business data.

what's the stack?

JavaSpring BootVue 3PostgreSQLpgvectorSpring AI

how it stacks up fr

libambu/data-agentsunjulei/warehousedarealneoncoder/minecraftinterminal
Stars141415
LanguageJavaJavaJava
Setup difficultyhardmoderateeasy
Complexity5/53/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires Docker, Java 17, Maven, Node.js with pnpm, and a DashScope API key for the DeepSeek LLM.

License not specified in this repository.

in plain english

Data Agent is an end-to-end data analytics platform where you type a question in plain language and the system produces working SQL or Python code plus a Markdown analysis report. The project is built in Java and Vue 3, and its core is a network of AI agents that collaborate to answer your question. The pipeline is structured as a 13-node, 4-stage graph. When you submit a question, the system first retrieves relevant database schema information and business terminology from a vector store. It then evaluates whether the question is feasible, plans an execution strategy, and routes the work to specialized sub-agents: one that writes SQL queries, one that runs Python analysis or generates charts, and one that composes the final report. An LLM supervisor coordinates the sub-agents and can loop them if a result looks wrong. The system also includes a human-in-the-loop checkpoint where you can approve or reject the plan before execution proceeds. Data Agent uses a three-layer knowledge system backed by PostgreSQL with the pgvector extension. It stores database schema, business glossary terms, and historical question-answer pairs as vector embeddings, which it retrieves to guide each new query. The BIRD-SQL benchmark dataset (11 databases, 1,534 questions) is included for testing. Setting up the project requires Docker for PostgreSQL plus pgvector, Java 17, Maven, Node.js with pnpm, and a DashScope API key (an Alibaba Cloud service that provides access to the DeepSeek model used here). A Docker Compose file handles the database setup automatically. The frontend runs on Vue 3 with Element Plus and shows a live animated view of the agent graph as each node executes. The project is aimed at teams that want to give non-technical stakeholders a way to query databases by asking questions in plain text.

prompts (copy fr)

prompt 1
How do I connect Data Agent to my own PostgreSQL database and add its schema to the vector store?
prompt 2
Walk me through adding a custom business glossary term to the Data Agent knowledge base so the SQL agent understands our internal naming.
prompt 3
How does the Data Agent supervisor decide whether to send a task to the SQL sub-agent or the Python sub-agent?
prompt 4
Set up Data Agent with Docker Compose and load the BIRD-SQL dataset so I can test natural-language queries against all 11 included databases.

Frequently asked questions

what is data-agent fr?

Data Agent lets you ask data questions in plain text and returns working SQL or Python code plus a Markdown report, powered by a 13-node multi-agent pipeline with PostgreSQL and vector search.

What language is data-agent written in?

Mainly Java. The stack also includes Java, Spring Boot, Vue 3.

What license does data-agent use?

License not specified in this repository.

How hard is data-agent to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is data-agent for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.