patchwork  by patched-codes

CLI tool for enterprise workflow automation using agentic AI

created 1 year ago
1,415 stars

Top 29.3% on sourcepulse

GitHubView on GitHub
Project Summary

Patchwork is an agentic AI framework designed to automate enterprise development workflows such as code reviews, bug fixing, and security patching. It targets developers and DevOps teams seeking to streamline repetitive tasks using a self-hosted CLI agent and various Large Language Models (LLMs). The primary benefit is the reduction of manual effort in common development processes.

How It Works

Patchwork operates through a modular architecture comprising reusable "Steps" (atomic actions like creating a PR or calling an LLM), customizable "Prompt Templates" for LLM interactions, and "Patchflows" that orchestrate these components for specific automation tasks. This approach allows for flexible composition of complex workflows, enabling users to build custom automations or leverage pre-built ones for tasks like vulnerability remediation or documentation generation.

Quick Start & Requirements

  • Install: pip install 'patchwork-cli[all]' --upgrade
  • Prerequisites: Optional security group for Semgrep/depscan, rag group for ChromaDB. Supports OpenAI-compatible LLM endpoints (Groq, Together AI, Hugging Face, local models via llama.cpp, ollama, vllm, TGI). Requires API keys for chosen LLMs and GitHub.
  • Demo: https://youtu.be/MLyn6B3bFMU
  • Docs: https://docs.patched.codes/

Highlighted Details

  • Supports a wide range of LLMs, including local and open-source models via OpenAI-compatible APIs.
  • Pre-built Patchflows cover common tasks like PR reviews, auto-fixing vulnerabilities, and dependency upgrades.
  • Extensible architecture allows users to create custom Steps and Patchflows.
  • Can be integrated into CI/CD pipelines.

Maintenance & Community

  • Active development indicated by CI build status.
  • Community support via Discord: https://discord.gg/XDxA3mJyhE
  • Roadmap includes debugger, validation module, and support for large-scale code embeddings.

Licensing & Compatibility

  • Core framework licensed under AGPL-3.0.
  • Custom patchflows and steps template repository licensed under Apache-2.0.
  • AGPL-3.0 license may have implications for commercial use or linking with closed-source software.

Limitations & Caveats

The AGPL-3.0 license requires any modifications or derivative works of the core framework to be made publicly available under the same license, which could be a significant consideration for proprietary enterprise use.

Health Check
Last commit

3 months ago

Responsiveness

1 day

Pull Requests (30d)
1
Issues (30d)
0
Star History
87 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.