Autonomous AI hires that live inside your iMessage, SMS, WhatsApp, and Slack.
Software disguised as conversation.
Live Product • The 3 Hires • Mini-App Engine • Link Agentic Purchases • Architecture • Quick Start • Deployment
Most AI assistants are chatbots trapped in a browser tab that vomit walls of Markdown prose.
HireAlpha is an autonomous workforce that texts you first.
Each hire is a distinct, persistent contact with its own phone number, memory, personality, and toolchain. When work needs doing, they don't hallucinate or lecture you — they mint interactive, reactive micro-applications directly inside your conversation thread.
YOU (iMessage) ──────────────────────> "I ate a chipotle chicken bowl with guac and a diet coke"
ALPHA (Friend) <────────────────────── "Logged 820 cal · 54g protein. You have 420 cal left today."
[ Interactive Nutrition Breakdown & Deficit Ring ↗ ]
YOU (iMessage) ──────────────────────> "Schedule 30m with Sarah next week"
ALPHA (Coworker) <──────────────────── "Found 3 slots across your Google Calendar. Sent her a link:"
[ Pick-A-Slot Scheduling Sheet ↗ ]
HireAlpha is not one chatbot with toggleable modes. It is three dedicated hires with strict memory partitions — your personal assistant never sees your sales pipeline, and your cofounder never asks about your protein goal.
| Hire | Persona & Role | In Messages As | Live Surface | Core Superpowers |
|---|---|---|---|---|
| Friend | Personal Chief of Staff Health, habits, finances, relationships |
Alpha(415) 595-1440 |
Live Now | • Morning & Evening Debriefs (The Day, Closed)• Vision Nutrition Guessing (Gemini 3.7 Flash) • 5-Day Workout Splits with Animated GIF Demos • Emoji-Free Glassmorphic Mood Tracker • Relationship Radar ("Who is due a ping") |
| Coworker | Executive Colleague Linear, GitHub, inbox zero, standups |
Alpha (Coworker) |
Workshop Rollout | • Linear Issue Triage & GitHub PR Digests • Attendee dossiers & 1-tap pre-meeting briefs • Standup synthesis & automated drafting • Email review ("Approve & Send" card) • Open loops & task commitments ledger |
| Cofounder | Startup Partner Pipeline, runway, investor updates |
Alpha(CoFounder) |
Workshop Rollout | • Live Deal CRM & Pipeline Stage Board • Runway snapshots, monthly burn & cash forecasting • Decision Ledger with historical outcome tracking • Investor update drafting & shareholder letters |
When an action requires precision, Alpha sends a high-speed, cryptographically signed micro-application that opens instantaneously inside Messages or your browser.
┌────────────────────────────────────────────────────────────────────────┐
│ HIREALPHA MINI-APP ECOSYSTEM │
├───────────────────┬───────────────────────────────┬────────────────────┤
│ 🏃 Life & Fitness │ 💼 Executive & Work │ 🚀 Startup & Fund │
├───────────────────┼───────────────────────────────┼────────────────────┤
│ • workout_log │ • digest (Meeting Briefings) │ • pipeline_board │
│ • nutrition │ • approve_send (Email Triage) │ • decision_ledger │
│ • mood_tracker │ • pick_slot (Calendar Booker) │ • runway_snapshot │
│ • habit_streak │ • linear_triage │ • investor_update │
│ • sleep_tracker │ • standup_paste │ • cap_table │
│ • spending_radar │ • open_loops │ • hire_decision │
│ • networking_crm │ • drop_zone │ • spiral_options │
└───────────────────┴───────────────────────────────┴────────────────────┘
- Dual Modality: Toggle between bodyweight Home routines (zero gear required) and progressive overload Gym programs.
- 5 Focused Disciplines: Strength & Muscle, Calisthenics, HIIT & Burn, Legs & Glutes, Core & Posture.
- Form Demos: Embedded, self-hosted animated demonstration GIFs for every single programmed movement with pacing cues.
- Rest Interval Timers: Auto-calculating countdown clocks for supersets, dropsets, and rest periods.
- Snap & Log: Send a meal photo or raw text description over iMessage.
- Gemini 3.7 Vision: Multimodal estimation of calories, protein, carbs, and fats with formula reconciliation.
- Live Daily Budget: Tracks remaining calories against your target goal with persistent streak calculations.
- 0–100 Algorithm: Synthesizes workout logs, macro adherence, completed habits, and sleep quality into an objective daily performance score.
- 1-Tap Fix Shortcuts: Any incomplete goal links directly to its interactive mini-app to log and boost your score before midnight.
HireAlpha features a safe autonomous commerce architecture. Alpha can browse, select items, and complete purchases on your behalf using Stripe Link and an isolated headless Playwright browser.
sequenceDiagram
autonumber
actor User as User (iMessage / Web)
participant Alpha as Spectrum Agent
participant API as hire-api
participant Vault as Encrypted Vault
participant Worker as Browser Worker (Playwright)
participant Merchant as E-Commerce Merchant
User->>Alpha: "Order the standard Whey Protein from Amazon"
Alpha->>API: Propose purchase (item, merchant, estimated cost)
API->>User: Renders [Approve Purchase Card] (Exact merchant + cap)
User->>API: Taps "Approve $42.50"
API->>Vault: Validate signed session & decrypt Link auth token
API->>Worker: Dispatch isolated job with Link authorization
Worker->>Merchant: Automate checkout in headless session
Worker->>Vault: Retrieve single-use ephemeral virtual card
Worker->>Merchant: Submit payment & capture confirmation
Worker->>API: Return receipt & order ID
API->>User: "Ordered! Tracking: #1Z999... Arriving Thursday."
- Zero Card Leakage: Raw card details never touch model prompts, disk logs, or database records.
- Strict Spending Caps: Per-purchase ceilings (
USER_SPEND_MAX_CENTS, default $200) enforce strict spend boundaries. - Explicit Human-in-the-Loop: Alpha never completes a transaction without a signed user tap on an approval card.
flowchart TB
subgraph Ingestion["1. Multi-Channel Ingestion"]
direction LR
IM[iMessage / SMS]
SL[Slack]
WA[WhatsApp]
WB[Web App · hirealpha.chat]
end
subgraph Engine["2. Turn Engine (Bun Spectrum)"]
direction TB
ROUTER[Intent Classifier]
HONESTY[Honesty Guard & Ground Truth Filter]
TOOLS[Tool Orchestrator · GMI / Gemini 3.7]
end
subgraph Core["3. Backend API (hire-api · Bun)"]
direction TB
AUTH[Session & Token Auth]
MINI[Mini-App Card Minting]
LOOP[Habit, Sleep & Loop Ledgers]
BILL[Stripe Subscriptions]
end
subgraph Storage["4. Data & External Services"]
direction LR
PG[(Postgres 16)]
COMP[Composio · Gmail & Calendar]
PW[Playwright Browser Cluster]
VAULT[Link Encrypted Secret Vault]
end
IM & SL & WA --> ROUTER
WB --> AUTH
ROUTER --> HONESTY --> TOOLS
TOOLS --> Core
Core --> PG
Core --> COMP
Core --> PW
Core --> VAULT
Core --> BILL
Unlike typical wrappers that hallucinate capabilities, HireAlpha enforces the Honesty Guard:
- Never Fakes Outbound Action: Alpha will never claim it sent an email, text, or invitation unless the API returns an explicit provider ID.
- Never Invents Availability: Meeting slots are derived directly from active free/busy Google Calendar blocks.
- Transparent Estimates: Nutrition estimation explicitly flags itself as an AI estimate with easy manual adjustment.
HireAlpha/
├── src/ # Frontend Single Page App (React 19 + TypeScript)
│ ├── platform/ # Logged-in application shell & 30+ interactive mini-apps
│ │ ├── BriefApp.tsx # Morning & Evening Brief ("The Day, Closed")
│ │ ├── FeatureMiniApps.tsx # Nutrition, Mood, Habits, & Spending mini-apps
│ │ ├── LifeMiniApps.tsx # Workout App (Interactive gym/home timer + GIFs)
│ │ ├── workoutProgram.ts # Periodized workout matrices, categories, & splits
│ │ ├── exerciseDemos.ts # Self-hosted exercise GIF animation map
│ │ ├── miniAppCatalog.ts # Canonical slug aliases, icons, & routing matrix
│ │ └── homeA.css # Ambient dark-mode glassmorphic design system
│ ├── Landing.tsx # Marketing site with interactive phone simulator
│ └── index.css # Global typography, tokens, & responsive layout
│
├── spectrum/ # Autonomous Agent Bots (Bun runtime)
│ ├── alpha/ # Alpha Friend persona (Chief of Staff)
│ ├── alpha-coworker/ # Alpha Coworker persona (Linear, Standup, Mail)
│ ├── alpha-cofounder/ # Alpha Cofounder persona (Pipeline, Runway)
│ └── shared/ # Shared turn engine, tool dispatch, & honesty guards
│
├── deploy/ # Backend Microservices & API
│ ├── hire-api.ts # Core API: ~160 routes (auth, billing, briefs, DB)
│ ├── web-server.ts # Production static server with Brotli & preload hints
│ ├── browserWorker.ts # Isolated Playwright runner for Link autonomous purchases
│ ├── browserVault.ts # AES-GCM encrypted user credential vault
│ └── gmailHelpers.ts # Triage heuristics, timezone windows, & Composio bridges
│
├── services/ # Autonomous execution tools (Playwright, Code sandbox)
├── scripts/ # Deploy automation, database migrations, dev runners
└── marketing/ # Launch assets, verified fact sheets, & promo videos
- Bun (v1.2+)
- Node.js (v20+)
- PostgreSQL (v15+)
git clone https://github.com/Sashank-Singh/hirealpha.git
cd hirealpha
npm installcp .env.example .envFill in the essential variables:
DATABASE_URL="postgres://postgres:password@localhost:5432/hirealpha"
HIREALPHA_INTERNAL_KEY="your-internal-secret"
GMI_API_KEY="your-gemini-or-gmi-api-key"
STRIPE_SECRET_KEY="sk_test_..."
STRIPE_WEBHOOK_SECRET="whsec_..."Run the backend API:
bun deploy/hire-api.tsIn a second terminal, launch the agent bots:
bash scripts/start-spectrum.shIn a third terminal, run the Vite dev server:
npm run devOpen http://localhost:5173 to view the app!
HireAlpha maintains a comprehensive test suite covering turn gating, financial calculations, nutrition estimates, and timezone boundary conditions.
# Run all unit and integration tests (Bun test runner)
bun test
# Run specific domain suites
bun test spectrum/shared/workoutProgram.test.ts
bun test deploy/hireApiRoute.test.ts
bun test deploy/modelJson.test.ts
# Typecheck and lint
bun x tsc --noEmit
npm run lintNutrition uses the configured GLM 5.3 Flash provider, including Novita and OpenRouter model identifiers. Complete macro responses are required; failed estimates can be retried without creating another log. Open a saved meal and choose Retry estimate to update its macros in place, including older entries marked “estimate pending.” Chat saves the description when estimation is unavailable and reports that state explicitly.
Production is deployed on Coolify with isolated container boundaries:
- Unified Docker Image:
Dockerfilebuilds all three agent personalities from one optimized multi-stage build (HIREALPHA_BOT=friend|coworker|cofounder). - Nginx Reverse Proxy: Production edge router (
deploy/nginx-web.conf) with SSL termination, HTTP/2, and security headers. - Automated Zero-Downtime Deploy:
bash scripts/deploy-prod.sh
- Self-Hosted Analytics: Privacy-first Plausible instance (
deploy/plausible/) tracking conversions and referral milestones.
Proprietary Software. Developed with precision by the HireAlpha core engineering team.
For business inquiries, enterprise integrations, or custom deployments, visit hirealpha.chat.