Repolode
Submit
evidence-dev

evidence-dev/evidence

Open-source, code-based BI tool that builds interactive data reports and dashboards from SQL and markdown.

Open-source alternative to:TableauPower BILooker

View on GitHubWebsite
Stars
7,041
Forks
428
Open issues
15
Last commit
5 days ago

What is it?

Evidence is a business intelligence tool where reports are written as code rather than built with drag-and-drop widgets. Each page is a markdown file that embeds SQL queries and chart components, so analysts can version reports in Git and review changes like any other code.

The project runs a local development server through an `evidence dev` command and can generate a static site that you host yourself or publish to Evidence Studio. It also offers an built-in agent, and it can be used alongside coding assistants such as Claude Code or Cursor for local development.

The repository is a TypeScript project with a Svelte and Tailwind CSS front end, and it is tagged for dbt, DuckDB and WebAssembly workflows. It is released under the MIT license.

Key features

  • 01Write reports in SQL and markdown instead of drag-and-drop widgets.
  • 02Run a local dev server with the evidence dev command.
  • 03Generate a static site that can be self-hosted.
  • 04Publish hosted reports on Evidence Studio.
  • 05Works with local AI coding assistants such as Claude Code and Cursor.

Use cases

  • Building version-controlled internal dashboards that analysts maintain in Git.
  • Creating data reports that combine written narrative with live SQL-driven charts.
  • Replacing drag-and-drop BI tools with a code-based workflow for data teams.

Quick start

  1. 1

    Run the official install script for macOS or Linux from the README

  2. 2

    Check the CLI help

    evidence help
  3. 3

    Create a new project

    evidence init my-project
  4. 4

    Enter the project and start the dev server

    cd my-project evidence dev

Things to know

  • Installation relies on a curl or PowerShell script piped to a shell, which some teams may not accept.
  • Publishing to hosted reports is through Evidence Studio, while self-hosting requires your own infrastructure.

Topics

#business-intelligence#dashboard#data-visualization#sql#markdown#self-hosted#analytics#data-engineering#data-science#dbt

FAQ

What is evidence?
Open-source, code-based BI tool that builds interactive data reports and dashboards from SQL and markdown. Evidence is a business intelligence tool where reports are written as code rather than built with drag-and-drop widgets. Each page is a markdown file that embeds SQL queries and chart components, so analysts can version reports in Git and review changes like any other code.
Is evidence free to use? What license does it have?
evidence is open source under the MIT license. Check the license terms before using it in commercial products.
Is evidence still maintained?
Actively maintained. The last commit to evidence was on Oct 16, 2026.
What can I use evidence for?
Building version-controlled internal dashboards that analysts maintain in Git. Creating data reports that combine written narrative with live SQL-driven charts. Replacing drag-and-drop BI tools with a code-based workflow for data teams.
How do I install evidence?
Run the official install script for macOS or Linux from the README Check the CLI help: evidence help Create a new project: evidence init my-project Enter the project and start the dev server: cd my-project evidence dev
Where can I get evidence?
The source code and installation instructions are on GitHub: https://github.com/evidence-dev/evidence

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects