Evidence

<div id="top" align="center">

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/evidence-dev/media-kit/main/svg/wordmark-white.svg">
  <img alt="Evidence Logo" src="https://raw.githubusercontent.com/evidence-dev/media-kit/main/svg/wordmark-black.svg">
</picture>

Evidence is an agent-ready tool for creating reports using your data

### [Docs](https://docs.evidence.studio) | [Slack](https://slack.evidence.dev)

![GitHub Repo stars](https://img.shields.io/github/stars/evidence-dev/evidence?style=social)
[![Join Slack](https://img.shields.io/badge/slack-join-blue?logo=slack&amp)](https://slack.evidence.dev)

</div>

# How It Works

Evidence is an open-source, code-based alternative to drag-and-drop business intelligence tools.

- Create reports in code using SQL and markdown
- Develop using Evidence's Agent, or on your local machine with Claude Code / Cursor etc
- Self-host or publish on Evidence Studio

# Install

### macOS / Linux

```bash
curl -fsSL https://evidence.studio/install.sh | sh
evidence help
```

### Windows

```powershell
irm https://evidence.studio/install.ps1 | iex
evidence help
```

# Create a Project

```bash
evidence init my-project
cd my-project
evidence dev
```

# Publish

Publish your project on [Evidence Studio](https://evidence.studio) for hosted reports, or self-host the generated static site on your own infrastructure. See the [publishing docs](https://docs.evidence.studio/publishing) for options.

# Join the Evidence Community

Join our [Slack channel](https://slack.evidence.dev) to get involved in the community's discussion, share what you're working on, or ask for help.

# Contributing

Contributions are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) for how pull requests are reviewed and merged.

# License

Evidence is licensed under the MIT license. See [LICENSE](LICENSE) for details.