mirror of
https://github.com/hanzoai/bot.git
synced 2026-11-01 18:02:28 +00:00
Update version across all platforms: - package.json: 2026.3.5 - Android: versionName 2026.3.5, versionCode 202603050 - iOS: CFBundleShortVersionString 2026.3.5, CFBundleVersion 20260305 - macOS: CFBundleShortVersionString 2026.3.5, CFBundleVersion 202603050
Hanzo Bot (iOS)
This is an alpha iOS app that connects to an Hanzo Bot Gateway as a role: node.
Expect rough edges:
- UI and onboarding are changing quickly.
- Background behavior is not stable yet (foreground app is the supported mode right now).
- Permissions are opt-in and the app should be treated as sensitive while we harden it.
What It Does
- Connects to a Gateway over
ws:///wss:// - Pairs a new device (approved from your bot)
- Exposes phone services as node commands (camera, location, photos, calendar, reminders, etc; gated by iOS permissions)
- Provides Talk + Chat surfaces (alpha)
Pairing (Recommended Flow)
If your Gateway has the device-pair plugin installed:
- In Telegram, message your bot:
/pair - Copy the setup code message
- On iOS: Hanzo Bot → Settings → Gateway → paste setup code → Connect
- Back in Telegram:
/pair approve
Build And Run
Prereqs:
- Xcode (current stable)
pnpmxcodegen
From the repo root:
pnpm install
pnpm ios:open
Then in Xcode:
- Select the
Hanzo Botscheme - Select a simulator or a connected device
- Run
If you're using a personal Apple Development team, you may need to change the bundle identifier in Xcode to a unique value so signing succeeds.
Build From CLI
pnpm ios:build
Tests
cd apps/ios
xcodegen generate
xcodebuild test -project Hanzo Bot.xcodeproj -scheme Hanzo Bot -destination "platform=iOS Simulator,name=iPhone 17"
Shared Code
apps/shared/Hanzo BotKitcontains the shared transport/types used by the iOS app.