Releases: CodeRustyPro/openfix
OpenFix v0.1.0 - AI-Powered Issue Solver
OpenFix v0.1.0 - Release Notes
Release Date: November 27, 2025
Status: Initial Public Release
🎯 Vision
OpenFix transforms GitHub issue resolution from manual labor to intelligent automation. By combining AI-powered code generation with robust validation and human oversight, we're building the future of collaborative software maintenance.
Goal: Enable maintainers to spend less time on routine bugs and more time on innovation.
🏆 Technical Achievements
Core Pipeline
✅ End-to-End Automation - From issue discovery to PR creation
✅ AI-Powered Patch Generation - Using Google Gemini 2.0 Flash
✅ Iterative Repair Loop - Self-improving patches via validation feedback
✅ Confidence Scoring - 0-100 risk assessment with weighted factors
✅ Draft PR Creation - Automatic GitHub integration with AI disclosure
Developer Experience
✅ Interactive CLI - Beautiful Rich UI with patch preview and approval
✅ GitHub Actions Integration - Full CI/CD automation
✅ Comprehensive Logging - Production-grade error handling
✅ Unit Test Coverage - 16 tests across core components
✅ Sandbox Testing - Safe environment for validation
Code Quality
✅ Type Hints - Full type annotations for IDE support
✅ Error Handling - Robust with specific exception types
✅ Code Formatting - Black & isort applied
✅ Documentation - Professional README and contributing guidelines
🏗️ Architecture
┌─────────────────────────────────────────────────────┐
│ OpenFix Pipeline │
├─────────────────────────────────────────────────────┤
│ │
│ 1. Discovery → Scan repo for open issues │
│ 2. Triage → Filter & rank by AI suitability │
│ 3. Generate → Create patch via Gemini AI │
│ 4. Validate → Run tests & static analysis │
│ 5. Repair → Refine based on feedback (iterative) │
│ 6. Score → Calculate confidence (0-100) │
│ 7. PR → Create draft with AI disclosure │
│ │
└─────────────────────────────────────────────────────┘
Key Components:
- Solver Agent - Orchestrates the entire pipeline
- Chunk Selector - Semantic code retrieval (FAISS/fallback)
- LLM Client - Gemini API with rate limiting & retry logic
- Confidence Scorer - Multi-factor risk assessment
- PR Creator - GitHub integration with safety features
- Validation Harness - Automated test execution
🎨 CLI Capabilities
Commands
Discover Issues:
python scripts/cli.py discover https://github.com/owner/repo --limit 10Solve with Interactive Approval:
python scripts/cli.py solve https://github.com/owner/repo --issue 42
# Shows: confidence score, risk rating, diff preview
# Asks: approve patch? create PR?Auto-Approve (CI Mode):
python scripts/cli.py solve https://github.com/owner/repo --issue 42 --no-confirmCheck Status:
python scripts/cli.py statusFull Automation
python scripts/automate_full_pipeline.py \
--repo-url https://github.com/owner/repo \
--create-pr🤖 GitHub Action Automation
Add .github/workflows/openfix.yml to any repository:
Features:
- Trigger on issue labels (
openfix) - Manual dispatch with inputs
- Scheduled discovery (nightly)
- Automatic artifact upload
- PR confidence comments
Example workflow:
- User labels issue with
openfix - Action runs automatically
- Patch generated & validated
- Draft PR created if confidence > threshold
- Maintainer reviews & merges
🧪 Sandbox Testing Support
Create test repository:
python scripts/setup_sandbox.pyGenerates:
calculator.py- Division by zero buguser_manager.py- Null check bugtest_calculator.py- Unit testsREADME.md- Documentation
Perfect for:
- Testing OpenFix locally
- Demonstrating capabilities
- Validating new features
⚠️ Known Limitations
- Language Support - Currently optimized for Python projects
- Validation - Requires runnable test suite in target repo
- Complexity - High-complexity issues may require multiple repair iterations
- API Limits - Subject to Gemini API rate limits (handled gracefully)
- Token Costs - Large codebases consume more API tokens
🗺️ Roadmap for v0.2.0
Planned Features
Multi-Language Support:
- JavaScript/TypeScript
- Go
- Rust
Enhanced Validation:
- Static analysis integration (pylint, mypy)
- Security vulnerability scanning
- Performance regression detection
Learning System:
- Outcome tracking database
- Few-shot learning from past successes
- Customizable prompt templates
UI Dashboard:
- Web interface for monitoring
- Real-time pipeline visualization
- Historical metrics
Integrations:
- Slack notifications
- Discord webhooks
- Email alerts
📊 Statistics
- Lines of Code: ~3,000
- Test Coverage: 16 unit tests
- Dependencies: 8 core packages
- Development Time: Phase 1-2 complete
- License: MIT
🙏 Acknowledgments
Built with:
🚀 Get Started
# Install
git clone https://github.com/yourusername/openfix.git
cd openfix
pip install -r requirements.txt
# Configure
export GEMINI_API_KEY="your-key"
export GITHUB_TOKEN="your-token"
# Run
python scripts/cli.py discover https://github.com/owner/repoFull Documentation: README.md
Made with ❤️ by the OpenFix Team