opspilot-ai 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

{opspilot_ai-0.1.0.dist-info → opspilot_ai-0.1.2.dist-info}/METADATA

@@ -1,16 +1,16 @@
 Metadata-Version: 2.4
 Name: opspilot-ai
-Version: 0.1.0
+Version: 0.1.2
 Summary: AI-powered production incident analysis tool using multi-agent systems
-Home-page: https://github.com/choudharikiranv15/opspilot
+Home-page: https://github.com/choudharikiranv15/OpsPilot-AI
 Author: Kiran Vijaykumar Choudhari
 Author-email: Kiran Vijaykumar Choudhari <choudharikiranv2003@gmail.com>
 License: MIT
-Project-URL: Homepage, https://github.com/choudharikiranv15/opspilot
-Project-URL: Documentation, https://github.com/choudharikiranv15/opspilot#readme
-Project-URL: Repository, https://github.com/choudharikiranv15/opspilot
-Project-URL: Bug Tracker, https://github.com/choudharikiranv15/opspilot/issues
-Project-URL: Changelog, https://github.com/choudharikiranv15/opspilot/releases
+Project-URL: Homepage, https://github.com/choudharikiranv15/OpsPilot-AI
+Project-URL: Documentation, https://github.com/choudharikiranv15/OpsPilot-AI#readme
+Project-URL: Repository, https://github.com/choudharikiranv15/OpsPilot-AI
+Project-URL: Bug Tracker, https://github.com/choudharikiranv15/OpsPilot-AI/issues
+Project-URL: Changelog, https://github.com/choudharikiranv15/OpsPilot-AI/releases
 Keywords: ai,mlops,devops,incident-analysis,sre,production-monitoring,agentic-ai,multi-agent,llm,observability,incident-response,automation
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -57,17 +57,21 @@ Dynamic: home-page
 Dynamic: license-file
 Dynamic: requires-python
 
-# OpsPilot 🤖
+# OpsPilot-AI 🤖
+
+[![PyPI version](https://badge.fury.io/py/opspilot-ai.svg)](https://pypi.org/project/opspilot-ai/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 > An intelligent agentic AI CLI tool for automated incident analysis and error resolution
 
-OpsPilot is your AI-powered Site Reliability Engineer that analyzes your projects, identifies runtime issues, and suggests safe fixes—all through a simple command-line interface.
+OpsPilot-AI is your AI-powered Site Reliability Engineer that analyzes your projects, identifies runtime issues, and suggests safe fixes—all through a simple command-line interface.
 
 ---
 
-## 🎯 What is OpsPilot?
+## 🎯 What is OpsPilot-AI?
 
-OpsPilot uses a **multi-agent AI architecture** to understand your project's context, form hypotheses about runtime issues, and provide evidence-based fix recommendations. Think of it as having an experienced SRE on your team, available 24/7.
+OpsPilot-AI uses a **multi-agent AI architecture** to understand your project's context, form hypotheses about runtime issues, and provide evidence-based fix recommendations. Think of it as having an experienced SRE on your team, available 24/7.
 
 ### Key Capabilities
 
@@ -83,86 +87,203 @@ OpsPilot uses a **multi-agent AI architecture** to understand your project's con
 
 ---
 
-## 🚀 Quick Start
-
-### Prerequisites
-
-- Python 3.8 or higher
-- At least ONE of the following LLM providers:
-  - [Ollama](https://ollama.ai/) (local, free, recommended)
-  - Google Gemini API key (free tier)
-  - OpenRouter API key (free models available)
-  - HuggingFace API token (free tier)
+## 🚀 Quick Start (2 Minutes Setup)
 
-### Installation
+### Step 1: Install OpsPilot-AI
 
 ```bash
-# Clone repository
-git clone https://github.com/yourusername/opspilot.git
-cd opspilot
+pip install opspilot-ai
+```
 
-# Basic installation
-pip install -e .
+### Step 2: Setup LLM (Choose ONE Option)
 
-# With Redis support (recommended for production)
-pip install -e ".[redis]"
+OpsPilot-AI needs an LLM to analyze your code. Choose **one** of these options:
 
-# With all integrations (Redis + AWS + Kubernetes)
-pip install -e ".[all]"
-```
+---
+
+#### Option A: Ollama (Recommended - Free & Private)
 
-### LLM Setup
+Ollama runs locally on your machine. Your code never leaves your computer.
 
-**Option 1: Ollama (Recommended - Local & Free)**
+**For macOS/Linux:**
 ```bash
 # Install Ollama
 curl -fsSL https://ollama.ai/install.sh | sh
 
-# Pull Llama 3 model
+# Pull the AI model (one-time download, ~4GB)
 ollama pull llama3
+
+# Verify it's running
+ollama list
 ```
 
-**Option 2: Cloud Providers (FREE tiers)**
+**For Windows:**
+1. Download Ollama from [ollama.ai/download](https://ollama.ai/download)
+2. Install and run the application
+3. Open terminal and run:
 ```bash
-# Copy environment template
-cp .env.example .env
+ollama pull llama3
+```
+
+---
+
+#### Option B: Cloud API (No Local Install Required)
+
+Use cloud-based LLMs with free tiers. Set **one** of these environment variables:
 
-# Add your API keys to .env
-# GOOGLE_API_KEY=your-key-here
-# OPENROUTER_API_KEY=your-key-here
-# HUGGINGFACE_API_KEY=your-key-here
+**Google Gemini (Recommended Cloud Option):**
+```bash
+# Get free API key: https://makersuite.google.com/app/apikey
+export GOOGLE_API_KEY="your-api-key-here"
 ```
 
-See [FREE_LLM_SETUP.md](FREE_LLM_SETUP.md) for detailed setup instructions.
+**OpenRouter (100+ Models Available):**
+```bash
+# Get free API key: https://openrouter.ai/keys
+export OPENROUTER_API_KEY="your-api-key-here"
+```
 
-### Usage
+**HuggingFace:**
+```bash
+# Get free token: https://huggingface.co/settings/tokens
+export HUGGINGFACE_API_KEY="your-api-key-here"
+```
 
-Navigate to your project directory and run:
+**Windows Users (set environment variable):**
+```cmd
+set GOOGLE_API_KEY=your-api-key-here
+```
+
+---
+
+### Step 3: Analyze Your Project
 
 ```bash
-# Basic analysis
+# Navigate to your project
+cd /path/to/your/project
+
+# Run analysis
 opspilot analyze
+```
+
+That's it! OpsPilot-AI will analyze your project and provide diagnosis.
+
+---
+
+## 📖 Usage Examples
 
+### Basic Commands
+
+```bash
+# Quick analysis (fastest)
+opspilot analyze --mode quick
+
+# Deep analysis (thorough, recommended)
+opspilot analyze --mode deep
+
+# Verbose output (see what's happening)
+opspilot analyze --verbose
+```
+
+### Advanced Commands
+
+```bash
 # Analyze with production logs from S3
 opspilot analyze --log-source s3://my-bucket/logs/app.log
 
-# Analyze with deployment correlation
+# Analyze with deployment correlation (links errors to git commits)
 opspilot analyze --deployment-analysis --since-hours 48
 
-# JSON output for automation
+# JSON output for CI/CD automation
 opspilot analyze --json --mode quick
 
-# Verbose output for debugging
+# Analyze specific log file
+opspilot analyze --log-source /var/log/myapp/error.log
+
+# Full debugging output
 opspilot analyze --verbose --debug
 ```
 
+### Analysis Modes
+
+| Mode | Speed | LLM Calls | Use Case |
+|------|-------|-----------|----------|
+| `quick` | Fast | 1 | Quick check, CI/CD pipelines |
+| `deep` | Thorough | Up to 4 | Detailed incident analysis |
+| `explain` | Instant | 0 | Context gathering only (no LLM) |
+
+### Installation Options
+
+```bash
+# Basic (just the CLI)
+pip install opspilot-ai
+
+# With Redis support (remembers past incidents)
+pip install "opspilot-ai[redis]"
+
+# With AWS support (S3, CloudWatch logs)
+pip install "opspilot-ai[aws]"
+
+# With Kubernetes support (K8s pod logs)
+pip install "opspilot-ai[k8s]"
+
+# Everything included
+pip install "opspilot-ai[all]"
+```
+
+---
+
+## 🔧 Troubleshooting
+
+### "No LLM providers available"
+
+You need to set up an LLM. Choose one:
+
+```bash
+# Option 1: Install Ollama (recommended)
+curl -fsSL https://ollama.ai/install.sh | sh
+ollama pull llama3
+
+# Option 2: Set a cloud API key
+export GOOGLE_API_KEY="your-key"
+```
+
+### "Ollama connection refused"
+
+Make sure Ollama is running:
+```bash
+# Start Ollama service
+ollama serve
+
+# In another terminal, verify it works
+ollama list
+```
+
+### "No logs found"
+
+OpsPilot-AI looks for logs in these locations:
+- `./logs/` directory
+- `*.log` files in project root
+- Files specified with `--log-source`
+
+```bash
+# Specify log file directly
+opspilot analyze --log-source ./my-app/error.log
+```
+
+### "Context collected: 0 env vars"
+
+Make sure you have a `.env` file in your project directory, or environment variables set.
+
+---
+
 **Example Output:**
 
 ```
 Similar issues detected from past runs:
 - Redis connection issue caused by network or Redis server downtime (confidence 0.8)
 
-OpsPilot initialized
+OpsPilot-AI initialized
 Project detected: /your/project
 
 Planner Agent reasoning...
@@ -200,7 +321,7 @@ Enable connection pooling and reasonable timeouts to improve reliability.
 
 ## 🏗️ Architecture
 
-OpsPilot implements a **multi-agent agentic architecture** with four specialized agents:
+OpsPilot-AI implements a **multi-agent agentic architecture** with four specialized agents:
 
 1. **Planner Agent** - Analyzes project context and forms hypotheses about root causes
 2. **Verifier Agent** - Collects evidence and validates hypotheses with confidence scoring
@@ -225,7 +346,7 @@ See [ARCHITECTURE.md](ARCHITECTURE.md) for detailed design documentation.
 ## 🧩 How It Works
 
 ### 1. Context Collection
-OpsPilot gathers information from multiple sources:
+OpsPilot-AI gathers information from multiple sources:
 - **Logs**: Recent error logs and exceptions
 - **Environment**: Environment variables and configurations
 - **Dependencies**: Project dependencies (requirements.txt, package.json)
@@ -254,7 +375,7 @@ If confidence ≥ 0.6, the Fixer agent:
 - **Never auto-applies changes** (dry-run only for safety)
 
 ### 5. Learning from History
-OpsPilot maintains Redis-based memory of past issues:
+OpsPilot-AI maintains Redis-based memory of past issues:
 - Stores hypotheses, confidence scores, and evidence with automatic TTL
 - User-isolated storage using project path hashing
 - Detects similar issues in future runs with sub-second lookups
@@ -406,3 +527,9 @@ For questions or feedback, please open an issue on GitHub.
 ---
 
 **Built with ❤️ using agentic AI principles**
+
+---
+
+## 📦 PyPI
+
+This package is available on PyPI: [opspilot-ai](https://pypi.org/project/opspilot-ai/)

{opspilot_ai-0.1.0.dist-info → opspilot_ai-0.1.2.dist-info}/RECORD

@@ -27,9 +27,9 @@ opspilot/tools/pattern_analysis.py,sha256=e6N48iMiYWwhmH_3Bbdqhr49n19jPRPrwBWv-9
 opspilot/utils/__init__.py,sha256=jDlOFqPTvm9jo4RsaLBrSmanD3QYogfnIr30hTiXY7Y,36
 opspilot/utils/llm.py,sha256=RsiBVw7iemZNxtJktUBCPpVY-E_9peImf6Gm6P81WSE,544
 opspilot/utils/llm_providers.py,sha256=q4MkGK03Mn_TcttJQaNfoMhSgVpBn-dMLm2AmHXt5Sc,15623
-opspilot_ai-0.1.0.dist-info/licenses/LICENSE,sha256=HEWOzX-yJ9Pctxca1nGhcPAg8Htk1PuJPPOPqcfHUe0,1083
-opspilot_ai-0.1.0.dist-info/METADATA,sha256=Ap8Ktb3I8Ft2bjhibpEHdzc1VJGPe6w7mWp23L_x5fU,14442
-opspilot_ai-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-opspilot_ai-0.1.0.dist-info/entry_points.txt,sha256=2nttMUdFdShzdN0EkLNgtMNbWDWdO2hHyDzdiCWZolo,46
-opspilot_ai-0.1.0.dist-info/top_level.txt,sha256=u_uSy6eFmJW-9xWnxieGZn5LN_xjXOPMhlKu8BEscdA,9
-opspilot_ai-0.1.0.dist-info/RECORD,,
+opspilot_ai-0.1.2.dist-info/licenses/LICENSE,sha256=HEWOzX-yJ9Pctxca1nGhcPAg8Htk1PuJPPOPqcfHUe0,1083
+opspilot_ai-0.1.2.dist-info/METADATA,sha256=CMzvRNJgDHWcjrtIMzIwnHrnNXDdLpbweDhm_AJC2mM,17353
+opspilot_ai-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+opspilot_ai-0.1.2.dist-info/entry_points.txt,sha256=2nttMUdFdShzdN0EkLNgtMNbWDWdO2hHyDzdiCWZolo,46
+opspilot_ai-0.1.2.dist-info/top_level.txt,sha256=u_uSy6eFmJW-9xWnxieGZn5LN_xjXOPMhlKu8BEscdA,9
+opspilot_ai-0.1.2.dist-info/RECORD,,