# Backant
> AI-native backend generator. One prompt, a production Flask API.

URL: https://backant.io
Docs: https://docs.backant.io
GitHub: https://github.com/backant-io
Discord: https://discord.gg/6GNzK2SAeC

---

## What it does

Backant scaffolds complete, layered Flask backends from a JSON spec or a single CLI command.
It generates routes, services, repositories, models, Docker Compose configs, and GitHub Actions CI/CD — all wired and ready to run.

Coding agents (Claude Code, Cursor, Windsurf, and 30+ MCP-compatible tools) can call Backant directly via its MCP server to scaffold and extend backends without leaving the chat.

---

## CLI Installation

```
npm install -g backant
```

Or run the setup wizard:

```
npx backant-wizard@latest
```

---

## CLI Commands

### Generate a full API from a JSON spec
```
ant generate api <name> --json <spec.json>
```
Generates: routes, services, repositories, models, Docker Compose (dev + prod), GitHub Actions workflow, requirements.txt.

### Generate a single route in an existing project
```
ant generate route <name>
```

### Generate a sub-route
```
ant generate subroute <name>
```

### Mock data for rapid prototyping
```
ant generate route <name> --mock '[{"id":1,"name":"example"}]'
```

---

## MCP Server

Install once via the wizard. Your coding agent gets access to:

- `backant_generate_api` — scaffold a full project from a JSON spec
- `backant_generate_route` — add a new layered endpoint to an existing project
- `backant_generate_subroute` — add a sub-route to an existing route

Compatible with: Claude Code, Cursor, Windsurf, and any MCP-compatible agent.

MCP setup guide: https://docs.backant.io/getting-started/agentic-development

---

## Generated Project Structure

```
project/
├── api/
│   ├── routes/        # Flask blueprints
│   ├── services/      # Business logic
│   ├── repositories/  # Data access layer
│   ├── models/        # SQLAlchemy models
│   ├── startup/       # App factory, DB init
│   └── app.py         # Entry point
├── docker-compose.yml
├── docker-compose-prod.yml
├── .github/
│   └── workflows/
│       └── deploy.yml
└── requirements.txt
```

---

## Pricing

### FREE — $0/month (forever)
- 100 MCP requests/month
- Basic CLI access
- Community support

### VIBE CODER — $15/month
- 1,000 MCP requests/month
- Priority support
- Higher rate limits

### STARTUP — $50/engineer/month
- 5,000 MCP requests/month
- Team collaboration
- SLA guarantee

### ENTERPRISE — Custom pricing
- Unlimited requests
- Dedicated support
- Custom deployment
- Contact: hello@backant.dev

---

## Roadmap

### Now (shipped)
- JSON spec → full project generation
- MCP server for 30+ coding agents

### Next
- Alembic migrations auto-generated per route
- Auth scaffold (JWT / Cognito) via single flag

### Soon
- Natural language → JSON spec → project
- One-command deploy to AWS ECS / Railway

### Later
- Frontend scaffold (Next.js ↔ API auto-wired)

---

## Links

- Website: https://backant.io
- Documentation: https://docs.backant.io
- MCP integration: https://docs.backant.io/getting-started/agentic-development
- CLI reference: https://docs.backant.io/cli/installation
- GitHub: https://github.com/backant-io
- Discord: https://discord.gg/6GNzK2SAeC
- Schedule a call: https://cal.com/pavel-hegler/15min
- Terms: https://backant.io/terms
- Privacy: https://backant.io/privacy