Mprove
Open Source Business Intelligence with Malloy Semantic Layer :tada:
Install / Use
/learn @mprove-io/MproveREADME
Mprove
Mprove is an Open Source Business Intelligence with Malloy Semantic Layer
Deploy to Kubernetes cluster using Helm Chart
See README in mprove-helm-charts
Deploy using docker-compose (MacOS / Linux / Windows WSL)
1. Clone github repo to local mprove directory
git clone https://github.com/mprove-io/mprove.git
2. Change directory to mprove
cd mprove
If you open the directory in VS Code, you will be prompted to run Devcontainer. If you run Devcontainer, you will not be able to run Docker and Docker Compose images inside Devcontainer. Devcontainer is for development only.
3. Create mprove_data directory
chmod +x scripts/create-mprove-data.sh
scripts/create-mprove-data.sh
4. Run script to create ".env" file with generated values
chmod +x scripts/create-env.sh
scripts/create-env.sh
5. Modify .env
Set most recent Mprove release tag from https://github.com/mprove-io/mprove/releases
MPROVE_RELEASE_TAG=
Set your real email address. You may need it later to receive transactional emails (for example, to change your password).
BACKEND_MPROVE_ADMIN_EMAIL=
Change your initial password if necessary. Later changes can only be done through web interface (by sending an email).
BACKEND_MPROVE_ADMIN_INITIAL_PASSWORD=
Set SMTP parameters to be able to send transactional emails (required if you need to invite more users or change passwords).
BACKEND_SMTP_HOST=
BACKEND_SMTP_AUTH_USER=
BACKEND_SMTP_AUTH_PASSWORD=
BACKEND_SEND_EMAIL_FROM_ADDRESS=
BACKEND_SEND_EMAIL_FROM_NAME=
6. Run docker images
docker-compose up --no-build db calc-postgres valkey backend blockml disk front
7. Login
Open http://localhost:3003 in Chrome.
Login using values from .env file environment variables:
BACKEND_MPROVE_ADMIN_EMAILBACKEND_MPROVE_ADMIN_INITIAL_PASSWORD
Continue with Quickstart Docs.
License
Mprove is distributed under various Licenses.
Related Skills
oracle
346.4kBest practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
prose
346.4kOpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.
Command Development
107.2kThis skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
Plugin Structure
107.2kThis skill should be used when the user asks to "create a plugin", "scaffold a plugin", "understand plugin structure", "organize plugin components", "set up plugin.json", "use ${CLAUDE_PLUGIN_ROOT}", "add commands/agents/skills/hooks", "configure auto-discovery", or needs guidance on plugin directory layout, manifest configuration, component organization, file naming conventions, or Claude Code plugin architecture best practices.
