whatisgithub

What is faceit-match-tracker?

angelosdimakos1/faceit-match-tracker — explained in plain English

Analysis updated 2026-05-18

184Audience · generalComplexity · 2/5LicenseSetup · moderate

In one sentence

A Discord bot that pulls FACEIT CS2/CS:GO match stats and turns them into AI-written summaries and coaching tips.

Mindmap

mindmap
  root((FACEIT Match Analyzer Bot))
    What it does
      Tracks CS2 CS:GO stats
      Posts to Discord
      AI generated summaries
    Tech stack
      Node.js
      Discord.js
      FACEIT API
    Use cases
      Match performance charts
      Opponent profiling
      Rank tracking
    Audience
      Discord communities
      Competitive players
    Setup
      config.yml file
      Discord bot token
      FACEIT API key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Track a group of friends' FACEIT match stats in a shared Discord server.

USE CASE 2

Get an AI generated summary and coaching tip after each tracked match.

USE CASE 3

Compare your performance across maps and weapons over time.

USE CASE 4

Follow a player's Elo rank progression on a chart.

What is it built with?

Node.jsDiscord.jsFACEIT APIOpenAI APIClaude APIDocker

How does it compare?

angelosdimakos1/faceit-match-tracker6hourt9/push-video-wallpaper-engineabhirammandula-boop/nooklink-pc-emulator-toolkit
Stars184184184
Setup difficultymoderateeasyeasy
Complexity2/52/52/5
Audiencegeneralvibe codergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a Discord bot token and a FACEIT API key at minimum, OpenAI and Claude keys are optional extras.

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

So what is it?

FACEIT Match Analyzer Bot is a Discord bot for tracking Counter-Strike 2 and CS:GO stats through the FACEIT platform. It connects to the FACEIT API to pull match data for players you follow, then uses OpenAI's GPT-4 Turbo and Anthropic's Claude 3 Opus to turn that data into readable summaries and coaching style suggestions. According to the README, the bot tracks metrics like kill to death ratio, average damage per round, and headshot percentage, and charts them over time. It also looks at which maps and weapons a player performs best with, profiles opponents' playstyles, and follows a player's Elo rank over time. Setup involves downloading a release, extracting it, editing a config.yml file with a Discord bot token and a FACEIT API key, and running the bot with Node.js or a provided Docker image. The config file also has optional slots for OpenAI and Claude API keys, which power the natural language analysis features. The README describes support for 12 languages with automatic detection based on a user's Discord locale, and says the bot's Discord message layouts are built to display well on phones, tablets, and desktops. It also mentions a built in support ticket system for handling user questions, plus live tracking that notifies you when a followed player starts a new match, refreshing stats about once a minute during active games. The project is licensed under the MIT License, which allows free use, modification, and redistribution as long as the copyright notice is kept. The README notes the bot is an independent, unofficial tool with no affiliation to FACEIT, Discord, OpenAI, or Anthropic, and that it works only through those services' official APIs rather than changing game files directly.

Copy-paste prompts

Prompt 1
Help me write a config.yml for this FACEIT Discord bot with my bot token and FACEIT API key.
Prompt 2
Explain what the responsive_ui and multilingual settings in this bot's config actually change.
Prompt 3
Walk me through running this bot with Docker instead of Node.js directly.
Prompt 4
What Discord permissions does this bot need to post match analysis embeds?

Frequently asked questions

What is faceit-match-tracker?

A Discord bot that pulls FACEIT CS2/CS:GO match stats and turns them into AI-written summaries and coaching tips.

What license does faceit-match-tracker use?

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

How hard is faceit-match-tracker to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is faceit-match-tracker for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.