Get started
Quickstart
Analyze a GitHub repository, answer a short questionnaire and get four priced production architectures with their Terraform, in about two minutes.
This walkthrough takes a public repository from URL to validated Terraform. No account is needed for the first analyses; signing in with GitHub keeps your history and unlocks private repositories on paid plans.
1. Paste a repository
Open https://brunel.cloud/new and paste a GitHub repository: https://github.com/owner/repo, a branch URL (https://github.com/owner/repo/tree/<branch>), the SSH form git@github.com:owner/repo.git or simply owner/repo. Only GitHub is supported.
Brunel downloads the repository read-only from GitHub, keeps code and configuration files only, and runs its detectors. Nothing is installed, built or executed.
2. Review what Brunel found
The analysis shows, in a few seconds:
- Facts: languages, frameworks, datastores, caches, queues, workers, cron jobs, integrations, existing infrastructure. Each fact has a confidence and links to its evidence (file and lines).
- Services: the deployable units Brunel identified (web app, API, worker, cron…).
- Security check: findings with a severity, the file they come from and a fix.
If a fact is wrong, correct it: facts you set are marked as yours and win over detection.
3. Answer the questionnaire
Brunel pre-fills a short context from the code. Adjust what you know:
| Field | Meaning | Default |
|---|---|---|
| Peak requests per second | Busiest moment you must serve | 20 |
| Monthly active users | Scale of the audience | 1,000 |
| Data volume (GB) | What the databases and storage hold | 10 |
| Monthly budget (€) | What you are ready to spend on the cloud | 100 |
| Operations skill | none, basic or strong: how much you want to run yourself | basic |
| Availability | 99, 99.9 or 99.95 % | 99.9 |
| Compliance | GDPR, EU data residency, health data (HDS), card payments (PCI DSS) | GDPR |
| Provider | AWS or Scaleway (region Paris) | AWS |
4. Read the four tiers
Brunel designs four complete architectures: Starter, Growth, Scale and Enterprise. Each covers compute, data, network, security, observability, CI/CD, resilience and environments, is mapped to real services and SKUs, and is priced line by line. Click any component to see why it is there, what it costs, and the alternatives that were rejected. Read Architecture tiers.
5. Refine in plain language
Ask questions or request changes in the chat: "Use a managed Redis", "We need EU data residency", "Cut the budget to €300". A change creates a new version with a diff and its monthly cost delta; switching provider or currency is instant and does not use the AI. Read Refine.
6. Get the files
Open the Files panel to browse the generated bundle, or export it as a ZIP (Pro and above): Terraform per domain, Kubernetes manifests or a Compose file, GitHub Actions, ARCHITECTURE.md, MIGRATION.md, COSTS.md and ADRs. Every bundle shape is validated in Brunel's CI with terraform validate, kubeconform and actionlint. Read Generated files.
Next steps
- Automate it: REST API or MCP server.
- Keep it current: Real-time tracking and Pull request reviews.
- Ship it: Deployment through your own CI.