Personal AI Agent

A personal AI assistant that lives in your iMessage. Text it like a contact and it gets things done.

Stack

• Runtime — Bun
• Server — Hono
• Messaging — SendBlue (iMessage API)
• Local LLM — LM Studio
• Tools — Composio (coming soon)
• Memory — Convex (coming soon)

How it works

You send iMessage
      ↓
SendBlue receives it and hits your webhook
      ↓
Hono server parses the message
      ↓
Agent loop runs (LM Studio or cloud provider)
      ↓
Response sent back via SendBlue

Getting started

Prerequisites

• Bun installed
• LM Studio running with a model loaded and local server enabled
• ngrok account
• SendBlue account with an active number

Setup

1. Clone the repo and install dependencies

bun install

2. Copy .env.example to .env and fill in your keys

cp .env.example .env

3. Run the server

bun run src/index.ts

On startup the server will:

• Spin up an ngrok tunnel
• Register the tunnel URL as your SendBlue webhook automatically

Environment variables

SENDBLUE_API_API_KEY=
SENDBLUE_API_API_SECRET=
SENDBLUE_GIVEN_NUMBER=
NGROK_AUTHTOKEN=
LM_API_TOKEN=

Roadmap

• Conversation history via Convex
• Conversation summarization
• Agent loop with tool calling
• Composio tool integrations
• Cloud LLM provider support (Anthropic, OpenAI)