refact

Tue, 08 Jul 2025 15:32:21 +0800

smallcloudai/refact

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

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:

`1`	`pip install .`

For GPU with CUDA capability >= 8.0 and flash-attention v2 support:

`1`	`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:
1

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.

Auto-Completion on Producthunt daily