Refact - Open Sourced AI Software Development Agent
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](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 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:
```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
### π 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.**
