local_fire_departmentHoneystax
search⌘K
loginLog Inperson_addSign Up
layers
HONEYSTAX TERMINAL v1.0
HomeNewsSavedSubmit
Back to the live board
R

refact

Agent

AI Agent that handles engineering tasks end-to-end: integrates with developers’ tools, plans, executes, and iterates...

Copy the install, test the workflow, then decide if it earns a permanent slot.

3,538
Why nowMoving now

Fresh repo activity plus visible builder pull. This is the kind of tool people test before it turns obvious.

DecisionHigh-conviction move

Copy the install, test the workflow, then decide if it earns a permanent slot.

Trial costDeep lift

This wants more setup and more teardown. Run it only if the upside is clear.

Risk32/100

GitHub health 62/100. no security policy. Fresh enough repo health and manageable issue load keep the risk controlled.

What You Are Adopting

AI Agent

Universal

Model

Multiple

Build Time

Minutes

Test This In Your Stack

One command inClean rollbackLow commitment
shieldSandboxedInstalls to ~/.claude — isolated from your projects. One command to remove.

Fastest way to find out if refact belongs in your setup.

Copy the install command, run a real test, and back it out cleanly if it slows you down.

Try now
git clone https://github.com/smallcloudai/refact ~/.claude/agents/refact

Run this first. You will know quickly if the workflow earns a permanent slot.

Back out
rm -rf ~/.claude/agents/refact

No messy cleanup loop. If it misses, remove it and keep moving.

Install Location

~/  └─ .claude/      ├─ commands/      ├─ agents/      │   └─ refact/ ← installs here      └─ settings.json

About

AI Agent that handles engineering tasks end-to-end: integrates with developers’ tools, plans, executes, and iterates until it achieves a successful result.. An open-source agent for the AI coding ecosystem.

README

Refact.ai logo

Refact - Open Sourced AI Software Development Agent

Stargazers Join our Discord community Check out the documentation

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 GPT-5, Claude 4.5, Gemini 3.0, DeepSeek, and more with AI Agent or for chat queries.
  • 🔑 Bring Your Own Key (BYOK): Connect your API key and use any LLM: OpenAI, Anthropic, Google, DeepSeek, Qwen, 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 powered by Qwen2.5-Coder-1.5B with RAG.
  • 🛠️ 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

  1. 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).

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

✅ State-of-the-Art Models – Use GPT-5, Claude 4.5, Gemini 3.0, DeepSeek Reasoner, and more with AI Agent or for chat queries.

✅ Bring Your Own Key (BYOK) – Use your own API keys for external LLMs.

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

⭐ Star History

Star History Chart

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

Tech Stack

GoTypeScriptJavaScriptPythonRustJavaPHPPostgreSQLMySQLOpenAIClaudeAnthropicGPTLLMDocker

Installation

http://127.0.0.1:8008

Open Live ProjectAudit Repo

Reviews0

Log in to write a review.

ActiveLast commit today
bug_report43open issues
Submitted April 19, 2023

auto_awesomeYour strongest next moves after refact