# Introduction

> What Emolysis does, how it works on your data platform, where each part stands today, and how these docs are organized, page by page.

Emolysis is the agentic lakehouse for data engineering and analytics. Direct a team of agents from your laptop to investigate business questions, develop dashboards, and build and test pipelines for your data platform. Underneath is a local-first coding agent that writes data pipelines and dashboards for the platform you already run, tests them on your machine, and deploys them as your platform's native units.

Use these docs to judge whether Emolysis fits how your team works. The status line at the top of each page shows where it stands.

## The idea in one paragraph

Data engineering is more templatable than general software. About ten pipeline shapes cover most production work: ingesting files, appending incrementally, merging change feeds, keeping history, snapshots, backfills, late data, cleaning into silver, building gold metrics and pushing results back to applications. Each shape has a correct form on each platform. Emolysis starts from a tested template for the shape and platform, fills it with what it learns from your catalog and your request, and proves it with golden tests on [DuckDB](https://emolysis.com/platforms/duckdb) before it touches your platform.

The agent does not write pipelines from scratch. If a request does not match a shape, it says so instead of improvising code it cannot test.

## What you work with

- **Projects.** A plain folder in your Git repository, with models, pipelines, tests and a project file that names the target platform. See [Projects and emolysis.yml](https://emolysis.com/docs/projects).
- **Platform profiles.** What the agent knows about Databricks, Snowflake or Microsoft Fabric: dialect, table format, merge idiom, deployment unit and known traps. See [Platform profiles](https://emolysis.com/docs/platform-profiles).
- **Templates and golden tests.** One template per shape and platform, each with fixtures and expected outputs. See [Templates and slots](https://emolysis.com/docs/templates) and [Golden tests on DuckDB](https://emolysis.com/docs/golden-tests).
- **Dashboards.** Charts built from a tested gold table, shared as a link when you choose. See [Dashboards from a question](https://emolysis.com/docs/dashboards).
- **Surfaces.** The desktop app, the `emo` command line, the MCP server for editors and coding agents, and checks on GitHub pull requests. They all run the same commands. See [The emo CLI](https://emolysis.com/docs/cli) and [The MCP server](https://emolysis.com/docs/mcp-server).

## Where things stand

| Area                                             | Status                                                                                        |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------- |
| Emolysis overall                                 | In private development; no download, accounts or release date                                 |
| Local engine on DuckDB                           | In development                                                                                |
| Databricks                                       | In development; the first platform                                                            |
| Snowflake, Microsoft Fabric                      | Planned, after Databricks; tested only on simulated services, not on a real account; no dates |
| PostgreSQL as a source                           | In development; read from, never deployed to                                                  |
| SQL Server as a source                           | Planned                                                                                       |
| Pipeline templates (ten shapes)                  | In development; none released                                                                 |
| Desktop app, `emo` CLI, MCP server               | In development; not available                                                                 |
| GitHub App                                       | Planned                                                                                       |
| Pull request checks in your own CI (`emo check`) | In development                                                                                |
| Accounts, plans, shared dashboards               | In development; nothing can be bought or shared yet                                           |
| Template format and validator                    | Public source on GitHub, not packaged                                                         |
| Sample dashboard on this site                    | Live, on synthetic data; it renders the same chart specs the agent produces                   |

## A note on your data

Local-first does not mean nothing leaves your machine. To write code, the agent sends prompts to the AI model provider you choose, and a prompt can include table and column names, schemas and sample values. With a paid plan's model usage, those prompts pass through Emolysis's metering service, which is designed not to store or log their content. A dashboard leaves your machine when you publish it, and only then. Read [Data handling](https://emolysis.com/docs/data-handling) before you connect anything, and the [security page](https://emolysis.com/security) for the summary.

## How these docs are organized

- **Start here.** This page, [How Emolysis works](https://emolysis.com/docs/how-it-works), [Installation](https://emolysis.com/docs/installation) and the [Quickstart](https://emolysis.com/docs/quickstart).
- **Build pipelines.** Projects, [pipeline shapes](https://emolysis.com/docs/shapes), templates and golden tests.
- **Platforms.** Profiles, connecting [Databricks](https://emolysis.com/docs/connect-databricks), [Snowflake](https://emolysis.com/docs/connect-snowflake) and [Fabric](https://emolysis.com/docs/connect-fabric), [sources](https://emolysis.com/docs/sources) and [deploying](https://emolysis.com/docs/deploying).
- **Dashboards.** From a question to a chart, [sharing](https://emolysis.com/docs/sharing) and [chart types](https://emolysis.com/docs/chart-types).
- **Tools.** The CLI, the MCP server, editors and coding agents, and [GitHub checks](https://emolysis.com/docs/github-checks).
- **Account and data.** [Model keys and credits](https://emolysis.com/docs/model-keys-and-credits) and data handling.
- **Help.** [Troubleshooting](https://emolysis.com/docs/troubleshooting) and [error codes](https://emolysis.com/docs/error-codes).

Every page starts with a status line. Reference pages for commands, files and fields also carry a "Planned reference" label, because their names and formats can change before the first release.

## Where to go next

Read [How Emolysis works](https://emolysis.com/docs/how-it-works) for the full loop, then the [Quickstart](https://emolysis.com/docs/quickstart) for a first session. If you want the words first, the [glossary](https://emolysis.com/glossary) defines every term these docs use, and the [ten pipeline shapes](https://emolysis.com/shapes) each have their own page.

---

Page: https://emolysis.com/docs/introduction. Emolysis is a product of Bandpey GmbH, Munich, Germany. It is in private development, and nothing is released yet.
