Summary

Hope Agent is a personal AI assistant designed for ordinary users, offering a powerful, deeply integrated desktop GUI that remembers and grows with the user. It also functions as a self-hosted server and integrates with IM platforms, providing a unified, accessible AI experience across devices.

How It Works

A unified Rust core (ha-core) powers desktop (Tauri), server (Axum), and IDE (ACP stdio) modes. It employs advanced memory management using SQLite, FTS5, and vector search, featuring "dreaming" for organization, active recall, and user profiling. The system automatically generates reusable skills from tasks and handles long conversations via progressive context compression.

Quick Start & Requirements

• Users: Download pre-built binaries (macOS DMG, Linux AppImage, Windows EXE/MSI). Follow the initial setup wizard to configure LLM providers (API keys required) or install local models via Ollama.
• Developers: Clone the repo, run pnpm install, then pnpm tauri dev for development or pnpm tauri build for a production package. Requires Node.js, pnpm, and Rust.
• Links: GitHub Releases (for binaries), docs/, CHANGELOG.md, AGENTS.md.

Highlighted Details

• Multi-Platform Native GUI: macOS, Linux, Windows support with 12 interface languages.
• Extensive LLM & IM Integration: 36 LLM providers (OpenAI, Gemini, Anthropic, etc.) and 12 IM channels (Telegram, Discord, Slack, WeChat, etc.).
• One-Click Local Models: Installs Ollama and downloads models (Qwen, Gemma) seamlessly.
• Unified Core: Single Rust codebase (ha-core) for desktop, server, and IDE modes.
• Advanced Memory & Learning: Persistent, tiered memory; "dreaming" for organization; active recall; auto-generated skills; cross-session awareness.
• Flexible Deployment: Desktop app, headless server accessible via browser, or IDE backend.
• Workflow Tools: Plan Mode, Project containers, Agent Teams, Cron jobs, Dashboard, Recap reports.
• Security: Tool approval, optional Docker sandboxing, local data storage, config snapshots.

Maintenance & Community

The project is under active development. Community interaction occurs via GitHub Issues for bugs/features and Discussions for Q&A. A formal roadmap and documentation site are in preparation.

Licensing & Compatibility

Licensed under MIT, allowing for permissive commercial use and integration into closed-source projects.

Limitations & Caveats

Version 0.1.0 is available but not officially released with binaries; users must build from source. The Windows MSI installer requires further testing. The main branch is actively developed, indicating potential for ongoing changes.