{"id":31111858,"url":"https://github.com/wronai/devix","last_synced_at":"2026-07-09T18:31:37.400Z","repository":{"id":314484331,"uuid":"1053962502","full_name":"wronai/devix","owner":"wronai","description":"Automated development and code repair system with enhanced analysis capabilities","archived":false,"fork":false,"pushed_at":"2026-06-18T12:28:18.000Z","size":177,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-18T13:07:46.815Z","etag":null,"topics":["automated-development","code-analysis","code-repair","continuous-integration","markdown","monitoring","python","quality-assurance","testing","wronai"],"latest_commit_sha":null,"homepage":"https://wronai.github.io/devix/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wronai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-10T07:12:04.000Z","updated_at":"2026-06-18T12:57:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"01e347a3-de27-43ed-bc9b-b9a46910cc21","html_url":"https://github.com/wronai/devix","commit_stats":null,"previous_names":["wronai/devix"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/wronai/devix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wronai%2Fdevix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wronai%2Fdevix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wronai%2Fdevix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wronai%2Fdevix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wronai","download_url":"https://codeload.github.com/wronai/devix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wronai%2Fdevix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35309827,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-09T02:00:07.329Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automated-development","code-analysis","code-repair","continuous-integration","markdown","monitoring","python","quality-assurance","testing","wronai"],"created_at":"2025-09-17T08:24:09.582Z","updated_at":"2026-07-09T18:31:37.394Z","avatar_url":"https://github.com/wronai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔍 Devix - Modular Code Analysis Platform\n\n**Devix** is a comprehensive, modular code analysis platform that provides deep insights into your codebase through multiple specialized analyzers. Built with Python, it offers powerful CLI tools, rich reporting, and intelligent project structure analysis.\n\n## ✨ Key Features\n\n- 🔍 **Multi-Analyzer Architecture**: 5 specialized analyzers (ProjectScanner, Security, Quality, Test, Performance)\n- 📊 **Rich Reporting**: Enhanced markdown and text reports with project tree visualization\n- 🚫 **Smart Filtering**: `.devixignore` support with visual indicators for ignored files\n- ⚡ **Parallel Execution**: Concurrent analyzer execution for optimal performance\n- 🎯 **CLI Subcommands**: Clean command-line interface with `analyze`, `config`, and `info` commands\n- 📈 **Comprehensive Metrics**: File statistics, coverage analysis, and cross-analyzer insights\n- 🌳 **Project Structure Visualization**: ASCII tree with file sizes and ignore markers\n- 🔧 **Modular Design**: Extensible architecture for adding custom analyzers\n\n## 🛠️ Installation\n\n### Quick Start\n\n```bash\n# Clone or navigate to the Devix directory\ncd devix\n\n# Install dependencies\npip install -e .\n\n# Run analysis on your project\ndevix analyze /path/to/your/project\n```\n\n### Installation Methods\n\n#### Method 1: Package Installation\n```bash\ncd devix\npip install -e .  # Install in development mode\ndevix analyze .    # Analyze current directory\n```\n\n#### Method 2: Direct Execution\n```bash\ncd devix\nPYTHONPATH=src python -m devix analyze /path/to/project\n```\n\n#### Method 3: Using Makefile\n```bash\ncd devix\nmake run          # Analyze parent directory\nmake test         # Run tests\nmake lint         # Run linting\n```\n\n## 🎮 Usage\n\n### CLI Commands\n\n#### Main Analysis Command\n```bash\n# Analyze current directory with verbose output\ndevix analyze . --verbose\n\n# Analyze specific project path\ndevix analyze /path/to/project\n\n# Select specific analyzers\ndevix analyze . --analyzers project_scanner,security,quality\n\n# Enable parallel execution (default)\ndevix analyze . --parallel\n\n# Set custom output directory\ndevix analyze . --output-dir ./reports\n```\n\n#### Configuration Management\n```bash\n# Create default configuration\ndevix config create\n\n# Validate existing configuration\ndevix config validate\n\n# Show configuration location\ndevix config validate --config /path/to/config.yaml\n```\n\n#### Information Commands\n```bash\n# Show version and system info\ndevix info\n\n# List available analyzers\ndevix info --analyzers\n\n# Validate system setup\ndevix info --validate\n```\n\n### Makefile Commands\n\n```bash\n# Development workflow\nmake dev          # Full development workflow\nmake run          # Analyze parent directory\nmake test         # Run tests with coverage\nmake lint         # Run code quality checks\nmake format       # Format code with black/isort\n\n# Publishing and deployment\nmake build        # Build package\nmake publish      # Publish to PyPI\nmake version      # Show version info\n\n# Docker operations\nmake docker-build # Build Docker image\nmake docker-run   # Run in Docker container\n```\n\n## ⚙️ Configuration\n\n### Configuration File (`config.yaml`)\n\n```yaml\n# Analyzer settings\nanalyzers:\n  enabled: [\"project_scanner\", \"security\", \"quality\", \"test\", \"performance\"]\n  parallel_execution: true\n  max_workers: 4\n\n# Reporting configuration\nreporting:\n  formats: [\"markdown\", \"text\"]\n  output_directory: \".\"\n  include_tree_visualization: true\n  include_file_statistics: true\n\n# File filtering\nfiltering:\n  use_gitignore: true\n  custom_ignore_patterns:\n    - \"*.log\"\n    - \"node_modules/\"\n    - \".pytest_cache/\"\n```\n\n### .devixignore File\n\nCreate a `.devixignore` file to exclude files/directories from analysis:\n\n```\n# Dependencies\nnode_modules/\n__pycache__/\n.venv/\n\n# Build artifacts\ndist/\nbuild/\n*.egg-info/\n\n# IDE and system files\n.vscode/\n.idea/\n.DS_Store\n\n# Logs and temporary files\nlogs/\n*.log\n.coverage\n```\n\n## 🔍 Analyzers\n\n### Project Scanner\n- **Purpose**: Analyzes project structure, file statistics, and generates tree visualization\n- **Features**: \n  - Full and filtered project trees\n  - File type breakdown and statistics\n  - Code fragment extraction\n  - Visual ignore markers (🚫) for excluded files\n\n### Security Analyzer\n- **Purpose**: Identifies security vulnerabilities and risks\n- **Tools**: Bandit, Safety (when available)\n- **Features**:\n  - Static security analysis\n  - Dependency vulnerability scanning\n  - Hardcoded credentials detection\n\n### Quality Analyzer\n- **Purpose**: Evaluates code quality and style\n- **Tools**: Pylint, Flake8, Black, isort, mypy (when available)\n- **Features**:\n  - Code complexity analysis\n  - Style guide compliance\n  - Type checking validation\n\n### Test Analyzer\n- **Purpose**: Analyzes test coverage and quality\n- **Tools**: pytest, coverage.py (when available)\n- **Features**:\n  - Test discovery and execution\n  - Coverage measurement\n  - Test quality assessment\n\n### Performance Analyzer\n- **Purpose**: Identifies performance bottlenecks\n- **Features**:\n  - Runtime profiling\n  - Resource usage analysis\n  - Performance pattern detection\n\n## 📊 Report Features\n\n### Enhanced Reporting\n- **Multiple Formats**: Markdown and text reports with rich formatting\n- **Project Statistics**: Real file counts (analyzed vs skipped)\n- **Tree Visualization**: ASCII project structure with file sizes\n- **Visual Indicators**: 🚫 markers for ignored files and directories\n- **Cross-Analyzer Insights**: Correlations between different analysis results\n\n### Report Contents\n- **Executive Summary**: Health scores and quick metrics\n- **Detailed Analysis**: Per-analyzer results with issues and recommendations\n- **File Statistics**: Comprehensive breakdown by file type and location\n- **Project Structure**: Complete tree view with ignore patterns applied\n- **Actionable Recommendations**: Priority-sorted improvement suggestions\n\n## 🚨 Troubleshooting\n\n### Common Issues\n\n**No files found for analysis**\n- Check your `.devixignore` patterns\n- Ensure project path is correct\n- Verify file permissions\n\n**Missing analyzer tools**\n- Install optional dependencies: `pip install bandit safety pylint`\n- Check tool availability: `devix info --validate`\n\n**Slow performance**\n- Use parallel execution: `--parallel` (default)\n- Reduce analyzer scope: `--analyzers project_scanner,quality`\n- Filter large directories in `.devixignore`\n\n**Import errors**\n- Ensure proper installation: `pip install -e .`\n- Check PYTHONPATH: `export PYTHONPATH=src:$PYTHONPATH`\n- Verify Python version compatibility (3.8+)\n\n## 📝 Example Workflows\n\n### Basic Analysis\n```bash\n# Quick analysis of current directory\ndevix analyze . --verbose\n\n# Check reports\nls devix_report_*.md devix_report_*.txt\n```\n\n### CI/CD Integration\n```bash\n# In your CI pipeline\ndevix analyze . --output-dir ./reports\n\n# Check exit code for quality gates\nif [ $? -eq 0 ]; then\n  echo \"Analysis passed!\"\nelse\n  echo \"Analysis found issues\"\n  exit 1\nfi\n```\n\n### Custom Configuration\n```bash\n# Create and customize config\ndevix config create\n# Edit config.yaml as needed\n\n# Run with custom config\ndevix analyze . --config ./my-config.yaml\n```\n\n## 🏗️ Architecture\n\n### High-Level Architecture\n\nThis diagram illustrates the main components of the Devix platform and their interactions:\n\n```mermaid\ngraph TD\n    subgraph User Interface\n        CLI[CLI]\n    end\n\n    subgraph Core System\n        Orchestrator(DevixOrchestrator)\n        ConfigManager[ConfigManager]\n    end\n\n    subgraph Analyzers\n        ProjectScanner[ProjectScanner]\n        SecurityAnalyzer[SecurityAnalyzer]\n        QualityAnalyzer[QualityAnalyzer]\n        TestAnalyzer[TestAnalyzer]\n        PerformanceAnalyzer[PerformanceAnalyzer]\n    end\n\n    subgraph Reporting\n        ReportGenerator[EnhancedReportGenerator]\n        MarkdownFormatter[MarkdownFormatter]\n        TextFormatter[TextFormatter]\n    end\n\n    CLI --\u003e Orchestrator\n    Orchestrator --\u003e ConfigManager\n    Orchestrator --\u003e ProjectScanner\n    Orchestrator --\u003e SecurityAnalyzer\n    Orchestrator --\u003e QualityAnalyzer\n    Orchestrator --\u003e TestAnalyzer\n    Orchestrator --\u003e PerformanceAnalyzer\n    Orchestrator --\u003e ReportGenerator\n    ReportGenerator --\u003e MarkdownFormatter\n    ReportGenerator --\u003e TextFormatter\n```\n\n### Workflow Sequence Diagram\n\nThis diagram shows the sequence of operations during a typical analysis run:\n\n```mermaid\nsequenceDiagram\n    participant User\n    participant CLI\n    participant DevixOrchestrator\n    participant Analyzers\n    participant ReportGenerator\n\n    User-\u003e\u003eCLI: devix analyze .\n    CLI-\u003e\u003eDevixOrchestrator: run_analysis()\n    DevixOrchestrator-\u003e\u003eAnalyzers: analyze() in parallel\n    Analyzers--\u003e\u003eDevixOrchestrator: Analysis results\n    DevixOrchestrator-\u003e\u003eReportGenerator: generate_reports()\n    ReportGenerator--\u003e\u003eDevixOrchestrator: Report files\n    DevixOrchestrator--\u003e\u003eCLI: Display summary\n    CLI--\u003e\u003eUser: Output summary and report paths\n```\n\n### Module Structure\n\n```\ndevix/\n├── src/devix/\n│   ├── analysis/          # Analysis modules\n│   │   ├── project_scanner.py\n│   │   ├── security_analyzer.py\n│   │   ├── quality_analyzer.py\n│   │   ├── test_analyzer.py\n│   │   └── performance_analyzer.py\n│   ├── reporting/         # Report generation\n│   │   ├── enhanced_generator.py\n│   │   ├── markdown_formatter.py\n│   │   └── text_formatter.py\n│   ├── cli/              # Command-line interface\n│   ├── config/           # Configuration management\n│   └── core/             # Core orchestration\n├── tests/                # Test suite\n└── docs/                 # Documentation\n```\n\n### Extension Points\n- **Custom Analyzers**: Inherit from `BaseAnalyzer`\n- **Custom Formatters**: Inherit from `BaseFormatter`\n- **Custom Configuration**: Extend `ConfigManager`\n\n## 🤝 Contributing\n\n### Development Setup\n```bash\n# Clone and setup\ngit clone \u003crepository\u003e\ncd devix\npip install -e \".[dev]\"\n\n# Run tests\nmake test\n\n# Run linting\nmake lint\n\n# Format code\nmake format\n```\n\n### Adding New Analyzers\n1. Create new analyzer in `src/devix/analysis/`\n2. Inherit from `BaseAnalyzer`\n3. Implement `analyze()` method\n4. Register in `DevixOrchestrator`\n5. Add tests and documentation\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n---\n\n*Generated by **Devix** - Modular Code Analysis Platform*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwronai%2Fdevix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwronai%2Fdevix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwronai%2Fdevix/lists"}