AI Agent that manages engineering tasks from start to finish: connects with developers' tools, plans, executes, and refines until it reaches a successful outcome.
Overview
What is Refact?
Refact is an advanced AI agent designed to handle engineering tasks from start to finish. It seamlessly integrates with developers' tools, allowing for efficient planning, execution, and iteration until a successful result is achieved. This innovative solution is tailored to enhance productivity and streamline workflows in software development.
Features of Refact
- End-to-End Task Management: Refact manages engineering tasks comprehensively, ensuring that every step from planning to execution is covered.
- Integration with Developer Tools: It connects with various tools used by developers, making it easier to incorporate into existing workflows.
- Iterative Learning: The AI continuously learns from each task, improving its performance and adaptability over time.
- User-Friendly Interface: Designed with usability in mind, Refact offers an intuitive interface that simplifies complex engineering processes.
- Public Repository: Refact is available as a public repository, allowing developers to access, contribute, and enhance the project collaboratively.
How to Use Refact
- Access the Repository: Visit the Refact GitHub repository to get started.
- Clone the Repository: Use Git to clone the repository to your local machine.
git clone https://github.com/smallcloudai/refact.git
- Install Dependencies: Follow the installation instructions provided in the repository to set up your environment.
- Integrate with Your Tools: Configure Refact to work with your existing developer tools for seamless integration.
- Start Managing Tasks: Utilize Refact to plan, execute, and iterate on your engineering tasks effectively.
Frequently Asked Questions
Q: What programming languages does Refact support?
A: Refact is designed to be language-agnostic, meaning it can integrate with various programming languages and frameworks.
Q: Is Refact suitable for small teams?
A: Yes, Refact is ideal for teams of all sizes, from small startups to large enterprises, looking to enhance their engineering processes.
Q: How can I contribute to Refact?
A: Contributions are welcome! You can fork the repository, make your changes, and submit a pull request for review.
Q: What is the license for Refact?
A: Refact is licensed under the BSD-3-Clause license, allowing for flexible use and distribution.
Q: Where can I find more information?
A: For more details, visit the official website at refact.ai or check the documentation in the GitHub repository.
Details
<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 Claude 4, GPT-4o, or GPT-4o mini with AI Agent or for chat queries.
- 🔑 Bring Your Own Key (BYOK): Connect your API key and use any LLM: Gemini, Grok, OpenAI, Deepseek, 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.
- 🛠️ 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
2️. How AI-coded prototypes help UX teams deliver real value Read
3️. 80 hours of building from scratch — instead done in 30 minutes Read more
4️. 3 weeks of waiting for a functional GUI? Built in just 14 minutes Read more
- Built an automated SEO Content Generator in 60 minutes with Refact.ai Read more
📜 View Full List of Supported Models
📢 Using AI for work? Let’s bring it to your company!
Fill out this form — 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
- 🤖 Which Tasks Can Refact Help You With?
- ⚙️ QuickStart
- 🐳 Running Refact Self-Hosted in a Docker Container
- 🔌 Getting Started with Plugins
- 📖 Documentation
- 🥇 Contribution
- 🎉 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 Claude 4, GPT-4o, or GPT-4o mini 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:
pip install .
For GPU with CUDA capability >= 8.0 and flash-attention v2 support:
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
- Download Refact for VS Code or JetBrains.
- Set up a custom inference URL:
http://127.0.0.1:8008
- 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.
🥇 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
🎉 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 – 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.
Server Config