fabro/docs/getting-started/quick-start.mdx
Bryan Helmkamp dc93404e38 refactor(config): move project state under .fabro
Keep project config and checked-in workflows under .fabro so they stay out of
normal repo listings. Update config discovery, CLI project commands, fixtures,
docs, and checked-in workflow paths to use .fabro/project.toml and
.fabro/workflows/*.
2026-04-11 12:55:46 -04:00

71 lines
1.5 KiB
Text

---
title: "Quick Start"
description: "Get up and running with Fabro"
---
<Note>
Fabro has two modes:
- **Standalone mode** — Run workflows directly from the CLI. This is what the quick start covers below.
- **Server mode** — An API server with a web UI for launching and managing workflow runs at scale. See [Server Mode](/administration/deploy-server) for details.
</Note>
## Install
<Tabs>
<Tab title="Claude Code">
```bash
curl -fsSL https://fabro.sh/install.md | claude
```
</Tab>
<Tab title="Codex">
```bash
codex "$(curl -fsSL https://fabro.sh/install.md)"
```
</Tab>
<Tab title="Bash">
```bash
curl -fsSL https://fabro.sh/install.sh | bash
```
</Tab>
</Tabs>
## Initialize your project
```bash
cd my-repo/
fabro repo init
```
This creates `.fabro/project.toml` and a starter workflow under `.fabro/workflows/hello/`.
## Configure API keys
Add at least one LLM provider key:
```bash
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GEMINI_API_KEY=AI...
```
<Note>
You only need one provider key to get started. Add more to enable multi-model workflows.
</Note>
## Run your first workflow
```bash
fabro run hello
```
## Next steps
<Columns cols={2}>
<Card title="Why Fabro?" icon="lightbulb" href="/getting-started/why-fabro">
Understand the problems Fabro solves.
</Card>
<Card title="Workflows" icon="diagram-project" href="/core-concepts/workflows">
Learn how to define workflow graphs in Graphviz.
</Card>
</Columns>