gitradar 0.1.5__tar.gz

gitradar-0.1.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GitRadar Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO берез, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
+THE USE OR OTHER DEALINGS IN THE SOFTWARE.

gitradar-0.1.5/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: gitradar
+Version: 0.1.5
+Summary: CLI tool for GitHub market & gap analysis using LLM and GitHub REST API
+Author-email: GitRadar Developer <developer@example.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: flask>=3.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Dynamic: license-file
+
+# 📡 GitRadar
+
+<p align="center">
+  <img src="./assets/gitradar-banner.jpg" alt="GitRadar Banner" width="850"/>
+</p>
+
+<p align="center">
+  <b>Smart GitHub Market & Gap Analysis Tool Driven by AI & GitHub REST API</b><br>
+  <i>Validate your developer project ideas in seconds — via Rich Terminal CLI, Interactive Web Dashboard, or 1-Click Vercel Web Demo.</i>
+</p>
+
+<p align="center">
+  <a href="https://github.com/AtaCanYmc/GitRadar/actions"><img src="https://img.shields.io/github/actions/workflow/status/AtaCanYmc/GitRadar/ci.yml?branch=main&style=flat-square&logo=github&label=CI" alt="CI Status"></a>
+  <a href="https://pypi.org/project/gitradar/"><img src="https://img.shields.io/pypi/v/gitradar?style=flat-square&color=blue&logo=pypi" alt="PyPI Version"></a>
+  <a href="https://pypi.org/project/gitradar/"><img src="https://img.shields.io/pypi/pyversions/gitradar?style=flat-square&logo=python" alt="Python Versions"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/github/license/AtaCanYmc/GitRadar?style=flat-square" alt="License"></a>
+  <a href="https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FAtaCanYmc%2FGitRadar&root-directory=demo"><img src="https://vercel.com/button" alt="Deploy with Vercel"></a>
+</p>
+
+---
+
+## 💡 What is GitRadar?
+
+**GitRadar** is an open-source AI developer tool designed for developers, creators, and founders to perform instant **Market & Gap Analysis** on software project concepts.
+
+Before spending weeks building a new side project or open-source tool, GitRadar helps you answer critical questions:
+- *What open-source repositories already exist for this concept on GitHub?*
+- *What capabilities are existing repos missing (unmet market needs)?*
+- *What unique differentiators will make your project stand out?*
+- *How should you architect the software, what technology stack to choose, and what open-source building blocks can you leverage?*
+
+GitRadar expands your raw idea into intelligent GitHub queries, fetches candidate repositories via the GitHub REST API, semantically analyzes competitors using direct **OpenAI-compatible AI connections** (supporting OpenAI, Groq, DeepSeek, OpenRouter, and Ollama), and renders an executive report in your terminal, local **Web Dashboard**, or hosted **Vercel Web Demo**.
+
+---
+
+## ✨ Key Features
+
+- 🧠 **AI Query Expansion**: Translates raw developer ideas into optimized search keywords, language filters, and GitHub topic tags (`#cli`, `#ai`, `#devtools`).
+- 🛠️ **Technical Implementation & Open-Source Roadmap**: Recommends architecture overviews, tech stacks, and relevant open-source libraries (`Typer`, `LiteLLM`, `Qdrant`, `Tree-sitter`, etc.) to build your idea.
+- 🌐 **AI Response Language Choice**: Choose report output languages (`English`, `Turkish`, `Spanish`, `German`, `French`, etc.) via `--lang` flag or Web UI settings.
+- 📥 **Web UI Report Export**: Export generated reports directly to **Markdown (`.md`)**, **JSON (`.json`)**, or **Copy to Clipboard**.
+- ⚙️ **In-Browser Settings Modal**: Configure models, repository limits, AI response language, and custom Groq / GitHub API keys on the fly.
+- ⚡ **1-Click Vercel Web Demo (`demo/`)**: Deploy a serverless web demo on Vercel where anyone can run GitRadar using their own API keys safely.
+- 🎯 **Semantic Gap Analysis**: Synthesizes market saturation levels, competitor profiles, unmet needs, differentiators, and strategic recommendations.
+- 🎨 **Rich Terminal UX & Web Dashboard**: Color-coded terminal panels via Rich, glassmorphic dark/light UI modes, EN/TR UI i18n translation switcher, and RealFaviconGenerator favicons.
+
+---
+
+## 🚀 1-Click Vercel Web Demo
+
+Deploy your own Web Demo instance to Vercel instantly:
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FAtaCanYmc%2FGitRadar&root-directory=demo)
+
+---
+
+## 🛠️ Quick Start & Installation
+
+Install GitRadar from PyPI or locally:
+
+```bash
+pip install gitradar
+```
+
+Or install from source in editable mode:
+
+```bash
+git clone https://github.com/AtaCanYmc/GitRadar.git
+cd GitRadar
+pip install -e ".[dev]"
+```
+
+---
+
+## 🔑 Configuration
+
+GitRadar uses a universal **OpenAI-compatible connection schema** (`api_key`, `base_url`, `model`). It works out-of-the-box with **OpenAI**, **Groq**, **DeepSeek**, **OpenRouter**, or local self-hosted models (**Ollama**, **vLLM**, **LM Studio**).
+
+1. **Set your API Key** (OpenAI, Groq, or compatible provider):
+   ```bash
+   # Standard OpenAI
+   gitradar config --openai-api-key "sk-..."
+
+   # Or Groq (auto-routed to Groq OpenAI endpoint)
+   gitradar config --openai-api-key "gsk_..."
+   # Or legacy flag: gitradar config --groq-api-key "gsk_..."
+   ```
+
+2. *(Optional)* **Set a Custom Base URL** for alternative providers:
+   ```bash
+   # Groq
+   gitradar config --base-url "https://api.groq.com/openai/v1" --model "llama-3.3-70b-versatile"
+
+   # DeepSeek
+   gitradar config --base-url "https://api.deepseek.com" --model "deepseek-chat"
+
+   # Local Ollama
+   gitradar config --base-url "http://localhost:11434/v1" --model "llama3.2"
+   ```
+
+3. *(Optional)* **Set a GitHub Access Token** to boost API rate limits (from 60 to 5,000 requests/hour):
+   ```bash
+   gitradar config --github-token "ghp_your_github_token_here"
+   ```
+
+4. *(Optional)* **Set Default Output Language & Model**:
+   ```bash
+   gitradar config --lang Turkish --model gpt-4o-mini
+   ```
+
+5. **Inspect Active Settings**:
+   ```bash
+   gitradar config --show
+   ```
+
+---
+
+## 💻 CLI Commands & Usage
+
+### 💡 1. `gitradar analyze <IDEA>`
+
+Executes the full end-to-end AI market and gap analysis workflow in the terminal:
+
+```bash
+gitradar analyze "AI powered code review tool for terminal and git hooks" --lang Turkish
+```
+
+**Options:**
+- `--limit` / `-l`: Maximum repositories to evaluate (Default: `10`)
+- `--min-relevance` / `-r`: Minimum relevance score threshold percentage (Default: `50`)
+- `--model` / `-m`: Override AI model (e.g. `gpt-4o-mini`, `gpt-4o`, `llama-3.3-70b-versatile`, `deepseek-chat`)
+- `--api-key` / `-k`: Override API Key for this run
+- `--base-url` / `-u`: Override Base URL endpoint for this run
+- `--lang` / `--language`: Set output language for AI report (e.g. `Turkish`, `English`, `Spanish`)
+
+---
+
+### 🌐 2. `gitradar ui`
+
+Launches the local interactive web dashboard in your default browser:
+
+```bash
+gitradar ui --port 5000
+```
+
+---
+
+### 🔍 3. `gitradar search <QUERY>`
+
+Performs a fast, direct GitHub repository search without LLM synthesis:
+
+```bash
+gitradar search "terminal devtools" --limit 5 --sort stars
+```
+
+---
+
+### ⚙️ 4. `gitradar config`
+
+View or update credentials and preferences:
+
+```bash
+gitradar config --show
+```
+
+---
+
+## 🐍 Python SDK Usage
+
+Import GitRadar services directly in Python scripts:
+
+```python
+import asyncio
+from gitradar.services.github import GitHubService
+from gitradar.services.llm import LLMService
+
+async def main():
+    idea = "AI automated documentation generator"
+    
+    github_service = GitHubService()
+    llm_service = LLMService(language="Turkish")
+
+    # 1. Expand idea into search keywords
+    queries = llm_service.expand_idea_to_queries(idea, language="Turkish")
+
+    # 2. Fetch candidate repos
+    repos = await github_service.search_and_enrich(
+        keywords=queries.search_keywords,
+        topics=queries.github_topics,
+        limit=5,
+    )
+
+    # 3. Synthesize Market & Gap Report with Tech Roadmap
+    report = llm_service.analyze_market_and_gaps(idea, repos, language="Turkish")
+    print("Market Saturation:", report.market_saturation)
+    print("Opportunity Score:", report.opportunity_score)
+    if report.implementation_guide:
+        print("Recommended Stack:", report.implementation_guide.recommended_tech_stack)
+
+asyncio.run(main())
+```
+
+---
+
+## 🧪 Testing
+
+Run unit and integration tests with `pytest`:
+
+```bash
+pytest
+```
+
+---
+
+## 📚 Documentation Index
+
+- [ARCHITECTURE.md](./ARCHITECTURE.md): Deep-dive into technical design, data models, and prompt engine.
+- [demo/README.md](./demo/README.md): Step-by-step Vercel Web Demo deployment guide.
+- [CONTRIBUTING.md](./CONTRIBUTING.md): PR guidelines, coding standards, and conventional commits.
+- [SECURITY.md](./SECURITY.md): Security policy and vulnerability reporting.
+- [CHANGELOG.md](./CHANGELOG.md): Semantic release history.
+- [examples/README.md](./examples/README.md): Code samples and JSON report schemas.
+
+---
+
+## 📄 License
+
+GitRadar is open-source software licensed under the [MIT License](./LICENSE).

gitradar-0.1.5/README.md

@@ -0,0 +1,228 @@
+# 📡 GitRadar
+
+<p align="center">
+  <img src="./assets/gitradar-banner.jpg" alt="GitRadar Banner" width="850"/>
+</p>
+
+<p align="center">
+  <b>Smart GitHub Market & Gap Analysis Tool Driven by AI & GitHub REST API</b><br>
+  <i>Validate your developer project ideas in seconds — via Rich Terminal CLI, Interactive Web Dashboard, or 1-Click Vercel Web Demo.</i>
+</p>
+
+<p align="center">
+  <a href="https://github.com/AtaCanYmc/GitRadar/actions"><img src="https://img.shields.io/github/actions/workflow/status/AtaCanYmc/GitRadar/ci.yml?branch=main&style=flat-square&logo=github&label=CI" alt="CI Status"></a>
+  <a href="https://pypi.org/project/gitradar/"><img src="https://img.shields.io/pypi/v/gitradar?style=flat-square&color=blue&logo=pypi" alt="PyPI Version"></a>
+  <a href="https://pypi.org/project/gitradar/"><img src="https://img.shields.io/pypi/pyversions/gitradar?style=flat-square&logo=python" alt="Python Versions"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/github/license/AtaCanYmc/GitRadar?style=flat-square" alt="License"></a>
+  <a href="https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FAtaCanYmc%2FGitRadar&root-directory=demo"><img src="https://vercel.com/button" alt="Deploy with Vercel"></a>
+</p>
+
+---
+
+## 💡 What is GitRadar?
+
+**GitRadar** is an open-source AI developer tool designed for developers, creators, and founders to perform instant **Market & Gap Analysis** on software project concepts.
+
+Before spending weeks building a new side project or open-source tool, GitRadar helps you answer critical questions:
+- *What open-source repositories already exist for this concept on GitHub?*
+- *What capabilities are existing repos missing (unmet market needs)?*
+- *What unique differentiators will make your project stand out?*
+- *How should you architect the software, what technology stack to choose, and what open-source building blocks can you leverage?*
+
+GitRadar expands your raw idea into intelligent GitHub queries, fetches candidate repositories via the GitHub REST API, semantically analyzes competitors using direct **OpenAI-compatible AI connections** (supporting OpenAI, Groq, DeepSeek, OpenRouter, and Ollama), and renders an executive report in your terminal, local **Web Dashboard**, or hosted **Vercel Web Demo**.
+
+---
+
+## ✨ Key Features
+
+- 🧠 **AI Query Expansion**: Translates raw developer ideas into optimized search keywords, language filters, and GitHub topic tags (`#cli`, `#ai`, `#devtools`).
+- 🛠️ **Technical Implementation & Open-Source Roadmap**: Recommends architecture overviews, tech stacks, and relevant open-source libraries (`Typer`, `LiteLLM`, `Qdrant`, `Tree-sitter`, etc.) to build your idea.
+- 🌐 **AI Response Language Choice**: Choose report output languages (`English`, `Turkish`, `Spanish`, `German`, `French`, etc.) via `--lang` flag or Web UI settings.
+- 📥 **Web UI Report Export**: Export generated reports directly to **Markdown (`.md`)**, **JSON (`.json`)**, or **Copy to Clipboard**.
+- ⚙️ **In-Browser Settings Modal**: Configure models, repository limits, AI response language, and custom Groq / GitHub API keys on the fly.
+- ⚡ **1-Click Vercel Web Demo (`demo/`)**: Deploy a serverless web demo on Vercel where anyone can run GitRadar using their own API keys safely.
+- 🎯 **Semantic Gap Analysis**: Synthesizes market saturation levels, competitor profiles, unmet needs, differentiators, and strategic recommendations.
+- 🎨 **Rich Terminal UX & Web Dashboard**: Color-coded terminal panels via Rich, glassmorphic dark/light UI modes, EN/TR UI i18n translation switcher, and RealFaviconGenerator favicons.
+
+---
+
+## 🚀 1-Click Vercel Web Demo
+
+Deploy your own Web Demo instance to Vercel instantly:
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FAtaCanYmc%2FGitRadar&root-directory=demo)
+
+---
+
+## 🛠️ Quick Start & Installation
+
+Install GitRadar from PyPI or locally:
+
+```bash
+pip install gitradar
+```
+
+Or install from source in editable mode:
+
+```bash
+git clone https://github.com/AtaCanYmc/GitRadar.git
+cd GitRadar
+pip install -e ".[dev]"
+```
+
+---
+
+## 🔑 Configuration
+
+GitRadar uses a universal **OpenAI-compatible connection schema** (`api_key`, `base_url`, `model`). It works out-of-the-box with **OpenAI**, **Groq**, **DeepSeek**, **OpenRouter**, or local self-hosted models (**Ollama**, **vLLM**, **LM Studio**).
+
+1. **Set your API Key** (OpenAI, Groq, or compatible provider):
+   ```bash
+   # Standard OpenAI
+   gitradar config --openai-api-key "sk-..."
+
+   # Or Groq (auto-routed to Groq OpenAI endpoint)
+   gitradar config --openai-api-key "gsk_..."
+   # Or legacy flag: gitradar config --groq-api-key "gsk_..."
+   ```
+
+2. *(Optional)* **Set a Custom Base URL** for alternative providers:
+   ```bash
+   # Groq
+   gitradar config --base-url "https://api.groq.com/openai/v1" --model "llama-3.3-70b-versatile"
+
+   # DeepSeek
+   gitradar config --base-url "https://api.deepseek.com" --model "deepseek-chat"
+
+   # Local Ollama
+   gitradar config --base-url "http://localhost:11434/v1" --model "llama3.2"
+   ```
+
+3. *(Optional)* **Set a GitHub Access Token** to boost API rate limits (from 60 to 5,000 requests/hour):
+   ```bash
+   gitradar config --github-token "ghp_your_github_token_here"
+   ```
+
+4. *(Optional)* **Set Default Output Language & Model**:
+   ```bash
+   gitradar config --lang Turkish --model gpt-4o-mini
+   ```
+
+5. **Inspect Active Settings**:
+   ```bash
+   gitradar config --show
+   ```
+
+---
+
+## 💻 CLI Commands & Usage
+
+### 💡 1. `gitradar analyze <IDEA>`
+
+Executes the full end-to-end AI market and gap analysis workflow in the terminal:
+
+```bash
+gitradar analyze "AI powered code review tool for terminal and git hooks" --lang Turkish
+```
+
+**Options:**
+- `--limit` / `-l`: Maximum repositories to evaluate (Default: `10`)
+- `--min-relevance` / `-r`: Minimum relevance score threshold percentage (Default: `50`)
+- `--model` / `-m`: Override AI model (e.g. `gpt-4o-mini`, `gpt-4o`, `llama-3.3-70b-versatile`, `deepseek-chat`)
+- `--api-key` / `-k`: Override API Key for this run
+- `--base-url` / `-u`: Override Base URL endpoint for this run
+- `--lang` / `--language`: Set output language for AI report (e.g. `Turkish`, `English`, `Spanish`)
+
+---
+
+### 🌐 2. `gitradar ui`
+
+Launches the local interactive web dashboard in your default browser:
+
+```bash
+gitradar ui --port 5000
+```
+
+---
+
+### 🔍 3. `gitradar search <QUERY>`
+
+Performs a fast, direct GitHub repository search without LLM synthesis:
+
+```bash
+gitradar search "terminal devtools" --limit 5 --sort stars
+```
+
+---
+
+### ⚙️ 4. `gitradar config`
+
+View or update credentials and preferences:
+
+```bash
+gitradar config --show
+```
+
+---
+
+## 🐍 Python SDK Usage
+
+Import GitRadar services directly in Python scripts:
+
+```python
+import asyncio
+from gitradar.services.github import GitHubService
+from gitradar.services.llm import LLMService
+
+async def main():
+    idea = "AI automated documentation generator"
+    
+    github_service = GitHubService()
+    llm_service = LLMService(language="Turkish")
+
+    # 1. Expand idea into search keywords
+    queries = llm_service.expand_idea_to_queries(idea, language="Turkish")
+
+    # 2. Fetch candidate repos
+    repos = await github_service.search_and_enrich(
+        keywords=queries.search_keywords,
+        topics=queries.github_topics,
+        limit=5,
+    )
+
+    # 3. Synthesize Market & Gap Report with Tech Roadmap
+    report = llm_service.analyze_market_and_gaps(idea, repos, language="Turkish")
+    print("Market Saturation:", report.market_saturation)
+    print("Opportunity Score:", report.opportunity_score)
+    if report.implementation_guide:
+        print("Recommended Stack:", report.implementation_guide.recommended_tech_stack)
+
+asyncio.run(main())
+```
+
+---
+
+## 🧪 Testing
+
+Run unit and integration tests with `pytest`:
+
+```bash
+pytest
+```
+
+---
+
+## 📚 Documentation Index
+
+- [ARCHITECTURE.md](./ARCHITECTURE.md): Deep-dive into technical design, data models, and prompt engine.
+- [demo/README.md](./demo/README.md): Step-by-step Vercel Web Demo deployment guide.
+- [CONTRIBUTING.md](./CONTRIBUTING.md): PR guidelines, coding standards, and conventional commits.
+- [SECURITY.md](./SECURITY.md): Security policy and vulnerability reporting.
+- [CHANGELOG.md](./CHANGELOG.md): Semantic release history.
+- [examples/README.md](./examples/README.md): Code samples and JSON report schemas.
+
+---
+
+## 📄 License
+
+GitRadar is open-source software licensed under the [MIT License](./LICENSE).

gitradar-0.1.5/demo/api/index.py

@@ -0,0 +1,14 @@
+import os
+import sys
+from pathlib import Path
+
+# Add demo directory to sys.path so bundled gitradar package is importable on Vercel
+DEMO_DIR = Path(__file__).parent.parent
+if str(DEMO_DIR) not in sys.path:
+    sys.path.insert(0, str(DEMO_DIR))
+
+# Import monkeypatch for Python compatibility
+import gitradar  # noqa: F401
+from gitradar.web.app import create_app
+
+app = create_app()

gitradar-0.1.5/demo/gitradar/__init__.py

@@ -0,0 +1,22 @@
+"""
+GitRadar: Smart GitHub Market & Gap Analysis CLI tool.
+"""
+
+import sys
+import typing
+
+# Fix compatibility issue on Python < 3.11 where third-party packages (e.g. litellm)
+# attempt to import 'NotRequired' or other PEP 655/673 types directly from 'typing'.
+if sys.version_info < (3, 11):
+    try:
+        import typing_extensions
+
+        for _name in ("NotRequired", "Required", "Self", "Never", "LiteralString", "TypeAlias", "Override", "dataclass_transform"):
+            if not hasattr(typing, _name) and hasattr(typing_extensions, _name):
+                setattr(typing, _name, getattr(typing_extensions, _name))
+    except ImportError:
+        pass
+
+__version__ = "0.2.0"
+__author__ = "GitRadar Developer"
+