Get started

Set up Golems - Autonomous AI Agents

Clone the monorepo

bash

git clone https://github.com/EtanHey/golems.git
cd golems && bun install

*Requires Bun runtime. The monorepo uses Bun workspaces for package management.

Set up environment

Copy the example env file and fill in your API keys. At minimum you need Supabase credentials and a Telegram bot token.

bash

cp .env.example .env
# Edit .env with your keys:
# SUPABASE_URL, SUPABASE_SERVICE_KEY
# TELEGRAM_BOT_TOKEN
# ANTHROPIC_API_KEY (optional for paid LLM)

Start the Telegram bot

The bot receives messages and routes them to domain golems via Grammy Composers.

bash

bun run packages/claude/src/telegram-bot.ts

*Runs locally on port 3847. Messages are routed to the appropriate golem based on command prefixes.

Launch the dashboard

A Next.js 16 web interface with 3D brain visualization, operations view, job matches, and token tracking.

bash

cd packages/dashboard && npm run dev

Configure Night Shift (optional)

Set up the launchd plist for automated coding improvements at 4am. Night Shift scans repos for TODOs, creates worktrees, implements changes, and ships PRs.

bash

# Copy the launchd plist
cp launchd/com.golems.night-shift.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.golems.night-shift.plist

*Night Shift requires CodeRabbit CLI for automated review gates.