ai-logmaster 1.0.0__tar.gz

ai_logmaster-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+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 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.

ai_logmaster-1.0.0/PKG-INFO

@@ -0,0 +1,340 @@
+Metadata-Version: 2.4
+Name: ai-logmaster
+Version: 1.0.0
+Summary: Smart error analysis tool with AI-powered solutions
+Home-page: https://github.com/Divodude/ai-logmaster
+Author: Divyansh
+Author-email: ry604492@gmail.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: langchain>=1.0.0
+Requires-Dist: langchain-community>=0.4.0
+Requires-Dist: langchain-core>=1.2.0
+Requires-Dist: langchain-openai>=1.0.0
+Requires-Dist: langgraph>=1.0.0
+Requires-Dist: duckduckgo-search>=8.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.32.0
+Provides-Extra: rag
+Requires-Dist: faiss-cpu>=1.13.0; extra == "rag"
+Requires-Dist: beautifulsoup4>=4.12.0; extra == "rag"
+Requires-Dist: lxml>=6.0.0; extra == "rag"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# AI LogMaster
+
+**Smart error analysis tool with AI-powered solutions**
+
+Wrap any command and get instant, intelligent debugging help powered by AI and documentation retrieval.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+## Features
+
+- 🤖 **AI-Powered Analysis** - Uses LangChain and LLMs for intelligent error diagnosis
+- 📚 **Smart Documentation Retrieval** - Automatically fetches relevant docs when needed
+- 💰 **API Quota Optimization** - Intelligent agent minimizes API calls (70-80% reduction)
+- ⚡ **Zero Setup** - Just wrap your command and go
+- 🔧 **Multi-Provider Support** - Works with OpenAI, Anthropic, Google, NVIDIA, and more
+- 🎯 **Pattern-Based Caching** - Common errors use cached solutions (no API calls)
+
+## Installation
+
+```bash
+pip install ai-logmaster
+```
+
+## Quick Start
+
+### 1. Initialize Configuration
+
+```bash
+logmaster init
+```
+
+This creates `~/.ai-logmaster/config.yaml`. Edit it to set your API key:
+
+```yaml
+ai:
+  provider: "nvidia"
+  api_key: "your-api-key-here"
+```
+
+Or use environment variable:
+```bash
+export NVIDIA_API_KEY="your-api-key"
+```
+
+### 2. Run Your Command
+
+```bash
+logmaster run "python your_script.py"
+```
+
+That's it! The tool will:
+1. ✅ Execute your command
+2. ✅ Capture output in real-time
+3. ✅ Detect errors automatically
+4. ✅ Analyze with AI
+5. ✅ Show solutions with documentation references
+
+## Example Output
+
+```
+[TRIAGE] Executing: python broken.py
+============================================================
+[ERROR]  TypeError: unsupported operand type(s) for /: 'int' and 'str'
+============================================================
+
+[TRIAGE] ⚠️  Error detected! Analyzing...
+
+[AGENT] Classifying error type...
+[AGENT] Error type: type, Needs docs: True
+[AGENT] Fetching documentation from web...
+[AGENT] ✓ Fetched 989 chars of documentation
+[AGENT] Analyzing with AI...
+[AGENT] ✓ Analysis complete (API calls: 1)
+
+╔══════════════════════════════════════════════════════════╗
+║ 🔍 DIAGNOSIS                                             ║
+╠══════════════════════════════════════════════════════════╣
+║ Type: TypeError                                          ║
+║ Confidence: 90%                                          ║
+║ Method: AI + Docs                                        ║
+╠══════════════════════════════════════════════════════════╣
+║ 📋 ROOT CAUSE                                            ║
+╠══════════════════════════════════════════════════════════╣
+║ Division operation between integer and string           ║
+╠══════════════════════════════════════════════════════════╣
+║ 💡 RECOMMENDED FIXES                                     ║
+╠══════════════════════════════════════════════════════════╣
+║ 1. Ensure divisor is numeric type                       ║
+║ 2. Convert string to int/float if needed                ║
+║ 3. Validate inputs before operations                    ║
+╠══════════════════════════════════════════════════════════╣
+║ 📚 DOCUMENTATION SOURCES                                 ║
+╠══════════════════════════════════════════════════════════╣
+║ • https://docs.python.org/3/library/exceptions.html     ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+## Configuration
+
+### AI Providers
+
+Edit `~/.ai-logmaster/config.yaml`:
+
+#### NVIDIA (Default - Free Tier Available)
+```yaml
+ai:
+  provider: "nvidia"
+  model: "mistralai/mistral-small-3.1-24b-instruct-2503"
+  api_key: "${NVIDIA_API_KEY}"
+  base_url: "https://integrate.api.nvidia.com/v1"
+```
+
+#### OpenAI
+```yaml
+ai:
+  provider: "openai"
+  model: "gpt-4"
+  api_key: "${OPENAI_API_KEY}"
+```
+
+#### Anthropic
+```yaml
+ai:
+  provider: "anthropic"
+  model: "claude-3-opus-20240229"
+  api_key: "${ANTHROPIC_API_KEY}"
+```
+
+#### Google
+```yaml
+ai:
+  provider: "google"
+  model: "gemini-pro"
+  api_key: "${GOOGLE_API_KEY}"
+```
+
+### Agent Optimization
+
+Control when AI is used to minimize API costs:
+
+```yaml
+agent:
+  use_cached_solutions: true  # Use cached solutions for common errors
+  fetch_documentation: true   # Fetch docs from web
+  
+  # These errors use cached solutions (0 API calls)
+  cached_error_types:
+    - connection
+    - import
+    - memory
+    - timeout
+    - permission
+  
+  # These errors use AI + docs (1 API call each)
+  complex_error_types:
+    - syntax
+    - type
+    - value
+    - unknown
+```
+
+### Quota Management
+
+```yaml
+quota:
+  enabled: true
+  daily_limit: 100      # Maximum API calls per day
+  warn_threshold: 0.8   # Warn at 80%
+```
+
+## How It Works
+
+### Smart Agent Flow
+
+```
+Error Detected
+    ↓
+Classify Error (Pattern Matching - FREE)
+    ↓
+    ├─→ Common Error? → Use Cached Solution (0 API calls)
+    │
+    └─→ Complex/Unknown? → Fetch Docs (FREE) → AI Analysis (1 API call)
+```
+
+### API Call Optimization
+
+**Without Agent**: Every error = 1 API call
+
+**With Agent**:
+- Connection errors: 0 API calls ✅
+- Import errors: 0 API calls ✅
+- Memory errors: 0 API calls ✅
+- Timeout errors: 0 API calls ✅
+- Permission errors: 0 API calls ✅
+- Syntax errors: 1 API call 💰
+- Type errors: 1 API call 💰
+- Unknown errors: 1 API call 💰
+
+**Result**: 70-80% reduction in API calls!
+
+## Usage Examples
+
+### Python Script
+```bash
+logmaster run "python app.py"
+```
+
+### Node.js Application
+```bash
+logmaster run "node server.js"
+```
+
+### Shell Script
+```bash
+logmaster run "bash deploy.sh"
+```
+
+### Complex Command
+```bash
+logmaster run "npm run build && npm start"
+```
+
+### With Custom Buffer Size
+```bash
+logmaster run "python script.py" --buffer 200
+```
+
+## Advanced Features
+
+### RAG Support (Optional)
+
+Install with RAG capabilities for enhanced documentation retrieval:
+
+```bash
+pip install ai-logmaster[rag]
+```
+
+Enable in config:
+```yaml
+rag:
+  enabled: true
+  vector_store: "faiss"
+  chunk_size: 1000
+  top_k: 3
+```
+
+## Development
+
+### Install from Source
+
+```bash
+git clone https://github.com/Divodude/ai-logmaster.git
+cd ai-logmaster
+pip install -e .
+```
+
+### Run Tests
+
+```bash
+python run_agent_tests.py
+```
+
+## Requirements
+
+- Python 3.8+
+- API key for your chosen AI provider (NVIDIA, OpenAI, Anthropic, or Google)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR.
+
+## Support
+
+- 📧 Email: ry604492@gmail.com
+- 🐛 Issues: https://github.com/Divodude/ai-logmaster/issues
+- 📖 Docs: https://github.com/Divodude/ai-logmaster
+
+## Acknowledgments
+
+Built with:
+- [LangChain](https://github.com/langchain-ai/langchain) - LLM framework
+- [LangGraph](https://github.com/langchain-ai/langgraph) - Agent orchestration
+- [DuckDuckGo Search](https://github.com/deedy5/duckduckgo_search) - Documentation retrieval
+
+---
+
+**Made with ❤️ by Divyansh**

ai_logmaster-1.0.0/README.md

@@ -0,0 +1,292 @@
+# AI LogMaster
+
+**Smart error analysis tool with AI-powered solutions**
+
+Wrap any command and get instant, intelligent debugging help powered by AI and documentation retrieval.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+## Features
+
+- 🤖 **AI-Powered Analysis** - Uses LangChain and LLMs for intelligent error diagnosis
+- 📚 **Smart Documentation Retrieval** - Automatically fetches relevant docs when needed
+- 💰 **API Quota Optimization** - Intelligent agent minimizes API calls (70-80% reduction)
+- ⚡ **Zero Setup** - Just wrap your command and go
+- 🔧 **Multi-Provider Support** - Works with OpenAI, Anthropic, Google, NVIDIA, and more
+- 🎯 **Pattern-Based Caching** - Common errors use cached solutions (no API calls)
+
+## Installation
+
+```bash
+pip install ai-logmaster
+```
+
+## Quick Start
+
+### 1. Initialize Configuration
+
+```bash
+logmaster init
+```
+
+This creates `~/.ai-logmaster/config.yaml`. Edit it to set your API key:
+
+```yaml
+ai:
+  provider: "nvidia"
+  api_key: "your-api-key-here"
+```
+
+Or use environment variable:
+```bash
+export NVIDIA_API_KEY="your-api-key"
+```
+
+### 2. Run Your Command
+
+```bash
+logmaster run "python your_script.py"
+```
+
+That's it! The tool will:
+1. ✅ Execute your command
+2. ✅ Capture output in real-time
+3. ✅ Detect errors automatically
+4. ✅ Analyze with AI
+5. ✅ Show solutions with documentation references
+
+## Example Output
+
+```
+[TRIAGE] Executing: python broken.py
+============================================================
+[ERROR]  TypeError: unsupported operand type(s) for /: 'int' and 'str'
+============================================================
+
+[TRIAGE] ⚠️  Error detected! Analyzing...
+
+[AGENT] Classifying error type...
+[AGENT] Error type: type, Needs docs: True
+[AGENT] Fetching documentation from web...
+[AGENT] ✓ Fetched 989 chars of documentation
+[AGENT] Analyzing with AI...
+[AGENT] ✓ Analysis complete (API calls: 1)
+
+╔══════════════════════════════════════════════════════════╗
+║ 🔍 DIAGNOSIS                                             ║
+╠══════════════════════════════════════════════════════════╣
+║ Type: TypeError                                          ║
+║ Confidence: 90%                                          ║
+║ Method: AI + Docs                                        ║
+╠══════════════════════════════════════════════════════════╣
+║ 📋 ROOT CAUSE                                            ║
+╠══════════════════════════════════════════════════════════╣
+║ Division operation between integer and string           ║
+╠══════════════════════════════════════════════════════════╣
+║ 💡 RECOMMENDED FIXES                                     ║
+╠══════════════════════════════════════════════════════════╣
+║ 1. Ensure divisor is numeric type                       ║
+║ 2. Convert string to int/float if needed                ║
+║ 3. Validate inputs before operations                    ║
+╠══════════════════════════════════════════════════════════╣
+║ 📚 DOCUMENTATION SOURCES                                 ║
+╠══════════════════════════════════════════════════════════╣
+║ • https://docs.python.org/3/library/exceptions.html     ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+## Configuration
+
+### AI Providers
+
+Edit `~/.ai-logmaster/config.yaml`:
+
+#### NVIDIA (Default - Free Tier Available)
+```yaml
+ai:
+  provider: "nvidia"
+  model: "mistralai/mistral-small-3.1-24b-instruct-2503"
+  api_key: "${NVIDIA_API_KEY}"
+  base_url: "https://integrate.api.nvidia.com/v1"
+```
+
+#### OpenAI
+```yaml
+ai:
+  provider: "openai"
+  model: "gpt-4"
+  api_key: "${OPENAI_API_KEY}"
+```
+
+#### Anthropic
+```yaml
+ai:
+  provider: "anthropic"
+  model: "claude-3-opus-20240229"
+  api_key: "${ANTHROPIC_API_KEY}"
+```
+
+#### Google
+```yaml
+ai:
+  provider: "google"
+  model: "gemini-pro"
+  api_key: "${GOOGLE_API_KEY}"
+```
+
+### Agent Optimization
+
+Control when AI is used to minimize API costs:
+
+```yaml
+agent:
+  use_cached_solutions: true  # Use cached solutions for common errors
+  fetch_documentation: true   # Fetch docs from web
+  
+  # These errors use cached solutions (0 API calls)
+  cached_error_types:
+    - connection
+    - import
+    - memory
+    - timeout
+    - permission
+  
+  # These errors use AI + docs (1 API call each)
+  complex_error_types:
+    - syntax
+    - type
+    - value
+    - unknown
+```
+
+### Quota Management
+
+```yaml
+quota:
+  enabled: true
+  daily_limit: 100      # Maximum API calls per day
+  warn_threshold: 0.8   # Warn at 80%
+```
+
+## How It Works
+
+### Smart Agent Flow
+
+```
+Error Detected
+    ↓
+Classify Error (Pattern Matching - FREE)
+    ↓
+    ├─→ Common Error? → Use Cached Solution (0 API calls)
+    │
+    └─→ Complex/Unknown? → Fetch Docs (FREE) → AI Analysis (1 API call)
+```
+
+### API Call Optimization
+
+**Without Agent**: Every error = 1 API call
+
+**With Agent**:
+- Connection errors: 0 API calls ✅
+- Import errors: 0 API calls ✅
+- Memory errors: 0 API calls ✅
+- Timeout errors: 0 API calls ✅
+- Permission errors: 0 API calls ✅
+- Syntax errors: 1 API call 💰
+- Type errors: 1 API call 💰
+- Unknown errors: 1 API call 💰
+
+**Result**: 70-80% reduction in API calls!
+
+## Usage Examples
+
+### Python Script
+```bash
+logmaster run "python app.py"
+```
+
+### Node.js Application
+```bash
+logmaster run "node server.js"
+```
+
+### Shell Script
+```bash
+logmaster run "bash deploy.sh"
+```
+
+### Complex Command
+```bash
+logmaster run "npm run build && npm start"
+```
+
+### With Custom Buffer Size
+```bash
+logmaster run "python script.py" --buffer 200
+```
+
+## Advanced Features
+
+### RAG Support (Optional)
+
+Install with RAG capabilities for enhanced documentation retrieval:
+
+```bash
+pip install ai-logmaster[rag]
+```
+
+Enable in config:
+```yaml
+rag:
+  enabled: true
+  vector_store: "faiss"
+  chunk_size: 1000
+  top_k: 3
+```
+
+## Development
+
+### Install from Source
+
+```bash
+git clone https://github.com/Divodude/ai-logmaster.git
+cd ai-logmaster
+pip install -e .
+```
+
+### Run Tests
+
+```bash
+python run_agent_tests.py
+```
+
+## Requirements
+
+- Python 3.8+
+- API key for your chosen AI provider (NVIDIA, OpenAI, Anthropic, or Google)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR.
+
+## Support
+
+- 📧 Email: ry604492@gmail.com
+- 🐛 Issues: https://github.com/Divodude/ai-logmaster/issues
+- 📖 Docs: https://github.com/Divodude/ai-logmaster
+
+## Acknowledgments
+
+Built with:
+- [LangChain](https://github.com/langchain-ai/langchain) - LLM framework
+- [LangGraph](https://github.com/langchain-ai/langgraph) - Agent orchestration
+- [DuckDuckGo Search](https://github.com/deedy5/duckduckgo_search) - Documentation retrieval
+
+---
+
+**Made with ❤️ by Divyansh**

ai_logmaster-1.0.0/ai_logmaster/__init__.py

@@ -0,0 +1,10 @@
+"""
+AI LogMaster - Smart Error Analysis with AI-Powered Solutions
+"""
+
+__version__ = "1.0.0"
+__author__ = "Your Name"
+
+from .config import get_config, init_config
+
+__all__ = ["get_config", "init_config"]