mirror of
https://github.com/wu736139669/hapi.git
synced 2026-11-18 03:27:08 +00:00
Merge release tag v0.34.1 into the local deployment fork. Preserve local features (Agent Team, Studio, session shares, skins, DSH Web runtime, attachment cache, deploy tooling) while adopting upstream session-list, composer, steering, model-catalog, native-client, and migration changes. Regenerate the local chat_attachments migration as v31→v32 behind the upstream v28-v31 ladder; keep DSH on the Web runtime instead of the ACP transport added upstream. Co-Authored-By: Claude Code <noreply@anthropic.com> Co-Authored-By: HAPI <noreply@hapi.run>
73 lines
3.9 KiB
Markdown
73 lines
3.9 KiB
Markdown
# HAPI
|
|
|
|
Run official Claude Code / Codex / Cursor Agent / DeepSeek Harness / Grok Build / OpenCode / Kimi / Copilot / Antigravity / Pi sessions locally and control them remotely through a Web / PWA / Telegram Mini App.
|
|
|
|
> **Why HAPI?** HAPI is a local-first alternative to Happy. See [Why Not Happy?](docs/guide/why-hapi.md) for the key differences.
|
|
|
|
## Features
|
|
|
|
- **Seamless Handoff** - Work locally, switch to remote when needed, switch back anytime. No context loss, no session restart.
|
|
- **Native First** - HAPI wraps your AI agent instead of replacing it. Same terminal, same experience, same muscle memory.
|
|
- **AFK Without Stopping** - Step away from your desk? Approve AI requests from your phone with one tap.
|
|
- **Your AI, Your Choice** - Claude Code, Codex, Cursor Agent, DeepSeek Harness, Grok Build, OpenCode, Kimi, Copilot, Antigravity, Pi—different agents, one unified workflow.
|
|
- **Terminal Anywhere** - Run commands from your phone or browser, directly connected to the working machine.
|
|
- **Voice Control** - Talk to your AI agent hands-free using the built-in voice assistant.
|
|
- **Workspace Browser** - Opt-in via one or more `hapi runner start --workspace-root <path>` flags: browse scoped file trees from the web and start sessions in allowed subdirectories.
|
|
|
|
## Demo
|
|
|
|
https://github.com/user-attachments/assets/38230353-94c6-4dbe-9c29-b2a2cc457546
|
|
|
|
## Getting Started
|
|
|
|
```bash
|
|
npx @twsxtd/hapi hub --relay # start hub with E2E encrypted relay
|
|
npx @twsxtd/hapi # run claude code
|
|
```
|
|
|
|
`hapi server` remains supported as an alias.
|
|
|
|
Use `hapi <agent> [options]` to start an agent directly, for example `hapi claude`
|
|
or `hapi codex`. Scripts must specify the agent explicitly. `hapi --help` shows
|
|
HAPI's commands and supported agents.
|
|
|
|
The hub displays a URL and two QR codes. Then connect a client:
|
|
|
|
- **Web / PWA (free):** open the web URL in a browser, or scan the web QR code. [Install it as a PWA](docs/guide/pwa.md) for a home-screen app and push notifications.
|
|
- **Native apps (paid):** install HAPI from the [App Store](https://apps.apple.com/app/id6805699104) or [Google Play](https://play.google.com/store/apps/details?id=run.hapi.companion), then scan the companion QR. See [Native apps](docs/guide/native-apps.md) for pairing.
|
|
|
|
> The relay uses WireGuard + TLS for end-to-end encryption. Your data is encrypted from your device to your machine.
|
|
|
|
For self-hosted options (Cloudflare Tunnel, Tailscale), see [Installation](docs/guide/installation.md)
|
|
|
|
## Docs
|
|
|
|
- [App](docs/guide/pwa.md)
|
|
- [How it Works](docs/guide/how-it-works.md)
|
|
- [Supported Agents](docs/guide/agents.md)
|
|
- [Voice Assistant](docs/guide/voice-assistant.md)
|
|
- [Why HAPI](docs/guide/why-hapi.md)
|
|
- [FAQ](docs/guide/faq.md)
|
|
|
|
## Clients
|
|
|
|
- **Web / PWA (free)** - The full-featured web app, including the remote terminal and voice assistant. Works in any browser and installs as a PWA. See [Web / PWA](docs/guide/pwa.md).
|
|
- **Native iOS / Android apps (paid)** - SwiftUI/UIKit and Kotlin Compose clients with chat, approvals, session creation, files, dictation, and native push notifications. See the [native app guide](docs/guide/native-apps.md) for capabilities and pairing.
|
|
|
|
<a href="https://apps.apple.com/app/id6805699104"><img src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" alt="Download on the App Store" height="48"></a>
|
|
<a href="https://play.google.com/store/apps/details?id=run.hapi.companion"><img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" alt="Get it on Google Play" height="72"></a>
|
|
|
|
Developers can build the apps from source: [iOS](ios/README.md), [Android](android/README.md). Protocol: [client contract](docs/api/client-contract/index.md).
|
|
|
|
## Build from source
|
|
|
|
Requires Bun 1.4.4.
|
|
```bash
|
|
bun install
|
|
bun run build:single-exe
|
|
```
|
|
|
|
## Credits
|
|
|
|
HAPI means "哈皮" a Chinese transliteration of [Happy](https://github.com/slopus/happy). Great credit to the original project.
|