A personal AI agent built on Electron, OpenHanako offers memory, personality, and autonomy, aiming for ease of use beyond traditional coding agents. It empowers everyday computer users by automating tasks, managing information, and facilitating collaboration through a user-friendly desktop application, making advanced AI capabilities accessible to a broader audience.

How It Works

OpenHanako utilizes an Electron framework for its desktop interface, featuring a custom memory system that naturally ages information and distinct personality templates for unique agent behaviors. Its core functionality includes a robust toolset enabling file operations, web browsing, code execution, and more. Agents leverage a community-driven skills ecosystem and can install new capabilities from sources like GitHub. A key architectural advantage is its multi-agent system, allowing multiple instances to collaborate via channels or delegate tasks, enhancing productivity. Security is addressed via a two-layer sandboxing approach, combining application-level PathGuard with OS-level isolation.

Quick Start & Requirements

Installation involves downloading pre-built .dmg (macOS) or .exe (Windows) files from the project's Releases page; Linux and mobile platforms are planned. Initial setup requires connecting to an OpenAI-compatible model provider (e.g., OpenAI, DeepSeek, Qwen, local models via Ollama) via API key and base URL during an onboarding wizard, which also guides model selection. Note that unsigned builds may trigger macOS Gatekeeper or Windows SmartScreen warnings, necessitating manual user overrides on first launch.

Highlighted Details

• Memory Management: Custom system with natural fading of older events.
• Agent Personalities: Customizable via templates for distinct behaviors.
• Multi-Agent Collaboration: Agents can communicate via channels or delegate tasks.
• "Desk" Feature: Integrated file and note management space supporting drag-and-drop and async collaboration.
• Autonomous Operation: Cron jobs and heartbeat monitoring enable scheduled tasks and background file checks.
• Security: Two-layer sandboxing (PathGuard + OS-level) for enhanced safety.
• Cross-Platform Bridging: Connects to Telegram, Feishu, and QQ bots for remote interaction.

Maintenance & Community

The provided README does not detail specific community channels (e.g., Discord, Slack), notable contributors, sponsorships, or a public roadmap.

Licensing & Compatibility

The project is licensed under the Apache License 2.0, which generally permits commercial use and modification. No specific compatibility restrictions for closed-source linking were mentioned.

Limitations & Caveats

Windows support is currently in Beta, and Linux/mobile platforms are planned but not yet implemented. macOS Intel versions are untested. Unsigned application builds require manual user intervention to bypass security warnings on initial execution.