📊 GitHub Stats — Discord Bot

A modern and interactive Discord bot for exploring GitHub profiles, repositories, languages, and more — directly from Discord. Built with Discord.js, powered by the GitHub API, and tailored for developers and communities.

👉 Invite GitHub Stats Bot to your server

---

---

✨ Features

• 🧑‍💻 View GitHub user profiles with achievements and stats
• 📦 Get detailed information on any public repository
• 📚 Browse through all public repos with buttons and menus
• 📈 See total stars, forks, watchers, and commits
• 🧠 Analyze all languages used with pie chart visualization
• 📰 View recent public GitHub activity

---

💻 Commands & Previews

🧑‍💻 /user profile [username]

View a GitHub user profile with stats and achievements.

🧑‍💻 /user followers [username]

List followers of a GitHub user.

🧑‍💻 /user following [username]

List who a GitHub user is following.

🧑‍💻 /user statistics [username]

Summary stats about a GitHub user.

🧑‍💻 /user repos [username]

List public repositories for a GitHub user.

🧑‍💻 /user languages [username]

Aggregated language usage across all public repositories.

🧑‍💻 /user activity [username]

Show recent public GitHub activity.

🧑‍💻 /user stars [username]

List repositories starred by a GitHub user.

🧑‍💻 /user gists [username]

List public gists for a GitHub user.

🧑‍💻 /user organizations [username]

List organizations a GitHub user belongs to.

---

📦 /repo [username] [repo]

Get detailed information on a GitHub repository.

---

🔍 /search repositories [query]

Search GitHub repositories.

🚀 Getting Started

git clone https://github.com/your-username/github-stats-bot.git
cd github-stats-bot
npm install

Rename the .env.example to .env.example and fill in the following fields.

# Discord Bot Token
TOKEN=your_discord_bot_token_here

# Discord Application (Client) ID
CLIENT_ID=your_discord_application_id_here

# Your test server (guild) ID – used for fast dev command registration
GUILD_ID=your_guild_id_here

# Optional: Set to 'dev' to skip global command registration during development
ENVIRONMENT=dev

# Used to bypass githubs rate limits of 60 req per hour
GITHUB_TOKEN=ghp_yourGeneratedTokenHere

Run the bot:

node src/index.js

🧪 Tech Stack

• Node.js + Discord.js v14

• GitHub REST API (with personal access token)

• Chart.js via chartjs-node-canvas (for language pie charts)

🛠️ Contributing

PRs are welcome! Please fork the repo and submit your improvements or suggestions.

📄 License

MIT © @LachlanDev