Hanzo App

Hanzo App is an AI-powered developer platform that serves as both a web-based development environment (hanzo.app) and a macOS desktop assistant. Built with Next.js 15 and React 19 for the web front...

Overview

Hanzo App is an AI-powered developer platform that serves as both a web-based development environment (hanzo.app) and a macOS desktop assistant. Built with Next.js 15 and React 19 for the web frontend, with a native macOS layer via React Native and Xcode/CocoaPods. The web app provides a full IDE-like experience with AI chat, code editing (Monaco), project management, deployments, agents, and a template gallery. The desktop app adds system-level features like app launching, clipboard management, window management, and instant AI access via the Tab key.

Why Hanzo App?

Browser-based IDE: Monaco editor, file explorer, project management, deploy from browser

AI-first: Integrated chat panel, model selector (Zen models), agents, code generation

Desktop assistant: macOS native app with global hotkey (Tab), app search, clipboard manager

Full platform: Auth, billing, settings, admin, enterprise features, community gallery

Template system: Pre-built project templates with one-click deploy

Tech Stack

Web Frontend: Next.js 15.5 + React 19 + TypeScript 5.9

UI: Radix UI primitives + Tailwind CSS 4 + Lucide icons

Editor: Monaco Editor (via @monaco-editor/react)

Data: TanStack React Query, better-sqlite3 (local), jose (JWT)

Bundling: esbuild-wasm (in-browser bundling)

macOS Native: React Native + Xcode + CocoaPods

Tooling: Mise (bun, ruby, cocoapods), bun as JS runtime

Install: brew install --cask hanzo (desktop) or visit hanzo.app (web)

OSS Base

Repo: hanzoai/app. MIT License.

When to use

Building or deploying AI-powered applications through a web IDE

Using AI chat and code generation alongside a code editor

Managing projects, deployments, and templates from a unified dashboard

Running a macOS productivity assistant with AI capabilities

Prototyping with in-browser code execution (esbuild-wasm, QuickJS)

Hard requirements

Node.js / bun for the web app

macOS + Xcode + CocoaPods for the native desktop app

Mise for development environment management (bun, ruby)

Quick reference

Item	Value
Web URL	`https://hanzo.app`
Desktop Install	`brew install --cask hanzo`
Repo	`github.com/hanzoai/app`
Branch	`main`
Framework	Next.js 15.5 + React 19
License	MIT
Version	1.42.0

One-file quickstart

Web development

# Clone and install
git clone https://github.com/hanzoai/app.git
cd app
bun install

# Run development server
bun dev

# Build for production
bun run build

macOS native development

# Requires Mise (https://mise.jdx.dev/) and Xcode
mise plugin add cocoapods
mise settings experimental=true
mise install

# Run the macOS app
bun macos

Core Concepts

Architecture

hanzoai/app/
  app/                    Next.js App Router pages
    (public)/             Public-facing pages
    actions/              Server actions
    admin/                Admin dashboard
    agents/               AI agent management
    api/                  API routes
    auth/                 Authentication pages
    billing/              Subscription / billing
    chat/                 AI chat interface
    dashboard/            Main dashboard
    deployments/          Deployment management
    dev/                  Developer tools / IDE
    docs/                 Documentation pages
    enterprise/           Enterprise features
    gallery/              Template gallery
    integrations/         Third-party integrations
    login/ signup/        Auth flows
    nodes/                Node management
    playground/           Code playground
    pricing/              Pricing pages
    profile/              User profile
    settings/             App settings
    templates/            Project templates
  components/             React components
    chat-panel/           AI chat UI
    editor/               Code editor (Monaco)
    file-explorer/        VFS file browser
    deployment-card/      Deployment management
    model-selector.tsx    Zen model picker
    monaco-editor/        Monaco wrapper
    workspace/            IDE workspace
    ui/                   Shared UI primitives
  macos/                  Native macOS layer
    hanzo-macOS/          Swift/ObjC native code
    hanzo.xcodeproj/      Xcode project
    Podfile               CocoaPods dependencies
  lib/                    Shared utilities
  public/                 Static assets

Key Features

Web IDE:

Monaco-based code editor with syntax highlighting

In-browser JavaScript execution via QuickJS / esbuild-wasm

File explorer with virtual filesystem

Project templates and gallery

Deploy to Hanzo Platform from the browser

AI Integration:

Chat panel with Zen model selection

Agent management and orchestration

Code generation and debugging

Context-aware assistance

Desktop (macOS):

Global hotkey (Tab) for instant AI access

App search and launch

Clipboard manager

Window manager

Calendar integration with menu bar appointments

Custom AppleScript commands

Wi-Fi password retrieval, IP display, process killer

Emoji picker, notes scratchpad

Environment Variables

# Configure via .env (see .env.example)
# API keys for AI providers
# Auth configuration
# Database URLs

Troubleshooting

Issue	Cause	Solution
`bun macos` fails	Missing Mise/Xcode/CocoaPods	Install via `mise install` after setting up Mise
esbuild.wasm missing	postinstall script failed	Run `cp node_modules/esbuild-wasm/esbuild.wasm public/esbuild.wasm`
Build OOM	Large Next.js build	Set `NODE_OPTIONS=--max-old-space-size=4096`

hanzo/hanzo-chat.md - AI chat (LibreChat fork)

hanzo/hanzo-llm-gateway.md - LLM proxy for AI providers

hanzo/hanzo-studio.md - Visual AI workflow builder (ComfyUI fork)

hanzo/hanzo-platform.md - PaaS for deploying apps

hanzo/hanzo-extension.md - Browser/IDE extensions

On this page