Quickstart — 10-minute path
From an empty laptop to an agent running on GCP Cloud Run, in under ten minutes. Measured, not estimated.
The short version:
# 1. Install
curl -sSL https://get.declaragent.dev | sh
# 2. Scaffold
declaragent init
# 3. Deploy
declaragent deploy gcp-cloud-run
Every step has an escape hatch for non-Linux / offline / non-GCP environments — see the linked pages below.
Walkthrough
- Install — pick one of curl, npm, or Homebrew.
- Your first agent — template-driven path. Run
declaragent init, pickconcierge, talk to the agent locally. - Conversational tour 🎯 — the recommended path. Converse with Declaragent to build a two-agent fleet end to end in ~15 minutes.
- Deploy to Cloud Run — takes the scaffolded fleet to a running Cloud Run service.
Which path should I take?
Use Conversational tour if you're new and want to see the headline capability first. Use First agent if you prefer templates + hand-editing YAML. Both converge on the same runtime — pick what matches your learning style.
What you'll end up with
my-agent/
├── agent.yaml # identity + system prompt
├── .env.example # credentials template
├── channels.yaml # optional — only when a channel is picked
├── event-sources.yaml # optional — only for webhook/Kafka/etc templates
└── skills/
└── concierge.md
Everything here is plain text. Commit it, branch it, git revert it — that's the entire point.
Screenshots
Screenshot: declaragent init walkthrough — placeholder, landing 2026-Q2.
[placeholder — landing 2026-Q2] Real screenshots of the init wizard, REPL, and deploy verify step land with slice 9.
Cross-links
- Full template catalog in the Cookbook.
- If anything goes wrong, start with Troubleshooting → install failed.