GitLab, Gitea, Forgejo, Codeberg, Sourcehut.

Author: Matars

README.md

@@ -1,6 +1,6 @@
 # gitfetch
 
-A neofetch-style CLI tool for GitHub statistics. Display your GitHub profile and stats in a beautiful, colorful terminal interface.
+A neofetch-style CLI tool for GitHub, GitLab, Gitea, Forgejo, Codeberg, and Sourcehut statistics. Display your profile and stats from various git hosting platforms in a beautiful, colorful terminal interface.
 
 <img width="3024" height="1964" alt="image" src="https://github.com/user-attachments/assets/bbb18d5d-4787-4998-a352-e8f4e59642c0" />
 
@@ -9,41 +9,33 @@ A neofetch-style CLI tool for GitHub statistics. Display your GitHub profile and
 ## Features
 
 - Neofetch-style display with ASCII art
-- Comprehensive GitHub statistics
+- Comprehensive statistics from multiple git hosting platforms
 - Smart SQLite-based caching system for faster subsequent runs
 - Persistent configuration with default username support
-- Uses GitHub CLI (gh) for authentication - no rate limits!
 - Cross-platform support (macOS and Linux)
-- First-run initialization with interactive setup
+- First-run initialization with interactive provider selection
 
-## Prerequisites
+## Supported Platforms
 
-**GitHub CLI (gh) must be installed and authenticated:**
+- **GitHub** - Uses GitHub CLI (gh) for authentication
+- **GitLab** - Uses GitLab CLI (glab) for authentication
+- **Gitea/Forgejo/Codeberg** - Uses personal access tokens
+- **Sourcehut** - Uses personal access tokens
 
-See installation instructions at: https://github.com/cli/cli#installation
+## Installation
 
-### macOS
+`gitfetch` can be installed without any prerequisites. During first-run setup, you'll be guided to install and authenticate with the necessary CLI tools or provide access tokens for your chosen git hosting platform.
 
-```bash
-brew install gh
-gh auth login
-```
-
-### Linux
-
-Then authenticate:
-
-```bash
-gh auth login
-```
+## First-run Setup
 
-### Verify Installation
+When you run `gitfetch` for the first time, you'll be prompted to:
 
-```bash
-gh auth status
-```
+1. **Choose your git hosting provider** (GitHub, GitLab, Gitea/Forgejo/Codeberg, or Sourcehut)
+2. **Install required CLI tools** (if using GitHub or GitLab)
+3. **Authenticate** with your chosen platform
+4. **Configure access tokens** (if using Gitea/Forgejo/Codeberg or Sourcehut)
 
-You should see: `✓ Logged in to github.com as YOUR_USERNAME`
+The setup process will provide helpful error messages and installation instructions if anything is missing.
 
 ## Installing `gitfetch`
 

src/gitfetch/cli.py

@@ -6,7 +6,6 @@
 import sys
 from typing import Optional
 
-from .fetcher import GitHubFetcher
 from .display import DisplayFormatter
 from .cache import CacheManager
 from .config import ConfigManager
@@ -105,7 +104,9 @@ def main() -> int:
     # Initialize components
     cache_expiry = config_manager.get_cache_expiry_hours()
     cache_manager = CacheManager(cache_expiry_hours=cache_expiry)
-    fetcher = GitHubFetcher()  # Uses gh CLI, no token needed
+    provider = config_manager.get_provider()
+    provider_url = config_manager.get_provider_url()
+    fetcher = _create_fetcher(provider, provider_url)
     formatter = DisplayFormatter(config_manager)
     if args.spaced:
         spaced = True
@@ -192,15 +193,59 @@ def refresh_cache():
 
 
 def _prompt_username() -> Optional[str]:
-    """Prompt user for GitHub username if not provided."""
+    """Prompt user for username if not provided."""
     try:
-        username = input("Enter GitHub username: ").strip()
+        username = input("Enter username: ").strip()
         return username if username else None
     except (KeyboardInterrupt, EOFError):
         print()
         return None
 
 
+def _prompt_provider() -> Optional[str]:
+    """Prompt user for git provider."""
+    try:
+        print("Available git providers:")
+        print("1. GitHub")
+        print("2. GitLab")
+        print("3. Gitea/Forgejo/Codeberg")
+        print("4. Sourcehut")
+
+        while True:
+            choice = input("Choose your git provider (1-4): ").strip()
+            if choice == '1':
+                return 'github'
+            elif choice == '2':
+                return 'gitlab'
+            elif choice == '3':
+                return 'gitea'
+            elif choice == '4':
+                return 'sourcehut'
+            else:
+                print("Invalid choice. Please enter 1-4.")
+    except (KeyboardInterrupt, EOFError):
+        print()
+        return None
+
+
+def _create_fetcher(provider: str, base_url: str):
+    """Create the appropriate fetcher for the provider."""
+    if provider == 'github':
+        from .fetcher import GitHubFetcher
+        return GitHubFetcher()
+    elif provider == 'gitlab':
+        from .fetcher import GitLabFetcher
+        return GitLabFetcher(base_url)
+    elif provider == 'gitea':
+        from .fetcher import GiteaFetcher
+        return GiteaFetcher(base_url)
+    elif provider == 'sourcehut':
+        from .fetcher import SourcehutFetcher
+        return SourcehutFetcher(base_url)
+    else:
+        raise ValueError(f"Unsupported provider: {provider}")
+
+
 def _initialize_gitfetch(config_manager: ConfigManager) -> bool:
     """
     Initialize gitfetch by creating config directory and setting
@@ -213,14 +258,42 @@ def _initialize_gitfetch(config_manager: ConfigManager) -> bool:
         True if initialization succeeded, False otherwise
     """
     try:
-        # Try to get authenticated user from GitHub CLI
-        fetcher = GitHubFetcher()
+        # Ask user for git provider
+        provider = _prompt_provider()
+        if not provider:
+            return False
+
+        config_manager.set_provider(provider)
+
+        # Set default URL for known providers
+        if provider == 'github':
+            config_manager.set_provider_url('https://api.github.com')
+        elif provider == 'gitlab':
+            config_manager.set_provider_url('https://gitlab.com')
+        elif provider == 'gitea':
+            url = input("Enter Gitea/Forgejo/Codeberg URL: ").strip()
+            if not url:
+                print("Provider URL required", file=sys.stderr)
+                return False
+            config_manager.set_provider_url(url)
+        elif provider == 'sourcehut':
+            config_manager.set_provider_url('https://git.sr.ht')
+
+        # Create appropriate fetcher
+        fetcher = _create_fetcher(provider, config_manager.get_provider_url())
+
+        # Try to get authenticated user
         try:
             username = fetcher.get_authenticated_user()
-            print(f"Using authenticated GitHub user: {username}")
+            print(f"Using authenticated user: {username}")
         except Exception as e:
             print(f"Could not get authenticated user: {e}")
-            print("Please ensure GitHub CLI is authenticated with: gh auth login")
+            if provider == 'github':
+                print("Please authenticate with: gh auth login")
+            elif provider == 'gitlab':
+                print("Please authenticate with: glab auth login")
+            else:
+                print("Please ensure you have a valid token configured")
             return False
 
         # Save configuration

src/gitfetch/config.py

@@ -126,9 +126,53 @@ def is_initialized(self) -> bool:
         Check if gitfetch has been initialized.
 
         Returns:
-            True if config exists and has default username
+            True if config exists and has default username and provider
         """
-        return self.CONFIG_FILE.exists() and bool(self.get_default_username())
+        return (self.CONFIG_FILE.exists() and
+                bool(self.get_default_username()) and
+                bool(self.get_provider()))
+
+    def get_provider(self) -> Optional[str]:
+        """
+        Get the git provider from config.
+
+        Returns:
+            Provider name (github, gitlab, gitea, etc.) or None if not set
+        """
+        provider = self.config.get('DEFAULT', 'provider', fallback='')
+        return provider if provider else None
+
+    def set_provider(self, provider: str) -> None:
+        """
+        Set the git provider in config.
+
+        Args:
+            provider: Git provider name (github, gitlab, gitea, etc.)
+        """
+        if 'DEFAULT' not in self.config:
+            self.config['DEFAULT'] = {}
+        self.config['DEFAULT']['provider'] = provider
+
+    def get_provider_url(self) -> Optional[str]:
+        """
+        Get the provider base URL from config.
+
+        Returns:
+            Base URL for the git provider or None if not set
+        """
+        url = self.config.get('DEFAULT', 'provider_url', fallback='')
+        return url if url else None
+
+    def set_provider_url(self, url: str) -> None:
+        """
+        Set the provider base URL in config.
+
+        Args:
+            url: Base URL for the git provider
+        """
+        if 'DEFAULT' not in self.config:
+            self.config['DEFAULT'] = {}
+        self.config['DEFAULT']['provider_url'] = url
 
     def save(self) -> None:
         """Save configuration to file."""