跳到正文
GitHub·· 9 天前AI 评分62

Hadron 发布原生桌面多模型 LLM 集群工作区

s0lda/hadron

AI 导读

Hadron 是一个用 Rust 构建的原生 GPU 加速桌面工作区,把 Anthropic Claude、Google Antigravity、OpenAI、Ollama、OpenRouter 以及自定义编码 CLI 接入同一房间,智能体通过 @mentions 协作、共享上下文并委派任务。

正文

The Native Desktop Workspace for Multi-Provider LLM Swarms

Orchestrate Claude, Antigravity, OpenAI, Ollama, and CLI Agents in One Workspace

License Language UI Protocol Architecture

Hadron Orchestrated Multi-Provider Chat Workspace


⚡ What is Hadron?

Hadron is a native, GPU-accelerated desktop workspace built in Rust for orchestrated multi-provider LLM swarms. It brings models from Anthropic (Claude), Google Antigravity, OpenAI, Ollama, OpenRouter, and custom coding CLIs into a unified room where agents collaborate, exchange context, and delegate tasks using @mentions.

Behind the interface, agents (called Quarks) execute concurrently over a zero-CPU filesystem event bus (field.jsonl), work safely in isolated git worktrees, and submit code changes through an automated Merge Gate that runs tests before landing anything on main.


💡 Key Superpowers

  • 💬 Collaborative Multi-LLM Chat: Mix models in a single thread — @claude, @ollama, @agy, @openai, and many more see each other's output, share context, and execute parallel sub-tasks via Hub-and-Spoke orchestration.
  • 🛡️ Git Worktrees & Automated Merge Gate: Agents work in isolated git worktree branches. The Merge Gate automatically rebases onto main and runs your test suite before clean code lands.
  • ⚡ Native GPUI Desktop App: Lightning-fast GPU-accelerated UI with multi-tab PTY terminals, interactive git commit graph, live plan tracking, interactive 3D cosmic swarm visualizer, native interactive Mermaid diagram rendering, robust color emoji font fallbacks, and real-time multi-protocol token telemetry.
  • 🛠️ Hadron Forge & Developer Power Tools: 50+ built-in MCP developer capabilities — AST precision edits via blake3, isolated PTY terminals, headless browser testing, LSP code intelligence, background process supervision, automated git bisect, and flamegraph profiling. Detailed in Power Tools Suite.
  • 🧠 Persistent Nucleus Memory & Universal Absorption: Cross-session shared memory within a configurable budget (16/32/64/128 KiB), plus /absorb to seamlessly import memories, invariants, skills, and plans from .agents/, .claude/, .cursor/, .windsurf/, .kimi/, .superpowers/, and many more.
  • 🤖 Autonomous Headless Swarm Runner: Standalone non-interactive CLI runner (hadron run / hadron ci) for CI/CD automation, speculative shadow pre-testing, AST-aware rebase healing, and tiled multi-PTY terminals.
  • 🎯 Autonomous Swarm Control: Built-in slash commands (/goal, /loop, /absorb, /release, /git-init, /resume, /clear, /home, /canvas, /intercom, /dream, /timelapse, /radar, /baseline, /preview-rebase, /steer, /scout) and 25 bundled workflow & engineering skills (TDD, security review, architecture audit, systematic debugging, design specs).

🚀 Quick Start

Prerequisites

  • Rust: Toolchain (edition 2021, Rust 1.93+ required).
  • OS: Linux (X11/Wayland), macOS, or Windows (native MSVC or WSL2).
  • LLM Access: Any ACP agent (e.g. Claude Code), Antigravity, local Ollama, or API key for OpenAI / OpenRouter / Anthropic.

1. Install Hadron

# Install the full binary suite (--locked is mandatory)
cargo install --locked --git https://github.com/s0lda/hadron.git hadron

2. Launch in Any Repo

# Open or create a swarm workspace in your project directory
cd ~/dev/my_project && hadron

# Or execute headlessly in CI / terminal batch mode
hadron run "Implement user authentication with tests"
hadron ci --plan .hadron/docs/plans/<plan_name>

📚 Documentation & Deep Dives

Explore Hadron's mechanics, architecture, and developer guides in the /docs directory:

Section Description Links
📜 Changelog Release history & version notes Changelog
🕹️ Commands Full interactive chat commands reference Commands Reference
🏛️ Architecture 2-Tier Daemon/GUI split & Swarm Event Loop Decoupled Architecture · System Diagrams
⚛️ Concepts & Physics Particle Physics Mental Model & Glossary Physics Metaphor · Vocabulary
🛠️ Hadron Forge AST Edit-by-Hash & Developer Power Tools Edit-by-Hash Engine · Power Tools Suite
🌿 Development Building from Source & Git Worktrees Building from Source · Git Worktrees

🔌 Provider & Model Ecosystem

Hadron connects an expanding ecosystem of AI agents, local models, cloud APIs, and terminal tools into a single orchestrated workspace. Any binary, endpoint, or script matching supported protocol interfaces can be seated directly into your swarm:

  • 🤖 ACP (Agent Client Protocol): Resident agent processes with automatic session resumption, model selection, and tool execution.
  • 🌉 Custom SDK Bridges: Embedded adapters for SDK-based agent runtimes (such as Google Antigravity).
  • ☁️ Local & Cloud HTTP Endpoints: Zero-config connection to local model servers (Ollama, LM Studio) and cloud model aggregators or APIs (OpenAI, OpenRouter with 400+ models, or any OpenAI-compatible endpoint).
  • 💻 CLI & PTY Transports: Stdio wrappers (CliSpec) for terminal scripts and interactive PTY terminal seats alongside LLM agents in the chat room.

⌨️ Essential Keyboard Shortcuts

Shortcut Action
Ctrl+Tab / `Ctrl+`` Toggle focus between Chat Input and PTY Terminal
Ctrl+Shift+T / Ctrl+Shift+W New / Close Terminal Tab
Ctrl+PageDown / Ctrl+PageUp Next / Previous Terminal Tab (also Ctrl+Shift+] / Ctrl+Shift+[)
Alt+Left / Alt+Right Switch Chat column tabs (Chat / Log / Stats)
Alt+Shift+Left / Alt+Shift+Right Switch Quark Roster tabs (Active / All)
Alt+PageUp / Alt+PageDown Switch Right-Rail Inspector tabs (Terminal / Files / Changes / Plan / Visualizer)
Alt+Up / Alt+Down Cycle Telemetry & Stats time windows (Session / Week / Month / All)
Ctrl+J / Ctrl+K Move selection in Quark Roster
Ctrl+Alt+Enter Toggle selected Quark enabled / disabled
Ctrl+M / F10 Open App Menu overlay
F6 Cycle global permission mode (Ask / Write / Auto / Bypass)

📄 License & Community

来源:GitHub · github.com