Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mergestat/mergestat

MergeStat enables anyone to ask questions about the history and contents of source code.
https://github.com/mergestat/mergestat

database github golang postgres

Last synced: 4 days ago
JSON representation

MergeStat enables anyone to ask questions about the history and contents of source code.

Host: GitHub
URL: https://github.com/mergestat/mergestat
Owner: mergestat
License: mit
Created: 2022-02-22T15:20:50.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-10-19T17:02:08.000Z (22 days ago)
Last Synced: 2024-10-26T18:30:14.224Z (15 days ago)
Topics: database, github, golang, postgres
Language: TypeScript
Homepage: https://docs.mergestat.com/
Size: 51.8 MB
Stars: 474
Watchers: 10
Forks: 45
Open Issues: 110
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS

Awesome Lists containing this project

awesome-golang-repositories - mergestat
charm-in-the-wild - mergestat - Run SQL queries on git repositories. (_built with Bubble Tea_) (Applications / Development Tools)

README

        [![Go Report Card](https://goreportcard.com/badge/github.com/mergestat/mergestat)](https://goreportcard.com/report/github.com/mergestat/mergestat)

[![CI Worker (Golang)](https://github.com/mergestat/mergestat/actions/workflows/ci-worker.yaml/badge.svg)](https://github.com/mergestat/mergestat/actions/workflows/ci-worker.yaml)

[![CI Frontend (UI)](https://github.com/mergestat/mergestat/actions/workflows/ci-frontend.yaml/badge.svg)](https://github.com/mergestat/mergestat/actions/workflows/ci-frontend.yaml)

[![Twitter Follow](https://img.shields.io/twitter/follow/mergestat)](https://twitter.com/mergestat)

[![Slack Community](https://badgen.net/badge/icon/slack?icon=slack&label)](https://join.slack.com/t/mergestatcommunity/shared_invite/zt-xvvtvcz9-w3JJVIdhLgEWrVrKKNXOYg)

# mergestat 

  

  

MergeStat enables SQL queries for data in git repositories (and related sources, such as the GitHub API). It allows you to ask questions about the history and contents of your source code.

**If you are looking for our CLI, which runs SQL queries against local git repositories, it's now called [`mergestat-lite`](https://github.com/mergestat/mergestat-lite)**

See our [**documentation**](https://docs.mergestat.com/) for additional context.



## Running Locally

Try MergeStat locally with `docker-compose` by cloning this repository and running

```sh

docker-compose up

```

Now if you visit `http://localhost:3300/` you should be able to access our management UI where you can begin adding repositories and syncing data.

**NOTE** if you'd like to make use of GitHub API data (any sync type that uses the GitHub API **including repo auto imports**) or any private GitHub repos you will need to supply a GitHub [personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).

We are working on GitHub auth alternatives, but for now a PAT is your best bet.



You can manage a single PAT for your instance in the `Settings` area of the management UI.

## Examples

Take a look at all of our [examples](./examples)

### Resetting a Local Instance

If you'd like to "start from scratch" (i.e. reset the DB and start with a fresh deployment), run the following:

```

docker-compose down

```

```

docker volume rm mergestat_db_data

```