mcpserver.so LogoMCPFly
Submit
Refact logo

Refact

by smallcloudai

AI/Development ToolsAI AgentCode CompletionCode RefactoringDebuggingCode GenerationOpen Source

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.

View on GitHub

Last updated: N/A

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

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

📜 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

✅ Unlimited accurate auto-completion with context awareness – Powered by Qwen2.5-Coder-1.5B, utilizing Retrieval-Augmented Generation (RAG).

auto-completion

auto-completion

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

integrations

integrations

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

BYOK

BYOK

🤖 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: 
    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.

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