claude-starburst
v0.1.0
Published
Scaffold a Claude-powered AI agent stack on any messaging channel — WhatsApp, Telegram, Discord — using your Claude subscription. No Anthropic API key required.
Maintainers
Readme
Claude Starburst is a one-command setup tool that scaffolds a full AI agent stack on your machine. It bridges GoClaw (a multi-tenant agent gateway) to the claude CLI, so you can deploy a Claude-powered assistant on WhatsApp, Telegram, Slack, Discord — or any channel GoClaw supports — for $20/month (the cost of a Claude subscription) instead of $100+ in API fees.
How it works
Your message (WhatsApp, Telegram, API...)
↓
GoClaw ← multi-tenant agent gateway
↓ Ollama API call
claude-starburst-server ← Ollama-compatible HTTP server (runs on your machine)
↓ claude -p
Claude CLI ← your subscription, authenticated
↓ optional
Your MCP server ← calendar, CRM, database, any toolThe server exposes port 11437 as a fake Ollama endpoint. GoClaw thinks it's talking to a local Ollama instance — no patches, no forks.
Quick Start
npx claude-starburstThat's it. The wizard handles the rest.
Prerequisites
- Node.js >= 18 — nodejs.org
- Docker — docs.docker.com/get-docker
- Claude CLI authenticated —
npm install -g @anthropic-ai/claude-codethenclaude - Redis (optional, recommended) — enables multi-turn memory
Check your environment first:
npx claude-starburst --detectSetup Paths
The wizard asks what you want to build and only clones what you need:
| What you're building | Components installed | |---------------------|---------------------| | WhatsApp AI agent | GoClaw + bridge server + WhatsApp bridge | | AI agent (other channels) | GoClaw + bridge server | | Ollama endpoint only | Bridge server only |
Already have some components? The wizard skips what you've already got.
CLI Commands
npx claude-starburst # Interactive setup wizard
npx claude-starburst --detect # Check environment (node, docker, claude, redis)
npx claude-starburst --start # Start an existing stack
npx claude-starburst --stop # Stop the stack
npx claude-starburst --test # Run health checks against running stack
npx claude-starburst --help # Show all optionsNon-Interactive Setup (CI / Agents)
Skip the wizard by passing an answers file:
npx claude-starburst --answers-file answers.json{
"setupType": "full",
"existing": "fresh",
"mcp": false,
"projectName": "mybot",
"bridgePort": 11437,
"goClawPort": 20011,
"waBridgePort": 3831,
"allowedPhones": ""
}MCP Tool Integration
Give Claude access to your own tools (calendar, CRM, database, APIs):
{
"mcp": {
"url": "https://your-app.com/mcp",
"key": "your-api-key"
}
}Compatible with any MCP server that accepts HTTP JSON-RPC POST requests.
After Setup: Link WhatsApp
docker logs claude-starburst-whatsapp -f— watch for the QR code- Scan with WhatsApp → Settings → Linked Devices → Link a Device
- Open GoClaw:
http://127.0.0.1:20011 - Set your agent system prompt in GoClaw
- Message your WhatsApp number — Claude replies
Use as an Ollama Endpoint
The bridge server works with any Ollama-compatible tool, not just GoClaw:
# curl
curl http://localhost:11437/api/chat \
-H "Content-Type: application/json" \
-d '{"model":"claude-code","messages":[{"role":"user","content":"hello"}]}'
# Point Continue.dev, OpenClaw, or any Ollama client at:
OLLAMA_HOST=http://localhost:11437Available models: claude-code, claude-code-main, claude-code-haiku, claude-code-fast
Architecture: Component Repos
Claude Starburst is a thin CLI that git-clones focused component repos:
| Component | Repo | What it does |
|-----------|------|-------------|
| CLI | kaissaglobal/claude-starburst | The npx setup wizard |
| Bridge server | kaissaglobal/claude-starburst-server | Ollama API → Claude CLI |
| WhatsApp bridge | kaissaglobal/claude-starburst-whatsapp | WhatsApp ↔ GoClaw via Baileys |
| GoClaw template | kaissaglobal/claude-starburst-goclaw | Pre-configured Docker compose |
License
Solo Developer License — free for one person, one Claude subscription, one deployment.
Not licensed for teams, agencies, or enterprise use. See LICENSE.
Commercial licensing: [email protected]
