opspilot-ai 0.1.0__py3-none-any.whl

opspilot_ai-0.1.0.dist-info/METADATA

@@ -0,0 +1,408 @@
+Metadata-Version: 2.4
+Name: opspilot-ai
+Version: 0.1.0
+Summary: AI-powered production incident analysis tool using multi-agent systems
+Home-page: https://github.com/choudharikiranv15/opspilot
+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
+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
+Classifier: Intended Audience :: System Administrators
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Environment :: Console
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Provides-Extra: redis
+Requires-Dist: redis>=4.5.0; extra == "redis"
+Provides-Extra: aws
+Requires-Dist: boto3>=1.26.0; extra == "aws"
+Provides-Extra: k8s
+Requires-Dist: kubernetes>=25.0.0; extra == "k8s"
+Provides-Extra: all
+Requires-Dist: redis>=4.5.0; extra == "all"
+Requires-Dist: boto3>=1.26.0; extra == "all"
+Requires-Dist: kubernetes>=25.0.0; extra == "all"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# OpsPilot 🤖
+
+> 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.
+
+---
+
+## 🎯 What is OpsPilot?
+
+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.
+
+### Key Capabilities
+
+- **🔍 Intelligent Context Gathering** - Automatically analyzes logs, environment variables, Docker configs, dependencies, and project structure
+- **🧠 Multi-Agent Architecture** - 4 specialized agents (Planner, Verifier, Fixer, Remediation) working collaboratively
+- **🌐 Multi-Provider LLM Support** - Automatic fallback across Ollama, OpenRouter, Gemini, and HuggingFace
+- **✅ Evidence-Based Verification** - Validates hypotheses with collected evidence and confidence scoring
+- **🛠️ Safe Fix Suggestions** - Provides dry-run suggestions with detailed rationale (never auto-applies changes)
+- **💾 Redis-Based Memory** - Auto-expiring incident history with user isolation and sub-second lookups
+- **🚨 Severity Classification** - Automatic P0/P1/P2/P3 incident prioritization
+- **☁️ Production Log Fetching** - S3, Kubernetes, CloudWatch, and HTTP endpoint support
+- **📊 Deployment Correlation** - Links incidents to recent Git deployments for faster root cause analysis
+
+---
+
+## 🚀 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)
+
+### Installation
+
+```bash
+# Clone repository
+git clone https://github.com/yourusername/opspilot.git
+cd opspilot
+
+# Basic installation
+pip install -e .
+
+# With Redis support (recommended for production)
+pip install -e ".[redis]"
+
+# With all integrations (Redis + AWS + Kubernetes)
+pip install -e ".[all]"
+```
+
+### LLM Setup
+
+**Option 1: Ollama (Recommended - Local & Free)**
+```bash
+# Install Ollama
+curl -fsSL https://ollama.ai/install.sh | sh
+
+# Pull Llama 3 model
+ollama pull llama3
+```
+
+**Option 2: Cloud Providers (FREE tiers)**
+```bash
+# Copy environment template
+cp .env.example .env
+
+# Add your API keys to .env
+# GOOGLE_API_KEY=your-key-here
+# OPENROUTER_API_KEY=your-key-here
+# HUGGINGFACE_API_KEY=your-key-here
+```
+
+See [FREE_LLM_SETUP.md](FREE_LLM_SETUP.md) for detailed setup instructions.
+
+### Usage
+
+Navigate to your project directory and run:
+
+```bash
+# Basic analysis
+opspilot analyze
+
+# Analyze with production logs from S3
+opspilot analyze --log-source s3://my-bucket/logs/app.log
+
+# Analyze with deployment correlation
+opspilot analyze --deployment-analysis --since-hours 48
+
+# JSON output for automation
+opspilot analyze --json --mode quick
+
+# Verbose output for debugging
+opspilot analyze --verbose --debug
+```
+
+**Example Output:**
+
+```
+Similar issues detected from past runs:
+- Redis connection issue caused by network or Redis server downtime (confidence 0.8)
+
+OpsPilot initialized
+Project detected: /your/project
+
+Planner Agent reasoning...
+Hypothesis: Redis connection issue
+Confidence: 0.9
+
+Evidence collected:
+{'log_errors': {'ERROR': 1, 'Timeout': 1}, 'uses_redis': True}
+
+Verifying hypothesis...
+Supported: True
+Confidence: 0.8
+Reason: The presence of Redis connection-related errors (Timeout) and the system's use of Redis support the hypothesis.
+
+Generating safe fix suggestions (dry-run)...
+
+File: .env
+Increase Redis timeout to reduce transient timeout errors under load.
+--- a/.env
++++ b/.env
+@@
+-REDIS_TIMEOUT=1
++REDIS_TIMEOUT=5
+
+File: app/config/redis.py
+Enable connection pooling and reasonable timeouts to improve reliability.
+--- a/app/config/redis.py
++++ b/app/config/redis.py
+@@
+-redis.Redis(host=host, port=port)
++redis.Redis(host=host, port=port, socket_timeout=5, max_connections=20)
+```
+
+---
+
+## 🏗️ Architecture
+
+OpsPilot 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
+3. **Fixer Agent** - Generates safe, actionable fix suggestions
+4. **Remediation Agent** - Creates 3-tier action plans (immediate, short-term, long-term)
+
+**Multi-Provider LLM System:**
+- Automatic fallback routing across 4 providers
+- Connection pooling for high availability
+- Provider health metrics and monitoring
+
+**Redis-Based Memory:**
+- User-isolated incident storage with SHA-256 project hashing
+- Automatic TTL expiration (configurable, default 30 days)
+- Sub-second similarity search with sorted sets
+- Severity-based indexing (P0/P1/P2/P3)
+
+See [ARCHITECTURE.md](ARCHITECTURE.md) for detailed design documentation.
+
+---
+
+## 🧩 How It Works
+
+### 1. Context Collection
+OpsPilot gathers information from multiple sources:
+- **Logs**: Recent error logs and exceptions
+- **Environment**: Environment variables and configurations
+- **Dependencies**: Project dependencies (requirements.txt, package.json)
+- **Docker**: Dockerfile and docker-compose configurations
+- **Structure**: Project file tree and organization
+
+### 2. Hypothesis Generation
+The Planner agent uses LLM reasoning to:
+- Analyze collected context
+- Identify patterns and anomalies
+- Form hypotheses about root causes
+- Assign confidence scores (0.0 - 1.0)
+
+### 3. Evidence-Based Verification
+The Verifier agent:
+- Collects concrete evidence (log errors, missing configs, etc.)
+- Cross-references with the hypothesis
+- Updates confidence based on evidence strength
+- Provides reasoning for the verdict
+
+### 4. Safe Fix Suggestions
+If confidence ≥ 0.6, the Fixer agent:
+- Generates actionable fix suggestions as diffs
+- Explains the rationale for each fix
+- Provides domain-specific solutions (e.g., Redis timeout fixes)
+- **Never auto-applies changes** (dry-run only for safety)
+
+### 5. Learning from History
+OpsPilot 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
+- Automatic expiration prevents stale incident data
+- Falls back to file-based storage if Redis unavailable
+
+---
+
+## 🎓 Technology Stack
+
+- **LLM Integration**: Multi-provider system (Ollama, OpenRouter, Gemini, HuggingFace) with automatic fallback
+- **Memory Layer**: Redis (with file-based fallback) for incident history and similarity detection
+- **CLI Framework**: Typer + Rich (professional terminal output)
+- **Cloud Integration**: AWS (S3, CloudWatch), Kubernetes, HTTP endpoints
+- **AI Pattern**: Multi-agent agentic architecture with 4 specialized agents
+- **Reasoning**: Evidence-based decision making with P0/P1/P2/P3 severity classification
+- **Prompt Engineering**: Robust JSON extraction with retry logic and safe parsing
+- **Testing**: pytest with 45+ unit tests and integration test coverage
+
+---
+
+## 📋 Project Structure
+
+```
+opspilot/
+├── agents/                    # Four specialized AI agents
+│   ├── planner.py            # Hypothesis generation
+│   ├── verifier.py           # Evidence-based verification
+│   ├── fixer.py              # Safe fix suggestions
+│   └── remediation.py        # 3-tier remediation plans
+├── context/                   # Context gathering modules
+│   ├── logs.py               # Log analysis
+│   ├── env.py                # Environment variables
+│   ├── deps.py               # Dependency detection
+│   ├── docker.py             # Docker configuration
+│   ├── project.py            # Project structure
+│   ├── production_logs.py    # Multi-source log fetching (S3, K8s, CloudWatch)
+│   ├── deployment_history.py # Git-based deployment correlation
+│   └── pattern_analysis.py   # Error pattern detection & severity classification
+├── utils/                     # Shared utilities
+│   ├── llm_providers.py      # Multi-provider LLM router with fallback
+│   └── llm.py                # Backward-compatible LLM wrapper
+├── tools/                     # Evidence collection utilities
+│   ├── log_tools.py          # Log error analysis
+│   ├── env_tools.py          # Environment validation
+│   └── dep_tools.py          # Dependency checking
+├── diffs/                     # Domain-specific fix templates
+├── memory.py                  # File-based memory (fallback)
+├── memory_redis.py            # Redis-based memory with user isolation
+├── tests/                     # Comprehensive test suite (45+ tests)
+│   ├── test_pattern_analysis.py
+│   ├── test_production_logs.py
+│   ├── test_remediation.py
+│   └── test_llm_providers.py
+└── cli.py                     # Command-line interface
+```
+
+---
+
+## 🔒 Safety & Design Principles
+
+- **Dry-Run Only**: Never automatically applies changes to your code
+- **Evidence-Based**: All suggestions backed by concrete evidence
+- **Confidence Scoring**: Transparent about certainty levels (0.0 - 1.0)
+- **Privacy-Focused**: Prefers local LLM (Ollama) with automatic fallback to cloud
+- **User Isolation**: Redis memory uses SHA-256 project hashing for complete data separation
+- **Auto-Expiring Data**: Incidents automatically expire after configurable TTL (default 30 days)
+- **High Availability**: Multi-provider LLM system with automatic failover
+- **Modular Design**: Easy to extend with new agents, providers, or context sources
+- **Production-Ready**: Comprehensive test coverage, error handling, and graceful degradation
+
+---
+
+## 🛠️ Development
+
+### Running from Source
+
+```bash
+# Install in development mode
+pip install -e .
+
+# Run the CLI
+opspilot analyze
+```
+
+### Requirements
+
+- Python 3.8+
+- At least one LLM provider (see Quick Start)
+- Optional: Redis for production incident memory
+
+### Running Tests
+
+```bash
+# Install test dependencies
+pip install -e ".[dev]"
+
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=opspilot tests/
+
+# Run specific test file
+pytest tests/test_llm_providers.py
+```
+
+---
+
+## 🗺️ Roadmap
+
+- [x] Multi-provider LLM support with automatic fallback
+- [x] Comprehensive test coverage (45+ tests)
+- [x] Redis-based memory with user isolation
+- [x] Production log fetching (S3, K8s, CloudWatch)
+- [x] Deployment correlation analysis
+- [x] Severity classification (P0/P1/P2/P3)
+- [ ] Plugin system for custom agents
+- [ ] Web API for remote usage
+- [ ] More domain-specific fix templates (PostgreSQL, MongoDB, etc.)
+- [ ] Real-time metrics dashboard
+- [ ] Slack/PagerDuty integration for incident alerts
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! This project is under active development. Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Submit a pull request
+
+For major changes, please open an issue first to discuss your ideas.
+
+---
+
+## 📧 Contact
+
+For questions or feedback, please open an issue on GitHub.
+
+---
+
+**Built with ❤️ using agentic AI principles**

opspilot_ai-0.1.0.dist-info/RECORD

@@ -0,0 +1,35 @@
+opspilot/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+opspilot/cli.py,sha256=daojuqoPFYJO1y7GuSMweCoJFRqy_6X7DdQqq-KQijI,15053
+opspilot/config.py,sha256=in9q7xd7RKBbJeMJ5AOQ1S9Op5_d3TaP_MRtlQWWo20,530
+opspilot/memory.py,sha256=PS5_oqt1VNSkJgAoeDOboZKO0hRuhiLEi_OLRHl-z68,628
+opspilot/memory_redis.py,sha256=MtKu1EzjUOVvAOBE2V2e_wLk0K4R5gwPFy-mI1l4CyQ,9578
+opspilot/state.py,sha256=mUJ10xeIB55ujHROsu63MwWLF2qc8azjdWzvtB5AEZI,490
+opspilot/agents/fixer.py,sha256=1VYDDG7YKnuzEHYb2SmGgC5AVSfZf4pxy-FnaOzhmfU,986
+opspilot/agents/planner.py,sha256=Wt_0tAeYKNH8dEb-lQEYk3m4dxYxu5do8x5CZT7nlA0,2049
+opspilot/agents/remediation.py,sha256=daTlhaYZpXFyD_F1iuXvnN4ij0e405uvJ8FbFEqRmo8,7706
+opspilot/agents/verifier.py,sha256=R4H_rm8CG3qGJhK6kPzKUjom869_bfaWDcyy9lP1AQk,1664
+opspilot/context/__init__.py,sha256=h2zikX8F8Z_hkPqyE_WPpr_NI43r2h4bgfvEVpLMMMc,806
+opspilot/context/deployment_history.py,sha256=Ni8XTrq4PzRacmLVVnAnlD47SatcvMDh45Ei_R5VRKc,10642
+opspilot/context/deps.py,sha256=pXKsqbZ5yHFDZWRJh0lJV1YCez0B-vqGoCTtIBIrv6E,339
+opspilot/context/docker.py,sha256=A1AymC5-CckQbgs8s7kRZcrGqydjWYmQI9hfxVWqlyI,443
+opspilot/context/env.py,sha256=DAO7YWwbCu9mIAZtgG7ChJV2lJBQz5PTm9j0PGvYiws,455
+opspilot/context/logs.py,sha256=zk4hdiOcheWGfl8z9ylZvPUECa5vV-eTecNzPDC3Jvw,442
+opspilot/context/production_logs.py,sha256=9E-fCiH66Oc0Vn1bTHFzDK4XTYV7Z0HtCycmIC6G6-M,7294
+opspilot/context/project.py,sha256=t8j5Nqe7h-F5foZvp2KJfR5BEnWM5R6QqcI-GMEen_0,522
+opspilot/diffs/redis.py,sha256=Yeia00eXv6kuBHbIMpt8efZ2jRm6N2luCg5SHVAY9o0,637
+opspilot/graph/engine.py,sha256=R9Dt6Xn6jevSzFfm98q5C-lrTninY0mOqwWLtI0QQWw,762
+opspilot/graph/nodes.py,sha256=Ejb3MzhqySOU8j939A-9ZAbFAvgV9zofj3AkVZlc8so,1248
+opspilot/tools/__init__.py,sha256=9GHbKc-l-DNzWJAEkIgn_erPXSNh880hhDOXC0AfSus,1651
+opspilot/tools/dep_tools.py,sha256=UAVWoQeOPBjB5OiCgiTFk2c_69_NJ7vo33NAbxXVJpA,149
+opspilot/tools/env_tools.py,sha256=GLeJgrTrbZcjPurRWXQ5BWZiO4aUJdlkT1iYaAs1nD4,173
+opspilot/tools/log_tools.py,sha256=n-JtGvZrtBbk6HUisVAHl2LPfHG90xF0ogtglVepmMA,283
+opspilot/tools/pattern_analysis.py,sha256=e6N48iMiYWwhmH_3Bbdqhr49n19jPRPrwBWv-9THXcE,5243
+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.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

opspilot_ai-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+opspilot = opspilot.cli:app

opspilot_ai-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kiran Vijaykumar Choudhari
+
+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.

opspilot_ai-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+opspilot