{"id":14449101,"url":"https://github.com/frappe/insights","last_synced_at":"2026-05-11T09:56:50.143Z","repository":{"id":44348784,"uuid":"508700935","full_name":"frappe/insights","owner":"frappe","description":"Open Source Business Intelligence Tool","archived":false,"fork":false,"pushed_at":"2026-04-13T06:48:31.000Z","size":52663,"stargazers_count":891,"open_issues_count":190,"forks_count":438,"subscribers_count":26,"default_branch":"develop","last_synced_at":"2026-04-13T08:28:06.074Z","etag":null,"topics":["analytics","bi","business-intelligence","dashboard","data-analytics","data-visualization","duckdb","echarts","erpnext","frappe","frappe-framework","mysql","sql-editor","vue"],"latest_commit_sha":null,"homepage":"https://frappe.io/insights","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frappe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-06-29T13:22:20.000Z","updated_at":"2026-04-12T12:06:43.000Z","dependencies_parsed_at":"2023-12-29T16:27:47.941Z","dependency_job_id":"df28ccec-5c93-42d3-9ae8-df36810a042b","html_url":"https://github.com/frappe/insights","commit_stats":null,"previous_names":[],"tags_count":135,"template":false,"template_full_name":null,"purl":"pkg:github/frappe/insights","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frappe%2Finsights","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frappe%2Finsights/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frappe%2Finsights/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frappe%2Finsights/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frappe","download_url":"https://codeload.github.com/frappe/insights/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frappe%2Finsights/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31833837,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T07:17:56.427Z","status":"ssl_error","status_checked_at":"2026-04-15T07:17:30.007Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","bi","business-intelligence","dashboard","data-analytics","data-visualization","duckdb","echarts","erpnext","frappe","frappe-framework","mysql","sql-editor","vue"],"created_at":"2024-09-01T08:01:07.158Z","updated_at":"2026-04-15T09:02:09.614Z","avatar_url":"https://github.com/frappe.png","language":"Vue","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"\u003cdiv align=\"center\" markdown=\"1\"\u003e\n\n\u003cimg src=\".github/new-logo.svg\" alt=\"Frappe Insights logo\" height=\"80\"/\u003e\n\u003ch1\u003eFrappe Insights\u003c/h1\u003e\n\n**Open Source Business Intelligence Tool**\n\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/frappe/insights)\n[![codecov](https://codecov.io/github/frappe/insights/branch/develop/graph/badge.svg?token=8ZXHCY4G9U)](https://codecov.io/github/frappe/insights)\n\n\u003c/div\u003e\n\n\n\u003cdiv align=\"center\"\u003e\n\t\u003cimg src=\".github/hero-image.png?v=6\" alt=\"Hero Image\" width=\"1402\" /\u003e\n\u003c/div\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://insightsdemo.frappe.cloud\"\u003eLive Demo\u003c/a\u003e\n    -\n    \u003ca href=\"https://frappe.io/insights\"\u003eWebsite\u003c/a\u003e\n    -\n    \u003ca href=\"https://docs.frappe.io/insights\"\u003eDocumentation\u003c/a\u003e\n\u003c/div\u003e\n\n## Frappe Insights\nInsights is a 100% open-source BI tool designed to make data analysis and reporting more accessible to technical as well as non-technical users.\n\n\u003cdetails\u003e\n\u003csummary\u003eScreenshots\u003c/summary\u003e\n\n![Query Builder](.github/query-builder.png)\n![Query Builder](.github/join-editor.png)\n![Chart Builder](.github/chart-builder.png)\n\u003c/details\u003e\n\n### Motivation\nBuilding 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.\n\n### Key Features\n\n- **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.\n\n- **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.\n\n- **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.\n\n- **Database Support**: Frappe Insights currently supports MySQL, PostgreSQL, DuckDB, and BigQuery databases. More database integrations are planned for the future.\n\n\n### Under the Hood\n\n- [**Frappe Framework**](https://github.com/frappe/frappe): A full-stack web application framework.\n\n- [**Frappe UI**](https://github.com/frappe/frappe-ui): A Vue-based UI library, to provide a modern user interface.\n\n- [**Ibis**](https://github.com/ibis-project/ibis): A powerful library to compose SQL queries with dataframe APIs.\n\n- [**eCharts**](https://github.com/apache/echarts): An interactive charting and data visualization library.\n\n\n## Production Setup\n\n### Managed Hosting\n\nYou 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.\n\nIt 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.\n\n\u003cdiv\u003e\n    \u003ca href=\"https://frappecloud.com/insights/signup\" target=\"_blank\"\u003e\n        \u003cpicture\u003e\n            \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://frappe.io/files/try-on-fc-white.png\"\u003e\n            \u003cimg src=\"https://frappe.io/files/try-on-fc-black.png\" alt=\"Try on Frappe Cloud\" height=\"28\" /\u003e\n        \u003c/picture\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n### Self Hosting\n\nFollow these steps to set up Frappe Insights in production:\n\n**Step 1**: Download the easy install script\n\n```bash\nwget https://frappe.io/easy-install.py\n```\n\n**Step 2**: Run the deployment command\n\n```bash\npython3 ./easy-install.py deploy \\\n    --project=insights_prod_setup \\\n    --email=your_email.example.com \\\n    --image=ghcr.io/frappe/insights \\\n    --version=stable \\\n    --app=insights \\\n    --sitename subdomain.domain.tld\n```\n\nReplace the following parameters with your values:\n- `your_email.example.com`: Your email address\n- `subdomain.domain.tld`: Your domain name where Insights will be hosted\n\n**Step 3**: Enable Server Scripts\n\n```bash\ndocker compose -p insights_prod_setup exec backend bench set-config -g server_script_enabled 1\n```\n\n**Step 4**: Access the site\n\nOpen the site in your browser at `https://subdomain.domain.tld/` and login with the administrator credentials. You will find the admin password logged in the console after the deployment command is finished. Or you can find it in the `insights_prod_setup-passwords.txt` file created after the deployment.\n\n## Development Setup\n\n### Docker\n\nYou need Docker, docker-compose and git setup on your machine. Refer [Docker documentation](https://docs.docker.com/). After that, follow below steps:\n\n1. Setup folder and download the required files\n    ````\n    mkdir frappe-insights\n    cd frappe-insights\n\n    # Download the docker-compose file\n    wget -O docker-compose.yml https://raw.githubusercontent.com/frappe/insights/develop/docker/docker-compose.yml\n\n    # Download the setup script\n    wget -O init.sh https://raw.githubusercontent.com/frappe/insights/develop/docker/init.sh\n    ````\n\n2. Run the container and daemonize it\n    ````\n    docker compose up -d\n    ````\n\n3. The site [http://insights.localhost:8000/insights](http://insights.localhost:8000/insights) should now be available. The default credentials are:\n   - Username: Administrator\n   - Password: admin\n\n4. If you need to stop the containers after use and persist the data\n   ````\n   docker compose stop\n   ````\n\n5. If you need to stop the containers cleanup entire setup after trying it out\n   ````\n   docker compose down\n   ````\n### Local\n\nTo setup the repository locally follow the steps mentioned below:\n\n1. Setup bench by following the [Installation Steps](https://frappeframework.com/docs/user/en/installation) and start the server\n    ```\n    bench start\n    ```\n\n2. In a separate terminal window, cd into `frappe-bench` directory and run the following commands:\n    ```sh\n    bench get-app insights\n    bench new-site insights.test --install-app insights\n    bench --site insights.test add-to-hosts\n    bench --site insights.test browse --user Administrator\n    ```\n\n3. Now, open a new terminal session and cd into `frappe-bench/apps/insights`, and run the following commands:\n    ```\n    yarn\n    yarn dev\n    ```\n\n4. Now, you can access the site on vite dev server at `http://insights.test:8080`\n\n## Compatibility Matrix\n\n| Insights Branch | Frappe Framework Version            | Node Version |\n|-----------------|-------------------------------------|--------------|\n| main            | version-14, version-15              | v18+         |\n| version-3       | version-14, version-15              | v18+         |\n| develop         | develop                             | v18+         |\n\n\u003e Note: Frappe v14 supports Node v14 and above, but Insights requires Node v18 and above. So, while using Insights with Frappe v14, please ensure that Node v18+ is installed.\n\n## Learn and connect\n\n- [Telegram Public Group](https://t.me/frappeinsights)\n- [Discuss Forum](https://discuss.frappe.io/c/insights/74)\n- [Documentation](https://docs.frappe.io/insights)\n- [YouTube](https://www.youtube.com/@frappetech)\n\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cdiv align=\"center\" style=\"padding-top: 0.75rem;\"\u003e\n    \u003ca href=\"https://frappe.io\" target=\"_blank\"\u003e\n        \u003cpicture\u003e\n            \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://frappe.io/files/Frappe-white.png\"\u003e\n            \u003cimg src=\"https://frappe.io/files/Frappe-black.png\" alt=\"Frappe Technologies\" height=\"28\"/\u003e\n        \u003c/picture\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrappe%2Finsights","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrappe%2Finsights","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrappe%2Finsights/lists"}