Skip to main content

LLM-Driven Data Transformations

Project description

Datu Core

LLM-Driven Data Transformations.

GitHub commit activity GitHub open issues License GitHub open pull requests PyPI version Python versions

Documentation

LLM-Driven Data Transformations

Datu is an AI-powered analyst agent that lets you model, visualize, analyze, and act on your data in minutes, all in plain English without technical expertise required. You can connect Datu Analyst to a variety of tools or MCP servers to perform tasks typically done by data analysts or data scientists. AI Analyst can do:

  • Connect to your data platform

  • Identify data quality issues

  • Identify and model data based on user request

  • Visualise and analyse data to understand "why" behind KPIs

Installation

Ensure you have installed Python 3.11+.

# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

#Install datu core
pip install 'datu-core[all]'

Running the application

# To run application type 
datu

Connect to datasource

As per the current design the application will fetch all the schema that is listed in the profiles.yml. It is to avoid fetching the schema every single time.But it will only work on the target datasource that is selected.

Structure of profiles.yml

datu_demo:
  target: dev-postgres # Target is used to select the datasource that is currently active. Change this if you would like to use a different datasource.
  outputs:
    dev-postgres:
      type: postgres
      host: "{{ env_var('DB_HOST', 'localhost') }}"  # if a environment variable is supplied that gets priority. This is useful for not hardcoding.
      port: 5432
      user: postgres
      password: postgres
      dbname: my_sap_bronz

Configurable parameters

Please checkout datu documentation

Features

  • Dynamic Schema Discovery & Caching:
    Automatically introspects the target database schema and caches the discovered metadata.

  • LLM Integration for SQL Generation:
    Uses OpenAI's API (e.g., GPT-4o-mini) to generate SQL queries that transform raw (Silver) data into a Gold layer format. The system prompt includes a concise summary of the schema to help the LLM generate valid queries.

  • Transformation Preview:
    The generated SQL is previewed by executing a sample query (with a LIMIT) and displaying the result in a formatted HTML table.

  • Persistent View Creation:
    Users can review the transformation preview and then create a view in the Gold layer. This view automatically reflects updates from the underlying Bronze data.

  • CSV Download:
    Users can download the full result of the transformation as a CSV file.

  • User-Friendly Chat Interface:
    The frontend features a ChatGPT-like interface with persistent conversation state, syntax highlighting for code blocks, and copy-to-clipboard functionality.

  • CSV Upload: Upload data as CSV files, in addition to or instead of connecting to a database.

  • Visualizations: Create bar, line, area, scatter, pie, or KPI visualizations to explore your data.

  • Data Catalog:
    View automatically generated business definitions for your fields.

  • Dashboards: Build dashboards with multiple KPIs to share insights with stakeholders.

Documentation

For detailed guidance & examples, explore our documentation:

Contributing ❤️

We welcome contributions! See our Contributing Guide for details on:

  • Reporting bugs & features
  • Development setup
  • Contributing via Pull Requests
  • Code of Conduct
  • Reporting of security issues

Ready to scale?

If you are looking for Datu SaaS then Talk to us

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_datuanalytics_datu_core-0.0.1.tar.gz (7.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_datuanalytics_datu_core-0.0.1.tar.gz.

File metadata

  • Download URL: iflow_mcp_datuanalytics_datu_core-0.0.1.tar.gz
  • Upload date:
  • Size: 7.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_datuanalytics_datu_core-0.0.1.tar.gz
Algorithm Hash digest
SHA256 95bb8d4af9f3f03e2aee2533ed30c3ab113caf0e2cb2991db3fc8f00c2b6262d
MD5 3fc36d6de6bcd83d8d36ebf15cae1a21
BLAKE2b-256 7e956c0edae74ac505f15e4609906250ebb4e42503d11e1dec6b701cbb4c4312

See more details on using hashes here.

File details

Details for the file iflow_mcp_datuanalytics_datu_core-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_datuanalytics_datu_core-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 7.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_datuanalytics_datu_core-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8ce08f4086014a2046482a744993e6a801960393b56afa4c8e2fd53f4dd3dad7
MD5 ae54b9ac430c7835ba54458e80929b8f
BLAKE2b-256 502fd7899e124860deb9da558a9122a89721b85a280cb7def2aa2d5548d0cf84

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page