About drep
AI-powered code review and documentation quality tool built for privacy, performance, and the open source community.
What is drep?
drep (Documentation & Review Enhancement Platform) is an AI-powered tool that analyzes your code for quality issues, generates intelligent docstring suggestions, and provides automated pull request reviews—all powered by local LLMs you control.
Unlike cloud-based alternatives, drep runs entirely on your infrastructure. Your code never leaves your servers, ensuring complete privacy and security. It integrates seamlessly with Gitea, GitHub, and GitLab (planned).
Key Differentiators
Privacy-First
Use local LLMs (Ollama, LM Studio, llama.cpp). Your code stays on your infrastructure.
Gitea Support
First-class support for Gitea, the self-hosted Git platform. GitHub and GitLab also supported.
Docstring Intelligence
Unique docstring analysis and generation. Detects missing, placeholder, or low-quality documentation.
Performance Optimized
Intelligent caching (80%+ hit rate), parallel analysis, circuit breakers, and rate limiting.
Core Features
Proactive Code Analysis
Automatically scans repositories for bugs, security vulnerabilities, and best practice violations. Opens issues in your Git platform with detailed findings—no manual intervention required.
Documentation Specialist
Three-tiered analysis using dictionary lookups, pattern matching, and LLM intelligence to find:
- Missing docstrings on public functions and classes
- Placeholder docstrings (TODO, FIXME, generic descriptions)
- Decorated accessors without documentation (
@property,@classmethod) - Low-signal docstrings that don't explain purpose or behavior
Automated PR Reviews
Intelligent review workflow for pull requests:
- Parses diffs into structured hunks
- Generates inline comments tied to specific lines
- Produces high-level summary with approval signal
- Works with Gitea, GitHub, and GitLab (planned)
Markdown Quality Checks
Optional lightweight linting for documentation files:
- Trailing whitespace, tabs, empty headings
- Unclosed code fences, long lines (>120 chars)
- Multiple blank lines, bare URLs
- Broken link syntax
What drep Detects
Documentation Issues
- Missing docstrings on public APIs
- Placeholder text (TODO/FIXME)
- Generic or low-signal descriptions
- Undocumented decorated methods
Code Quality Issues
- Bare except clauses
- Mutable default arguments
- Security vulnerabilities
- Best practice violations
- Potential bugs and performance issues
Supported Languages: Python (Google-style docstrings). Additional language support planned.
Platform Support
| Platform | Status | Features |
|---|---|---|
| Gitea | ✅ Full Support | Repository scans, PR reviews, webhooks, issue creation |
| GitHub | ✅ Full Support | Repository scans, PR reviews, webhooks, issue creation |
| GitLab | 🚧 Planned (Phase 3.3) | Full support coming soon |
Comparison with Existing Tools
How drep compares to other code review tools:
| Feature | drep | Greptile | PR-Agent | Codedog |
|---|---|---|---|---|
| CLI repository scans | ✅ | ❌ | ❌ | ❌ |
| Docstring suggestions | ✅ | ❌ | ❌ | ❌ |
| Gitea PR reviews | ✅ | ❌ | ❌ | ❌ |
| Local LLM | ✅ Full | ❌ | Partial | Partial |
| Gitea support | ✅ Full | ❌ | ❌ | ❌ |
| GitHub support | ✅ Full | ✅ | ✅ | ✅ |
| GitLab support | 🚧 Planned | ✅ | ✅ | ✅ |
| Draft PR automation | 🚧 Planned | ❌ | ❌ | ❌ |
Key Differentiator
Roadmap
drep is actively developed with a clear roadmap for new features and platform support.
Phase 3: Platform Expansion (Current)
- ✅ Phase 3.1: GitHub Adapter (Complete - 58 tests added)
- ✅ Phase 3.2: CLI Integration for GitHub (Complete - 11 tests added)
- 🚧 Phase 3.3: GitLab Adapter (In Progress)
Phase 4: Feature Expansion (Planned)
- Multi-language support (JavaScript, TypeScript, Go, Rust)
- Web UI dashboard for metrics and review management
- Draft PR automation
- Enhanced docstring generation
Phase 5: Advanced Features (Backlog)
- Vector database integration for semantic code search
- Custom rules engine
- Performance optimizations
- Advanced metrics dashboard
Follow development progress on GitHub or check the CHANGELOG for release history.
Ready to Get Started?
Install drep and start improving your code quality and documentation today.