🌐 Website · 📚 Docs · 🐳 Docker Hub · 🗺️ Roadmap

---

Knowage is an open-source analytics and business intelligence suite designed to integrate traditional and big/cloud data sources, transforming them into valuable insights. Its features — data federation, mash-up, data/text mining, and advanced visualization — provide comprehensive support for rich, multi-source data analysis.

Features

Feature	Description	EE
Online Dashboard	Interactive tool for visualizing data from multiple datasets
Reporting	Create, customize, and distribute interactive reports from diverse sources
OLAP	Drill-down, slice-and-dice, and pivot operations for multidimensional analysis
KPI	Define, monitor, and visualize key performance indicators
Python Integration	Execute scripts and embed custom algorithms within the BI environment
Virtual Assistant	AI-powered assistant (EngGpt) for guided analysis and navigation	✅
Data Preparation	Clean, transform, and enrich raw data for analytics	✅
Dossier	Combine multiple reports into a single interactive view	✅

Editions

Edition	Description
Community (CE)	Full analytical capabilities, open source, part of OW2
Enterprise (EE)	Commercial offering by Engineering Group with additional features and dedicated support

This repository contains the source code of the Community Edition.

Quick Start

The fastest way to run Knowage is via Docker:

git clone https://github.com/KnowageLabs/Knowage-Docker.git
cd Knowage-Docker
docker compose up

For full installation and configuration instructions, see the Installation & Administration Manual.

Contributing

Knowage is open to external contributions. Before opening a pull request:

• This project follows a Contributor Code of Conduct
• You must sign the Individual Contributor License Agreement by commenting "I have read the CLA Document and I hereby sign the CLA" on your PR
• Ensure all tests pass before submitting

Issues and feature requests are tracked in KnowageLabs/Knowage.

Building from Source

Prerequisites

Tool	Required version
JDK	17 (LTS)
Maven	3.x
Node.js	≥ 22
Grunt CLI	latest (global)

Note: The Java version is pinned to 17 in pom.xml — not 11, not 21.

Install Grunt CLI globally:

npm install -g grunt-cli

Quick check:

java -version    # openjdk 17.x.x
mvn -version     # Apache Maven 3.x.x
node -version    # v22.x.x or higher
grunt --version  # grunt-cli v...

Build

git clone https://github.com/KnowageLabs/Knowage-Server.git
cd Knowage-Server/knowage-ce-parent
mvn clean install

Output

WAR files are generated under knowage-ce-parent/:

Module	Path
Core	knowage/target/knowage.war
API	knowage-api/target/knowage-api.war
Vue frontend	knowage-vue/target/knowage-vue.war
BIRT engine	knowagebirtreportengine/target/knowagebirtreportengine.war
Cockpit engine	knowagecockpitengine/target/knowagecockpitengine.war
Jasper engine	knowagejasperreportengine/target/knowagejasperreportengine.war
KPI engine	knowagekpiengine/target/knowagekpiengine.war
Meta	knowagemeta/target/knowagemeta.war
QBE engine	knowageqbeengine/target/knowageqbeengine.war
Talend engine	knowagetalendengine/target/knowagetalendengine.war

Deploy

Deploy the WAR files to an Apache Tomcat instance configured with a metadata database (MySQL/MariaDB or PostgreSQL). Database DDL scripts are under knowagedatabasescripts/<dbms>/. See the manual installation guide for details.

Python Module

No build needed — run the Knowage-Python module directly as a standalone program. See the Python installation guide.

License

AGPL v3 © 2026 Engineering Ingegneria Informatica S.p.A.