WeeShip

WeeAgent

WeeAgent

What is WeeAgent

WeeAgent is a reusable, decoupled AI assistant block for your SaaS: a streaming chat, an agentic loop (the agent calls tools, navigates to a record with an animated cursor, updates it, and summarizes), and a hands-free voice mode.

It has no business logic of its own. You connect it to your data and navigation through a small AppBridge, so the same agent works on any app built with the kit.

What's included

  • Streaming chat (SSE, OpenAI format) via OpenRouter — with a mock fallback so it runs without a key.
  • Agentic tool loop: the agent emits an action, you execute it, the observation is fed back until a final answer.
  • A ghost cursor that visibly drives the UI (moves to a record and clicks it).
  • Voice mode: reactive orb, speech-to-text (Groq/Whisper or browser), text-to-speech (ElevenLabs or browser).
  • Optional daily voice greeting that welcomes the user by name.
Every capability has a no-key fallback, so WeeAgent runs out-of-the-box and you enable real providers when ready.

Architecture

  • supabase/functions/weeagent — streaming chat proxy (OpenRouter, mock fallback).
  • supabase/functions/weeagent-tts — ElevenLabs voice (mp3).
  • supabase/functions/weeagent-transcribe — Whisper via Groq.
  • supabase/functions/weeagent-config — server capabilities (never exposes secrets).
  • src/weeagent/ — front module: provider, dock, voice panel, ghost cursor, agent loop.

Next: read Installation to deploy it, then Wire it to your data.