diff --git a/Cargo.toml b/Cargo.toml
index 2313be7..5d50040 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "zerogravity"
-version = "3.0.0"
+version = "1.0.0"
 edition = "2021"
 
 [[bin]]
diff --git a/README.md b/README.md
index 6f38c6b..d21ff3a 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,16 @@
   OpenAI-compatible proxy that intercepts and relays requests to Google's Antigravity language server, impersonating the real Electron webview.
 </p>
 
+<p align="center">
+  <img src="https://img.shields.io/badge/rust-1.75+-93450a?style=flat-square&logo=rust" alt="Rust" />
+  <img src="https://img.shields.io/badge/platform-linux%20%7C%20macos%20%7C%20windows-555?style=flat-square" alt="Platform" />
+  <img src="https://img.shields.io/badge/license-private-333?style=flat-square" alt="License" />
+  <img src="https://img.shields.io/badge/API-OpenAI%20%7C%20Gemini-666?style=flat-square" alt="API" />
+  <img src="https://img.shields.io/badge/TLS-BoringSSL-444?style=flat-square" alt="TLS" />
+  <img src="https://img.shields.io/badge/proxy-MITM-555?style=flat-square" alt="MITM" />
+  <img src="https://img.shields.io/badge/stealth-JA3%2FJA4-333?style=flat-square" alt="Stealth" />
+</p>
+
 ---
 
 ```mermaid
@@ -27,6 +37,16 @@ graph LR
     style Google fill:#444,color:#e0e0e0,stroke:#888
 ```
 
+## Models
+
+| Name                | Label                      | Notes               |
+| ------------------- | -------------------------- | ------------------- |
+| `opus-4.6`          | Claude Opus 4.6 (Thinking) | Default model       |
+| `opus-4.5`          | Claude Opus 4.5 (Thinking) | —                   |
+| `gemini-3-pro-high` | Gemini 3 Pro (High)        | —                   |
+| `gemini-3-pro`      | Gemini 3 Pro (Low)         | —                   |
+| `gemini-3-flash`    | Gemini 3 Flash             | Recommended for dev |
+
 ## Quick Start
 
 ```bash
@@ -37,6 +57,60 @@ RUST_LOG=info ./target/release/zerogravity --headless
 zg start
 ```
 
+## Setup
+
+### Linux
+
+```bash
+# Prerequisites: Rust toolchain, iptables
+./scripts/setup-linux.sh
+```
+
+Creates a `zerogravity-ls` system user for UID-scoped iptables isolation, installs a systemd user service, and builds the release binary.
+
+```bash
+# Start the service
+systemctl --user enable --now zerogravity
+
+# Or use the daemon manager
+zg start
+```
+
+### macOS
+
+```bash
+# Prerequisites: Rust toolchain
+./scripts/setup-macos.sh
+```
+
+Installs a launchd plist for automatic startup. No UID isolation — runs in headless/HTTPS_PROXY mode only.
+
+```bash
+# Start the service
+launchctl load ~/Library/LaunchAgents/com.zerogravity.proxy.plist
+
+# Or use the daemon manager
+zg start
+```
+
+### Windows
+
+```powershell
+# Prerequisites: Rust toolchain
+# Run as Administrator
+powershell -ExecutionPolicy Bypass -File scripts\setup-windows.ps1
+```
+
+Creates config directories, builds the release binary, and installs a scheduled task for automatic startup at logon.
+
+```powershell
+# Start now
+schtasks /run /tn "ZeroGravity Proxy"
+
+# Or manually
+.\target\release\zerogravity.exe
+```
+
 ## Endpoints
 
 | Method     | Path                              | Description                            |