What is sourcerer-app?

sourcerer-io/sourcerer-app — explained in plain English

Analysis updated 2026-06-24

★ 6,738KotlinAudience · developerComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((sourcerer-app))
    What it does
      Scans git repos
      Builds dev profile
      Detects 100+ languages
      Detects 1000+ libraries
    Tech Stack
      Kotlin JVM
      Protocol Buffers
      Java 8+
    Setup
      GitHub web connect
      curl install macOS Linux
      Jar file on Windows
    Use Cases
      Portfolio building
      Private repo stats
      Library contribution

mindmap root((sourcerer-app)) What it does Scans git repos Builds dev profile Detects 100+ languages Detects 1000+ libraries Tech Stack Kotlin JVM Protocol Buffers Java 8+ Setup GitHub web connect curl install macOS Linux Jar file on Windows Use Cases Portfolio building Private repo stats Library contribution

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Build a visual coding portfolio that automatically shows which languages and libraries you have actually used across all your repositories.

USE CASE 2

Scan private or local repositories to generate contribution statistics without sending any source code to a server.

USE CASE 3

Add new library metadata to the detection list so the app recognizes more than its existing 1,000+ libraries.

What is it built with?

KotlinJVMProtocol BuffersJava

How does it compare?

	sourcerer-io/sourcerer-app	chrisbanes/tivi	kunzisoft/keepassdx
Stars	6,738	6,737	6,731
Language	Kotlin	Kotlin	Kotlin
Setup difficulty	easy	hard	easy
Complexity	2/5	4/5	1/5
Audience	developer	developer	general

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Public repos work via the Sourcerer website with no install, private repos require running the curl-installed app or jar file locally.

Use freely for any purpose including commercial use, as long as you keep the copyright notice.

So what is it?

Sourcerer is a tool that builds a visual profile page for a software developer by scanning their GitHub repositories and local git repositories. The resulting profile shows which programming languages and libraries a developer has worked with, with statistics broken down by usage across their code. The app recognized over 100 programming languages and could detect more than 1,000 libraries. For public GitHub repositories, the profile can be created through the Sourcerer website without installing anything locally: you connect your GitHub account and the service builds your profile automatically. For private or local repositories, you run the Sourcerer app on your own machine. The app analyzes your code locally and sends only statistical data to the Sourcerer servers, not the source code itself. The underlying client-server communication uses Protocol Buffers, which are defined in the repository for anyone who wants to verify exactly what data is transmitted. The app is written in Kotlin and runs on the JVM, requiring Java 8 or later. On macOS and Linux it installs with a single curl command. On Windows it requires running a jar file directly from a folder in your user directory. Developers interested in contributing can add metadata to the supported libraries list that the app uses for library detection. The project also accepted general code contributions through a guide linked from the README. The source is released under the MIT license.

Copy-paste prompts

Prompt 1

Write a Kotlin data class representing a language usage stat with fields for language name, file count, byte count, and commit count, matching what sourcerer-app would produce.

Prompt 2

How do I add a new JavaScript library called 'mylib' to the sourcerer-app library detection list? Show me the metadata format and where to place it in the repo.

Prompt 3

I want to build a similar tool in Python that scans local git repos and outputs language usage percentages by file extension. Give me a starter script using GitPython.

Prompt 4

Show me a minimal Protocol Buffers .proto definition for a developer stats message with owner, repo, language, and line count fields.

Frequently asked questions