Refact AI Software Development Agent

Refact is an open-source AI agent designed to handle engineering tasks end-to-end. It integrates with developers’ tools, plans, executes, and iterates until it achieves successful results.

🚀 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!

📜 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 – 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:

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

1. Download Refact for VS Code or JetBrains.
2. Set up a custom inference URL:
   plaintext http://127.0.0.1:8008
3. Configure the plugin settings:
4. JetBrains: Settings > Tools > Refact.ai > Advanced > Inference URL
5. 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! 🚀

🎉 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.

About

AI Agent that handles engineering tasks end-to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result.

refact.ai

Topics

open-source
enterprise
vscode
self-hosted
developer-tools
on-prem
fine-tuning
rag
ai-agent

Resources

Readme
Activity
Custom properties

Stars

1.8k stars

Watchers

21 watching

Forks

120 forks

Report repository

Releases 16

v1.9.1 Latest
Feb 6, 2025

+ 15 releases

Packages 0

No packages published

Contributors 22

Languages

• Rust 39.0%
• TypeScript 34.1%
• Python 15.0%
• JavaScript 8.0%
• CSS 2.3%
• HTML 1.1%
• Other 0.5%