FixMySlop

KO | EN

gitlite — search

#python #ai #html #llm #css #frontend #web-development #open-source #pytorch #vite #react #awesome

★ 22 Open GitHub ↗

FixMySlop — The free, 100% local AI-powered code janitor that finds and fixes bugs, security holes, and AI slop in your projects. No cloud, no API keys, no BS.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FixMySlop - by Nihal & Claude

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/MrSpideyNihal/FixMySlop/main/LICENSE)
[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-green.svg)](https://python.org)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)]()
[![GitHub Stars](https://img.shields.io/github/stars/MrSpideyNihal/FixMySlop?style=social)](https://github.com/MrSpideyNihal/FixMySlop/stargazers)

> **FixMySlop — The free, 100% local AI-powered code janitor that finds and fixes bugs, security holes, and AI slop in your projects. No cloud, no API keys, no BS.**

- Cleans messy AI-generated code (hallucinations, bad patterns, weak security)
- Gives a clear Slop Score, detailed audit report, and one-click fix generation
- Works offline with Ollama, llama.cpp, or vLLM so your code stays private

---

## Visual Tour

![Scan panel (Search.png)](https://raw.githubusercontent.com/MrSpideyNihal/FixMySlop/main/screenshots/Search.png)
![Report panel (report1.png)](https://raw.githubusercontent.com/MrSpideyNihal/FixMySlop/main/screenshots/report1.png)
![Fix panel with diff (fix.png)](https://raw.githubusercontent.com/MrSpideyNihal/FixMySlop/main/screenshots/fix.png)
![CLI output (cli.png)](https://raw.githubusercontent.com/MrSpideyNihal/FixMySlop/main/screenshots/cli.png)

### Screenshot Guide

| Screenshot File | What It Shows |
|-----------------|---------------|
| `screenshots/Search.png` | Scan setup flow (project selection + scan controls) |
| `screenshots/report1.png` | Report view with issue list and quality insights |
| `screenshots/fix.png` | Fix workflow and diff-style patch review |
| `screenshots/cli.png` | CLI scan output for terminal-first users |

---

## Features

- ⚡ Turbo + Deep scan modes for speed vs depth
- 🔍 Full repository scanning with `.gitignore` awareness
- 🛡️ Security checks (Bandit + LLM context analysis)
- 🧹 AI smell detection (hallucinated imports, weak validation, broad exception handling)
- 📊 Slop Score (0-100) to summarize code health
- 🔧 LLM-powered fix generation with unified diffs
- 📄 Report export in Markdown, HTML, JSON, CSV, and PDF
- 🎨 Polished PyQt5 desktop GUI with dark/light themes
- 💻 Full CLI for automation and CI-friendly usage
- 🤖 Auto model fallback when configured model is missing
- 🪟 Windows-safe terminal output handling
- 🏠 100% local-first architecture

---

## Why FixMySlop?

FixMySlop combines static analysis + LLM reasoning + local privacy in one workflow.

| Compared To | Typical Limitation | FixMySlop Advantage |
|-------------|--------------------|---------------------|
| Ruff/Pylint-only workflows | Strong syntax/style checks, limited semantic AI context | Adds LLM-based deep reasoning on top of static tools |
| Cloud AI code reviewers | Code leaves your machine, subscription cost | 100% local and private |
| IDE-only assistants | Great inline help, weaker full-repo audit/report flow | Full-repo scans, report panel, Slop Score, fix workflow |

---

## Installation

### Install from PyPI

```bash
# Base install (CLI + core engine)
pip install fixmyslop

# Install with GUI support
pip install fixmyslop[gui]

# Install with static analysis tools
pip install fixmyslop[analysis]

# Install everything
pip install fixmyslop[gui,analysis]
```

After install, run:

```bash
fixmyslop scan ./your-project --mode turbo
```

### Prerequisites

- Python 3.10+
- A local OpenAI-compatible backend (Ollama recommended): https://ollama.ai

### Quick Start

```bash
# Clone
git clone https://github.com/MrSpideyNihal/FixMySlop.git
cd FixMySlop

# Install dependencies
pip install -r requirements.txt

# Pull a local model (example)
ollama pull qwen2.5-coder:3b

# Launch GUI
python main.py

# Or run CLI
python main.py scan ./your-project --mode turbo
```

FixMySlop can auto-detect an available model, so manual model config is optional.

### Optional Static Tools

```bash
pip install ruff bandit
pip install semgrep
```

### Troubleshooting

- Backend not reachable: run `ollama serve` first
- Model not found: run `ollama pull qwen2.5-coder:7b` (or another installed coder model)
- Windows terminal shows garbled Unicode: switch to UTF-8 code page (`chcp 65001`) or use Windows Terminal/CMD

---

## Usage

### GUI

```bash
python main.py
# or (after pip install)
fixmyslop gui
```

Main sections:
- Home
- Scan
- Report
- Fix
- Settings

### CLI Recipes

```bash
# Quick scan
python main.py scan ./myproject

# Turbo mode (fast top issues)
python main.py scan ./myproject --mode turbo

# Deep mode (full pass)
python main.py scan ./myproject --mode deep

# Deep static-only
python main.py scan ./backend --mode deep --no-llm --output json

# Save report
python main.py scan ./myproject --save slop-report.md --output markdown

# Use explicit model
python main.py scan ./myproject --model qwen2.5-coder:3b --mode turbo

# List backend models
python main.py models
```

### Scan Modes

| Mode | Focus | Typical per-file estimate |
|------|-------|---------------------------|
| `turbo` | Prioritize high-impact findings quickly | `~20-40s per file` |
| `deep` | Broader and more exhaustive finding coverage | `~15-30s per file` |
| `--no-llm` | Static analysis only | `< 1s per file` |

---

## CLI Reference

### `fixmyslop scan [PATH]`

Scan a codebase for AI debt, bugs, and security issues.

**Arguments**

| Argument | Description |
|----------|-------------|
| `PATH` | Repo or folder to scan (default: current directory) |

**Options**

| Option | Short | Type | Description | Default |
|--------|-------|------|-------------|---------|
| `--mode` | | `TEXT` | Scan mode: `turbo` (fast, top issues) or `deep` (thorough) | `turbo` |
| `--model` | `-m` | `TEXT` | Model tag to use for LLM analysis | auto-detected |
| `--base-url` | `-b` | `TEXT` | Backend API URL | `http://localhost:11434/v1` |
| `--api-key` | | `TEXT` | API key — use `ollama` for Ollama | `ollama` |
| `--output` | `-o` | `TEXT` | Report format: `markdown` `html` `json` `csv` `pdf` | `markdown` |
| `--save` | `-s` | `TEXT` | Save report to a file path | — |
| `--fix` | | flag | Auto-apply suggested fixes | off |
| `--no-llm` | | flag | Static analysis only, skip LLM | off |
| `--retries` | | `INTEGER` | Max LLM retries per file on parse failure | `2` |
| `--help` | | | Show help and exit | |

**Examples**

```bash
# Scan current directory (turbo mode, default)
fixmyslop scan .

# Deep scan and save an HTML report
fixmyslop scan ./src --mode deep --output html --save report.html

# Static analysis only — no model required, very fast
fixmyslop scan ./src --no-llm --output json

# Scan with a specific model and auto-apply fixes
fixmyslop scan . -m qwen2.5-coder:3b --fix

# Turbo scan and save a Markdown report
fixmyslop scan ./myproject --save slop-report.md --output markdown
```

---

### `fixmyslop models`

List available models on your running local backend.

**Options**

| Option | Short | Type | Description | Default |
|--------|-------|------|-------------|---------|
| `--base-url` | `-b` | `TEXT` | Backend API URL | `http://localhost:11434/v1` |
| `--help` | | | Show help and exit | |

**Example**

```bash
fixmyslop models
fixmyslop models -b http://localhost:11434/v1
```

---

### `fixmyslop version`

Show the installed FixMySlop version.

```bash
fixmyslop version
```

---

## Configuration

Config file path: `~/.fixmyslop/config.yaml`

```yaml
model: ""
base_url: http://localhost:11434/v1
api_key: ollama
temperature: 0.2
theme: dark
font_size: 14
use_ruff: true
use_bandit: true
use_semgrep: false
auto_backup: true
```

If `model` is empty, FixMySlop auto-selects the best available model from your running local backend.

---

## Supported Languages

Python, JavaScript, TypeScript, Go, Rust, Java, C++, C, C#, Ruby, PHP, Swift, Kotlin

---

## Architecture

```text
FixMySlop/
├── macros.py
├── main.py
├── core/
│   ├── scanner.py
│   ├── analyzer.py
│   ├── llm_client.py
│   ├── fix_engine.py
│   └── ...
├── ui/
│   ├── panels/
│   ├── widgets/
│   └── assets/
├── cli/
├── utils/
└── tests/
```

Design rules:
- `core/` never imports `ui/`
- Constants are centralized in `macros.py`
- Heavy work runs in `QThread`
- Path handling uses `pathlib.Path`

---

## Running Tests

```bash
pytest tests/ -v
```

---

## Contributing

Contributions are welcome.

1. Open an issue for bugs or feature ideas
2. Fork and create a branch
3. Add tests for behavior changes
4. Run `pytest tests/ -q`
5. Open a PR with a clear summary

---

## Roadmap

- More language-specific rules and higher-quality fix templates
- Better safe auto-apply for low-risk fixes
- Pre-commit and CI integration helpers
- Optional richer report visualizations

---

## Acknowledgments

- Ollama
- llama.cpp
- vLLM
- Ruff
- Bandit
- Semgrep
- PyQt5
- fpdf2

---

## License

MIT — free forever and open source.

---

Loved this project? Please star the repo.

FixMySlop

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README