https://github.com/smallcloudai/refact
AI Agent that handles engineering tasks end-to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result.
https://github.com/smallcloudai/refact
ai-agent developer-tools enterprise fine-tuning on-prem open-source rag self-hosted vscode
Last synced: 2 months ago
JSON representation
AI Agent that handles engineering tasks end-to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result.
- Host: GitHub
- URL: https://github.com/smallcloudai/refact
- Owner: smallcloudai
- Created: 2023-04-19T06:43:51.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-28T13:19:54.000Z (3 months ago)
- Last Synced: 2025-04-28T14:12:41.536Z (3 months ago)
- Topics: ai-agent, developer-tools, enterprise, fine-tuning, on-prem, open-source, rag, self-hosted, vscode
- Language: Rust
- Homepage: https://refact.ai
- Size: 127 MB
- Stars: 1,903
- Watchers: 25
- Forks: 139
- Open Issues: 56
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-repositories - smallcloudai/refact - WebUI for Fine-Tuning and Self-hosting of Open-Source Large Language Models for Coding (JavaScript)
- StarryDivineSky - smallcloudai/refact
- AiTreasureBox - smallcloudai/refact - 07-09_2813_4](https://img.shields.io/github/stars/smallcloudai/refact.svg)|AI Agent that handles engineering tasks end-to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result.| (Repos)
- awesome-ChatGPT-repositories - refact - WebUI for Fine-Tuning and Self-hosting of Open-Source Large Language Models for Coding (NLP)
- definitive-opensource - Refact - to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result. | `VSCode` | **2.9k** | (Table of Contents / Agent)
- awesome - smallcloudai/refact - AI Agent that handles engineering tasks end-to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result. (Rust)
- awesome-ai - smallcloudai/refact - to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result. ☆`2,264` (Assistants / IDE extensions)
- awesome-ai - smallcloudai/refact - to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result. ☆`2,264` (Assistants / IDE extensions)
README
Refact - Open Sourced AI Software Development Agent
Refact Agent is a free, open-source AI Agent 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:** Maintain **100% control** over your codebase.
- 🧠 **Access State-of-the-Art Models:** Supports Claude 3.7 Sonnet, GPT-4o, o3-mini, and more.
- 🔑 **Bring Your Own Key (BYOK):** Use your own API keys for external LLMs.
- 💬 **Integrated IDE Chat:** Stay in your workflow, no need to switch between tools!
- ⚡ **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-/)
📜 [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** – Supports Claude 3.7 Sonnet, GPT-4o, o3-mini, and more.
✅ **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! 🚀
### 🎉 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.**