Improve initial instructions

Author: ScriptSmith

README.md

@@ -18,18 +18,59 @@ An open-source AI Gateway that provides a unified OpenAI-compatible API for rout
 
 ## Quick Start
 
+See the [Getting Started](https://hadriangateway.com/docs/getting-started) guide for more details. Otherwise:
+
+Download the latest binary from [GitHub Releases](https://github.com/ScriptSmith/hadrian/releases/latest) and run it:
+
+```bash
+./hadrian
+```
+
+Or use Docker:
+
 ```bash
-# Download and run
-cargo install hadrian
-hadrian
+cat <<'EOF' > hadrian.toml
+[server]
+host = "0.0.0.0"
+port = 8080
+
+[database]
+type = "sqlite"
+path = "/app/data/hadrian.db"
+
+[cache]
+type = "memory"
+
+[ui]
+enabled = true
+
+# Add a provider (uncomment and set your API key)
+# [providers.openai]
+# type = "open_ai"
+# api_key = "${OPENAI_API_KEY}"
+EOF
+
+docker run -p 8080:8080 \
+  -v ./hadrian.toml:/app/config/hadrian.toml:ro \
+  -v hadrian-data:/app/data \
+  ghcr.io/scriptsmith/hadrian
+```
+
+Or build from source ([just](https://just.systems) required):
 
-# Or with Docker
-docker run -p 8080:8080 ghcr.io/scriptsmith/hadrian
+```bash
+git clone https://github.com/ScriptSmith/hadrian.git
+cd hadrian && just init && just build
+./target/release/hadrian
 ```
 
-The gateway starts at `http://localhost:8080` with the chat UI. No database required for basic use.
+Or install from crates.io (find the latest version with `cargo search hadrian`):
+
+```bash
+cargo install hadrian@VERSION
+```
 
-Running without arguments creates `~/.config/hadrian/hadrian.toml` with sensible defaults, uses SQLite, and opens the browser to the chat UI.
+The gateway starts at `http://localhost:8080` with the chat UI. No database required for basic use. Running without arguments creates `~/.config/hadrian/hadrian.toml` with sensible defaults, uses SQLite, and opens the browser.
 
 ## Configuration
 

docs/components/quick-start-selector.tsx

@@ -48,6 +48,7 @@ const featureMatrix: { name: string; profiles: Profile[] }[] = [
   { name: "Azure OpenAI", profiles: ["minimal", "standard", "full"] },
   { name: "SQLite", profiles: ["minimal", "standard", "full"] },
   { name: "Embedded UI", profiles: ["minimal", "standard", "full"] },
+  { name: "Model catalog", profiles: ["minimal", "standard", "full"] },
   { name: "Setup wizard", profiles: ["minimal", "standard", "full"] },
   { name: "PostgreSQL", profiles: ["standard", "full"] },
   { name: "Redis caching", profiles: ["standard", "full"] },
@@ -57,18 +58,44 @@ const featureMatrix: { name: string; profiles: Profile[] }[] = [
   { name: "Secrets managers", profiles: ["standard", "full"] },
   { name: "OTLP & Prometheus", profiles: ["standard", "full"] },
   { name: "OpenAPI docs", profiles: ["standard", "full"] },
+  { name: "Embedded docs", profiles: ["standard", "full"] },
   { name: "Doc extraction", profiles: ["standard", "full"] },
+  { name: "Cost forecasting", profiles: ["standard", "full"] },
+  { name: "CSV export", profiles: ["standard", "full"] },
+  { name: "Response validation", profiles: ["standard", "full"] },
+  { name: "JSON schema", profiles: ["standard", "full"] },
   { name: "SAML SSO", profiles: ["full"] },
   { name: "Kreuzberg OCR", profiles: ["full"] },
   { name: "ClamAV scanning", profiles: ["full"] },
 ];
 
 function getInstallCommand(method: Method, os: OS, profile: Profile, libc: Libc): string {
   if (method === "docker") {
-    return ["docker run \\", "  -p 8080:8080 \\", "  ghcr.io/scriptsmith/hadrian"].join("\n");
+    return [
+      "cat <<'EOF' > hadrian.toml",
+      "[server]",
+      'host = "0.0.0.0"',
+      "port = 8080",
+      "",
+      "[database]",
+      'type = "sqlite"',
+      'path = "/app/data/hadrian.db"',
+      "",
+      "[cache]",
+      'type = "memory"',
+      "",
+      "[ui]",
+      "enabled = true",
+      "EOF",
+      "",
+      "docker run -p 8080:8080 \\",
+      "  -v ./hadrian.toml:/app/config/hadrian.toml:ro \\",
+      "  -v hadrian-data:/app/data \\",
+      "  ghcr.io/scriptsmith/hadrian",
+    ].join("\n");
   }
   if (method === "cargo") {
-    return "cargo install hadrian\nhadrian";
+    return `cargo install hadrian@${process.env.HADRIAN_VERSION}\nhadrian`;
   }
   const ext = os === "windows" ? "zip" : "tar.gz";
   const target = getTarget(os, libc);

docs/next.config.mjs

@@ -1,9 +1,14 @@
+import { readFileSync } from "node:fs";
 import { createMDX } from "fumadocs-mdx/next";
 
 const withMDX = createMDX();
 
+const cargoToml = readFileSync("../Cargo.toml", "utf-8");
+const version = cargoToml.match(/^version\s*=\s*"(.+)"/m)?.[1] ?? "latest";
+
 /** @type {import('next').NextConfig} */
 const config = {
+  env: { HADRIAN_VERSION: version },
   reactStrictMode: true,
   // Static export for serving from gateway
   output: "export",

justfile

@@ -1,3 +1,31 @@
+# Default feature profile (full, standard, minimal, tiny)
+profile := "full"
+
+# Install Rust nightly, frontend deps, and model catalog
+init:
+    rustup toolchain install nightly --component rustfmt
+    cd ui && pnpm install
+    cd docs && pnpm install
+    ./scripts/fetch-model-catalog.sh
+    ./scripts/fetch-openapi-specs.sh
+
+# Build frontend assets and release binary (use profile=minimal for faster builds)
+build: build-frontend build-backend
+
+# Build frontend assets (UI + docs)
+build-frontend:
+    cd ui && pnpm run generate-api && pnpm build && pnpm storybook:build
+    cd docs && pnpm build
+
+# Build release binary
+build-backend:
+    cargo build --release --no-default-features --features {{profile}}
+
+# Remove build artifacts
+clean:
+    cargo clean
+    rm -rf ui/dist ui/storybook-static docs/out data/
+
 # Run all CI checks (sequential)
 check: check-rust check-ui check-docs check-openapi check-helm check-security