mirror of
https://github.com/fabro-sh/fabro.git
synced 2026-08-28 05:27:41 +00:00
a8599a924f
The primary install flow is now to start the server, complete setup in a browser-based wizard, and restart. fabro install is retained as the headless CLI-only alternative. - Auto-open the install URL in the user's browser when fabro server start enters install mode; print a manual-open fallback when open::that fails - Rewrite install.md so agents drive the full start → wait → restart loop - Retarget install.sh Y/n prompt from fabro install to fabro server start - Update README, quick-start, deploy-server, cli reference, and marketing captions to point at fabro server start as the next step after download - Add troubleshooting entries for "wizard didn't open" and "server exited after wizard" Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
84 lines
1.9 KiB
Text
84 lines
1.9 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="Homebrew">
|
|
```bash
|
|
brew install fabro-sh/tap/fabro-nightly
|
|
```
|
|
</Tab>
|
|
<Tab title="Bash">
|
|
```bash
|
|
curl -fsSL https://fabro.sh/install.sh | bash
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
<Tip>
|
|
Release binaries and the multi-arch Docker image ship with [SLSA Build Provenance](/reference/verifying-releases) attestations you can verify with `gh attestation verify`.
|
|
</Tip>
|
|
|
|
<Note>
|
|
Setting up server mode instead? Run `fabro server start` to finish setup in a browser-based wizard. See [Running the Fabro Server](/administration/deploy-server) for the full flow.
|
|
</Note>
|
|
|
|
## 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>
|