02Getting Started
SECTION 02•SETUP
Getting Started
System prerequisites, local environment preparation, and initial setup.
System Prerequisites
Orbit requires a local development environment with the Google Antigravity command-line interface installed and authenticated.
| Requirement | Version / Specification | Verification Command |
|---|---|---|
| Operating System | Linux (x86_64, arm64), macOS 12+, Windows 10+ | uname -sm |
| Google Antigravity CLI | agy binary in system PATH or ~/.local/bin | agy --version |
| Antigravity Auth | Authenticated Google account credentials | agy auth status |
Environment Verification
Ensure that your terminal shell can invoke agy directly. If your Antigravity binary is installed in an isolated path, verify its location:
# 1. Verify binary location
$ which agy
/usr/local/bin/agy
# 2. Check authentication state
$ agy auth status
Authenticated as [email protected]
Non-standard PATH setup: If
agy is located outside standard directories (e.g. within a custom pyenv or nix profile), you can export ORBIT_AGY_PATH=/path/to/agy before launching Orbit.First Launch
When you open Orbit for the first time:
- Orbit checks the runtime environment and verifies communication with the
agyCLI. - Click "New Project" and select any local repository directory on your filesystem.
- Orbit initializes a project record in local SQLite and binds all future turns and artifact trackers to that directory.
- Enter your prompt in the turn input area. Orbit streams tool calls, diffs, and responses in real time.