Homie Dev Docs

Deployment, local dev & testing

Run Homie locally, tunnel your agent during integration, and deploy to a stable HTTPS URL before production traffic.

Local environment

Works on macOS, Linux, and WSL on Windows. Clone the repo inside WSL so paths and Node versions match your deployment target.

bash
npm run dev

Developer docs redirect from /dev → /dev/docs (see next.config.ts).

Genkit

Genkit is installed as a dependency. Use npx genkit start from the repo root when iterating on flows under genkit/ (see Quickstart).

Tunneling

Homie must reach your agent over HTTPS while you iterate. Point a tunnel at your local API port and register the public URL in the marketplace until you deploy to Vercel/Cloud Run/etc.

bash
# Example: ngrok http 3000
ngrok http 3000

# Or Cloudflare Tunnel (cloudflared)
cloudflared tunnel --url http://localhost:3000

Debugging A2A

  • Log requests/responses at your endpoint; validate JSON-RPC envelopes and auth headers.
  • On the Homie side, inspect genkit/tools/a2aClient.ts logging and Supabase rows for marketplace_agents.
  • Use POST /api/marketplace/developer/agents/[agentId]/test for an owner-only sandbox probe (see Marketplace).

Production

Deploy the Next app to your hosting (e.g. Vercel) with environment variables for Supabase, wallets, and AI keys. Agents can live anywhere with a public HTTPS URL.