https://github.com/frappe/insights
Open Source Business Intelligence Tool
https://github.com/frappe/insights
analytics business-intelligence data-analytics data-visualization erpnext frappe frappe-framework
Last synced: 2 months ago
JSON representation
Open Source Business Intelligence Tool
- Host: GitHub
- URL: https://github.com/frappe/insights
- Owner: frappe
- License: agpl-3.0
- Created: 2022-06-29T13:22:20.000Z (almost 3 years ago)
- Default Branch: develop
- Last Pushed: 2025-02-14T06:44:44.000Z (2 months ago)
- Last Synced: 2025-02-14T07:31:54.769Z (2 months ago)
- Topics: analytics, business-intelligence, data-analytics, data-visualization, erpnext, frappe, frappe-framework
- Language: Vue
- Homepage: https://frappe.io/insights
- Size: 32.2 MB
- Stars: 510
- Watchers: 26
- Forks: 257
- Open Issues: 81
-
Metadata Files:
- Readme: README.md
- License: license.txt
Awesome Lists containing this project
- awesome-frappe - Frappe Insights - Free and Open Source Data Analytics Tool for your Frappe Apps (Uncategorized / Uncategorized)
README
Frappe Insights
**Open Source Business Intelligence Tool**
[](https://codecov.io/github/frappe/insights)
## Frappe Insights
Insights is a 100% open-source BI tool designed to make data analysis and reporting more accessible to technical as well as non-technical users.
Screenshots
### Motivation
Building custom apps or creating structured data has been very easy with Frappe Framework. However, extracting information from these apps was not a very good experience. Users needed to know how to write SQL queries to create reports to gain valuable information from the data. So I wanted to improve the experience of building these reports and dashboards for everyone in our team.
### Key Features
- **Connect Multiple Sources**: You can integrate data from multiple databases, files and spreadsheets. Getting all your data into one place helps you analyse interconnected data.
- **Query Builder**: You can use the query builder to create queries without any SQL knowledge. The interface provides a step-by-step approach for building queries, allowing users to easily select tables, add joins, apply filters, perform calculations, and more.
- **Visualizations and Dashboards**: You can visualize the query results using a variety of charts and graphs. Frappe Insights also suggests the best chart for a given result set. You can create dashboards using a drag-and-drop interface and add filters on the dashboard to apply to the charts.
- **Database Support**: Frappe Insights currently supports MySQL, PostgreSQL, DuckDB, and BigQuery databases. More database integrations are planned for the future.
### Under the Hood
- [**Frappe Framework**](https://github.com/frappe/frappe): A full-stack web application framework.
- [**Frappe UI**](https://github.com/frappe/frappe-ui): A Vue-based UI library, to provide a modern user interface.
- [**Ibis**](https://github.com/ibis-project/ibis): A powerful library to compose SQL queries with dataframe APIs.
- [**eCharts**](https://github.com/apache/echarts): An interactive charting and data visualization library.
## Production Setup
### Managed Hosting
You can try [Frappe Cloud](https://frappecloud.com), a simple, user-friendly and sophisticated [open-source](https://github.com/frappe/press) platform to host Frappe applications with peace of mind.
It takes care of installation, setup, upgrades, monitoring, maintenance and support of your Frappe deployments. It is a fully featured developer platform with an ability to manage and control multiple Frappe deployments.
### Self Hosting
Follow these steps to set up Frappe Insights in production:
**Step 1**: Download the easy install script
```bash
wget https://frappe.io/easy-install.py
```
**Step 2**: Run the deployment command
```bash
python3 ./easy-install.py deploy \
--project=insights_prod_setup \
--email=your_email.example.com \
--image=ghcr.io/frappe/insights \
--version=stable \
--app=insights \
--sitename subdomain.domain.tld
```
Replace the following parameters with your values:
- `your_email.example.com`: Your email address
- `subdomain.domain.tld`: Your domain name where Insights will be hosted
The script will set up a production-ready instance of Frappe Insights with all the necessary configurations in about 5 minutes.
## Development Setup
### Docker
You need Docker, docker-compose and git setup on your machine. Refer [Docker documentation](https://docs.docker.com/). After that, follow below steps:
1. Setup folder and download the required files
````
mkdir frappe-insights
cd frappe-insights
# Download the docker-compose file
wget -O docker-compose.yml https://raw.githubusercontent.com/frappe/insights/develop/docker/docker-compose.yml
# Download the setup script
wget -O init.sh https://raw.githubusercontent.com/frappe/insights/develop/docker/init.sh
````
2. Run the container and daemonize it
````
docker compose up -d
````
3. The site [http://insights.localhost:8000/insights](http://insights.localhost:8000/insights) should now be available. The default credentials are:
- Username: Administrator
- Password: admin
### Local
To setup the repository locally follow the steps mentioned below:
1. Setup bench by following the [Installation Steps](https://frappeframework.com/docs/user/en/installation) and start the server
```
bench start
```
2. In a separate terminal window, cd into `frappe-bench` directory and run the following commands:
```sh
bench get-app insights
bench new-site insights.test --install-app insights
bench --site insights.test add-to-hosts
bench --site insights.test browse --user Administrator
```
3. Now, open a new terminal session and cd into `frappe-bench/apps/insights`, and run the following commands:
```
yarn
yarn dev
```
4. Now, you can access the site on vite dev server at `http://insights.test:8080`
## Learn and connect
- [Telegram Public Group](https://t.me/frappeinsights)
- [Discuss Forum](https://discuss.frappe.io/c/insights/74)
- [Documentation](https://docs.frappe.io/insights)
- [YouTube](https://www.youtube.com/@frappetech)
