move fast and build things — Progress from Vibe Coding to Vibe Engineering 🚀

Collaborate, brainstorm & make decisions with PMs, EMs, Architects, Engineers and AI to let the coding agents keep coding away.

🤝 Collaborate on specifications as a team before vibe coding

Take the power of vibe coding to your whole organization. Welcome to a magical new way of software development in the vibe coding era.

🪜 Take simple steps for a giant leap

🏗️ Brownfield welcome

Need to give your existing projects the vibe coding boost? All you need to do is onboard them and follow the magic ladder to lightning speed.

🔍 Grounded and relevant

mfbt includes Code Exploration and Web Search agents to ensure that the implementation plans that are generated are not just based on your conversations, but are also based on real code exploration and web searches.

📋 Source of truth for vibe coding

Let the right folks contribute to the right decisions: product, architecture, design or scalability.

🤖 Go Ralph Wiggum!

mfbt comes with a powerful CLI that has a "Ralph" mode. Once the implementation plan is ready in mfbt, using the CLI, you don't have to babysit your coding agents! Read more about mfbt CLI's Ralph mode support.

⚡ Getting Started

You can clone mfbt and run it on your own, but the easiest way to get started is signing up for the mfbt cloud service.

💬 Join the mfbt community

Let's move fast and build things! Join fellow vibe coders and vibe engineers on Slack.

☁️ Quick start: mfbt Cloud

It's free for small teams for up to 5 users! Sign up now!

📦 Prerequisites

• Docker and Docker Compose (v2+)
• An LLM API key (Anthropic, OpenAI, etc.) for AI features

🏠 Running mfbt locally

1. Create your environment file:

cp backend/.env.example backend/.env

Edit backend/.env with your configuration.

2. Start all services:

docker compose up -d

This pulls pre-built images from GHCR and starts:

Service	URL	Description
Frontend	http://localhost:8087	Next.js web interface
Backend	http://localhost:8086	FastAPI REST API
Code Explorer	http://localhost:8088	GitHub repo exploration service
PostgreSQL	localhost:25432	Database
Kafka	localhost:9092	Message queue
Redis	localhost:6379	Cache

Database migrations run automatically on startup via the migrations service.

3. Check service health:

docker compose ps

4. View logs:

# All services
docker compose logs -f

# Specific service(s)
docker compose logs -f backend worker

# Recent logs
docker compose logs --tail 100 backend

5. Open the app:

Visit http://localhost:8087 to get started.

🛑 Stopping Services

docker compose down

To also remove data volumes (database, Kafka, Redis):

docker compose down -v

🛠️ Development

For contributors who want to build from source with hot-reload, use the dev compose file:

docker compose -f docker-compose.dev.yaml watch

This builds all images from local source and enables file watching:

• Backend: Python changes auto-reload via uvicorn --reload
• Worker: Auto-restarts on code changes
• Code Explorer: Auto-restarts on code changes
• Frontend: Next.js Fast Refresh for instant updates

Dependency changes (pyproject.toml, uv.lock, package.json) trigger a full container rebuild.

🧪 Running Tests

cd backend
uv run pytest -v

📄 License

mfbt is available under the AGPL v3.