Skip to content

🚀 HugAgentOS Desktop 1.0.0

Choose a tag to compare

@github-actions github-actions released this 03 Aug 06:58
2a1a9d3

🚀 HugAgentOS Desktop 1.0.0

We are excited to introduce the first stable public desktop release of HugAgentOS: a cross-platform AI agent workspace that can run fully on your computer, connect to a team deployment, or combine cloud identity with a local execution environment.

This release brings the complete HugAgentOS Community Edition experience to Windows, macOS, and Linux, with an offline local runtime, project-based workspaces, governed tool integrations, and a native desktop experience.

🔖 Build note: the signed desktop artifacts retain the internal build number 0.2.9. This GitHub release marks the public 1.0.0 product milestone while preserving the existing artifact names, signatures, and updater metadata.

✨ Highlights

🧭 Run HugAgentOS your way

  • Local mode: run the Community Edition entirely on your computer. The installer includes a private Python 3.11 runtime and the local service payload, so no system Python, Docker, PostgreSQL, Redis, compiler, or dependency download is required.
  • Cloud mode: connect the desktop client to an existing HugAgentOS team deployment and keep data and execution on that server.
  • Dual mode: sign in with your cloud identity while routing selected chats, projects, sites, and execution tasks to a local execution plane.
  • Choose the preferred mode during first-run setup and change the server configuration later from the desktop menu.

🧠 A complete agent workspace

  • Stream multi-turn conversations with persistent history, file context, citations, feedback, and resumable runs.
  • Organize work with Projects and MySpace, including local folders, generated artifacts, and project-level instructions.
  • Use Plan Mode with an in-conversation plan tracker, explicit approval, progress reporting, and provider-aware reasoning controls.
  • Analyze uploaded files and create practical outputs such as documents, spreadsheets, presentations, PDFs, charts, and web artifacts.
  • Use built-in explorer, reviewer, and worker sub-agents for multi-step work.
  • Run local tasks with folder grants, human approval for sensitive commands, snapshots, and rollback safeguards.

🔌 Secure MCP marketplace

  • Discover curated MCP providers and community submissions from the capability center.
  • Install integrations with per-user credentials and OAuth support.
  • Protect secrets with encrypted storage and isolate installer credentials from publishers.
  • Block unsafe private or reserved network targets through SSRF-aware URL validation.
  • Surface tool risk before installation and stop integrations when a reviewed tool definition changes unexpectedly.
  • Support authenticated remote MCP servers through custom HTTP headers.

🖥️ Native desktop experience

  • Use the system tray to open a new conversation, check for updates, or keep HugAgentOS available in the background.
  • Open Quick Ask from anywhere with Ctrl+Shift+Space.
  • Receive native notifications when background automation finishes.
  • Install signed application updates from the built-in update checker.
  • Use platform-appropriate menus, title bars, close behavior, and display scaling.
  • Sign in through the system browser with a short-lived handoff ticket; the long-lived session token is never placed in the callback URL.

🛠️ Model, search, and reliability improvements

  • Added OpenAI Codex reasoning-provider support and more reliable streaming provider checks.
  • Added LangSearch as an internet-search provider.
  • Improved server-side attachment parsing and bounded previews for large files.
  • Fixed Plan Mode progress duplication, title generation, and chat-context state interactions.
  • Hardened Windows bootstrap, dependency locking, installer lifecycle, and local-runtime startup.
  • Improved macOS workspace paths, local shell startup, proxy handling, data placement, native title bars, and Retina/HiDPI scaling.
  • Added atomic local-runtime upgrades, health checks, data backups, and automatic rollback when activation fails.

📦 Downloads

Platform Package SHA-256
Windows x64 HugAgentOS_0.2.9_x64-setup.exe 1c0487580aaa99a39838a6d4a52d2ebb2164f73e0eecf9a51d2af1d91d9434d2
macOS Apple Silicon HugAgentOS_0.2.9_aarch64.dmg 4ed54acb5ee2ddaacccf15b2776c61c789a5151d9c4118b76a7cc9c04f0854b3
macOS Intel HugAgentOS_0.2.9_x64.dmg 929b2dae01c785541d0a3a1a6dbc77a7a62e4d69bbde25adfc74a6b9698520af
Linux x86_64 HugAgentOS_0.2.9_amd64.AppImage ecf8d82b010b360a52d73cef3a0fb21440568b0e2f3c04e796d6f0043ba0c914
Debian / Ubuntu x86_64 HugAgentOS_0.2.9_amd64.deb e1b8bd6ee18c6990bb022b106965ad7f1ca5d835a6421dae55dada173d6a6c3d

The .sig files, macOS .app.tar.gz archives, and latest.json are updater artifacts and are not needed for a normal first-time installation. Linux automatic updates use the AppImage package; users of the .deb package should install future versions manually.

🚀 Getting started

  1. Download the installer for your operating system from the assets below.
  2. Launch HugAgentOS and choose Local, Cloud, or Dual mode.
  3. For Local or Dual mode, allow the bundled local environment to initialize and pass its health check.
  4. For Cloud or Dual mode, enter your HugAgentOS server address and complete sign-in in the system browser.

Local mode stores application data on your computer. Updates replace application and service code while preserving user data; the desktop client also keeps recovery backups during local-service upgrades.

🍎 macOS installation note

The macOS packages in this release are ad-hoc signed but not Apple-notarized. On first launch, macOS may block the application because it cannot verify the developer. Open System Settings → Privacy & Security, find the HugAgentOS notice, and choose Open Anyway. Download packages only from this official repository.

🔭 Coming next: Evolution Console

The Evolution Console and its related personal-evolution controls are not included in this release. They are planned for the next version, together with further updates to review, approval, visibility, and control over how HugAgentOS learns from successful work.

❤️ Thank you for trying HugAgentOS 1.0.0. Bug reports, feature requests, and community contributions are welcome through GitHub Issues.