refact

<a name="readme-top"></a> <div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://docs.refact.ai/_astro/logo-dark.CCzD55EA.svg"> <source media="(prefers-color-scheme: light)" srcset="https://docs.refact.ai/_astro/logo-light.CblxRz3x.svg"> <!-- Fallback if neither preference is set --> <img alt="Refact.ai logo" src="https://docs.refact.ai/_astro/logo-dark.CCzD55EA.svg" width="200"> </picture> <h1 align="center">Refact - Open Sourced AI Software Development Agent</h1> </div> <div align="center"> <a href="https://github.com/smallcloudai/refact/stargazers"><img src="https://img.shields.io/github/stars/smallcloudai/refact?style=for-the-badge&color=blue" alt="Stargazers"></a> <a href="https://discord.gg/Kts7CYg99R"><img src="https://img.shields.io/badge/Discord-Join%20Us-purple?logo=discord&logoColor=white&style=for-the-badge" alt="Join our Discord community"></a> <a href="https://docs.refact.ai"><img src="https://img.shields.io/badge/documentation-blue?logo=googledocs&logoColor=FFE165&style=for-the-badge" alt="Check out the documentation"></a> </div> Refact.ai is the #1 open-source AI Agent in SWE-bench verified that handles engineering tasks end-to-end. It deeply understands your codebases and integrates with your tools, databases, and browsers to automate complex, multi-step tasks. ## 🚀 Seamless Integration with Your Workflow Refact Agent works effortlessly with the tools and databases you already use: - **📁 Version Control:** GitHub, GitLab - **🗄️ Databases:** PostgreSQL, MySQL - **🛠️ Debugging:** Pdb - **🐳 Containerization:** Docker ### ⚡ Why Choose Refact Agent? - ✅ **Deploy On-Premise:** For maximum security, choose our self-hosted AI Agent version and run it on your own infrastructure. - 🧠 **Access State-of-the-Art Models:** Use GPT-5, Claude 4.5, Gemini 3.0, DeepSeek, and more with AI Agent or for chat queries. - 🔑 **Bring Your Own Key (BYOK):** Connect your API key and use any LLM: OpenAI, Anthropic, Google, DeepSeek, Qwen, and others. - 💬 **Integrated IDE Chat:** Integrate with GitHub, PostgreSQL, Docker, and more. Refact.ai Agent accesses your resources and handles related operations autonomously, mimicking your workflow. - ⚡ **Free, Unlimited, Context-Aware Auto-Completion:** Code faster with smart AI suggestions powered by Qwen2.5-Coder-1.5B with RAG. - 🛠️ **Supports 25+ Programming Languages:** Python, JavaScript, Java, Rust, TypeScript, PHP, C++, C#, Go, and many more! ### 🎉 Hear from our Community Our Ambassadors shared remarkable stories of how they transform weeks of coding into minutes with Refact.ai Agent! 1️. How Refact.ai built 99.9% of an IoT cloud app [Read](https://www.linkedin.com/posts/refactai_refactai-agent-activity-7308103386451578881-FO23/) 2️. How AI-coded prototypes help UX teams deliver real value [Read](https://medium.com/@siarheimardovich/how-ai-coded-prototypes-help-ux-teams-deliver-real-value-b51eb2ea5167) 3️. 80 hours of building from scratch — instead done in 30 minutes [Read more](https://www.linkedin.com/posts/refactai_refactai-users-stories-activity-7310996174864289793-692-/) 4️. 3 weeks of waiting for a functional GUI? Built in just 14 minutes [Read more](https://www.linkedin.com/posts/refactai_refactai-users-stories-activity-7310996174864289793-692-/) 5. Built an automated SEO Content Generator in 60 minutes with Refact.ai [Read more](https://refact.ai/blog/2025/automated-seo-content-generator-in-60-minutes/) 📜 [View Full List of Supported Models](https://docs.refact.ai/supported-models/) > 📢 **Using AI for work? Let’s bring it to your company!** > > [Fill out this form](https://refact.ai/contact/?utm_source=github&utm_medium=readme&utm_campaign=enterprise) — Our AI Agent will be tailored to your company’s data, learning from feedback, and helping organize knowledge for **better collaboration** with your team. ## 📚 Table of Contents - 🚀 [Core Features and Functionality](#-core-features-and-functionality) - 🤖 [Which Tasks Can Refact Help You With?](#-which-tasks-can-refact-help-you-with) - ⚙️ [QuickStart](#%EF%B8%8F-quickstart) - 🐳 [Running Refact Self-Hosted in a Docker Container](#-running-refact-self-hosted-in-a-docker-container) - 🔌 [Getting Started with Plugins](#-getting-started-with-plugins) - 📖 [Documentation](#-documentation) - 🥇 [Contribution](#-contribution) - 🎉 [Join the Community](#-join-the-community) ## 🚀 Core Features and Functionality ✅ **Unlimited accurate auto-completion** with context awareness – Powered by Qwen2.5-Coder-1.5B, utilizing Retrieval-Augmented Generation (RAG).  ✅ **Integrated in-IDE Chat** – AI deeply understands your code and provides relevant, intelligent answers. ✅ **Integrated with Tools** – Works with GitHub, GitLab, PostgreSQL, MySQL, Pdb, Docker, and shell commands.  ✅ **State-of-the-Art Models** – Use GPT-5, Claude 4.5, Gemini 3.0, DeepSeek Reasoner, and more with AI Agent or for chat queries. ✅ **Bring Your Own Key (BYOK)** – Use your own API keys for external LLMs.  ## 🤖 Which Tasks Can Refact Help You With? - 🏗 **Generate code** from natural language prompts (even with typos). - 🔄 **Refactor code** for better quality and readability. - 📖 **Explain code** to quickly understand unfamiliar code. - 🐞 **Debug code** to detect and fix errors faster. - 🧪 **Generate unit tests** for reliable code. - 📌 **Code Review** with AI-assisted suggestions. - 📜 **Create Documentation** to keep knowledge up to date. - 🏷 **Generate Docstrings** for structured documentation. ## ⚙️ QuickStart You can install the Refact repository without Docker: ```bash pip install . ``` For GPU with CUDA capability >= 8.0 and flash-attention v2 support: ```bash FLASH_ATTENTION_FORCE_BUILD=TRUE MAX_JOBS=4 INSTALL_OPTIONAL=TRUE pip install . ``` ## 🐳 Running Refact Self-Hosted in a Docker Container The easiest way to run the self-hosted server is using a pre-built Docker image. See `CONTRIBUTING.md` for installation without a Docker container. ### 🔌 Getting Started with Plugins 1. **Download Refact** for VS Code or JetBrains. 2. **Set up a custom inference URL:** ``` http://127.0.0.1:8008 ``` 3. **Configure the plugin settings:** - **JetBrains:** Settings > Tools > Refact.ai > Advanced > Inference URL - **VSCode:** Extensions > Refact.ai Assistant > Settings > Address URL ## 📖 Documentation For detailed guidance and best practices, check out our [documentation.](https://docs.refact.ai/) ## 🥇 Contribution Want to contribute to our project? We're always open to new ideas and features! - **Check out GitHub Issues** – See what we're working on or suggest your own ideas. - **Read our Contributing Guide** – Check out `Contributing.md` to get started. Your contributions help shape the future of Refact Agent! 🚀 ### ⭐ Star History [](https://www.star-history.com/#smallcloudai/refact&Date) ### 🎉 Join the Community We're all about open-source and empowering developers with AI tools. Our vision is to build the future of programming. Join us and be part of the journey! 📢 **[Join our Discord server](https://refact.ai/community/)** – A community-run space for discussion, questions, and feedback. **Made with ❤️ by developers who automate the boring, so you can focus on building the future.**