Grok Build × Hermes
An integrated AI coding agent that merges Grok Build's terminal-based capabilities with the full Hermes Desktop feature set. One agent, two shells: your terminal and a rich desktop UI.
What it is
Grok Build x Hermes is the combined fork of two powerful agent frameworks. From Grok Build you get xAI's native agentic loop: code editing, shell execution, file operations, and a built-in terminal REPL. From Hermes Desktop you get a full desktop environment: multi-provider LLM routing, messaging gateways (Telegram, Discord, Slack, Matrix), a persistent memory system, skill management, cron-like scheduling, a 3-D spatial Office UI, auto-updates, and i18n support.
Run grok in your terminal for a fast, headless coding session, or launch hermes-desktop to manage your agents in a spatial workspace. Both share the same config, memory, and providers.
Everything you need
Code editing
Edit, refactor, and generate code in your terminal with Grok Build's agentic loop, all while leveraging Hermes Desktop's project-aware context.
Multi-model support
Route prompts to OpenAI, Anthropic, Google Gemini, xAI Grok, OpenRouter, Nous Portal, Qwen, MiniMax, Hugging Face, Groq, or any OpenAI-compatible endpoint.
Tool use & file ops
Read, write, search, and execute shell commands autonomously. Set up custom skills and reusable toolchains.
Memory system
Persistent project and user memory so the agent remembers your preferences, past work, and project conventions across sessions.
Scheduling
Schedule recurring tasks, reminders, and automated workflows. Run agents on a cron-like timer without manual intervention.
Messaging gateways
Connect via Telegram, Discord, Slack, or Matrix. Interact with your agent from any messaging platform.
3-D Office
A spatial desktop UI built with Three.js. Organize conversations, files, and agent sessions in a 3-D workspace.
Auto-updater
Stay current with automatic updates for both Grok Build and Hermes Desktop. New features land without manual intervention.
Internationalization
Full i18n support for the desktop UI. Choose your language and locale; community translations welcome.
Requirements
- Rust toolchain via rust-toolchain.toml (auto-detected by cargo)
- DotSlash for running bundled Hermes components
- protoc (Protocol Buffers compiler) for message serialization
- Python 3.11+ for Hermes agent plugins and skills
- LLM provider (OpenAI-compatible endpoint or cloud): OpenRouter, Anthropic, OpenAI, Google Gemini, xAI Grok, Nous Portal, Qwen, MiniMax, Hugging Face, or Groq
install
Clone the repo
git clone https://github.com/<your-username>/grok-hermes.git
cd grok-hermes
Run the install script
chmod +x install.sh && ./install.sh
This installs the Grok Build binary (or builds from source with cargo), runs the Hermes Desktop installer, applies branding changes (logo files in assets/, name strings in config), and sets up both agents.
Configure API keys
# Set your provider keys
echo 'GROK_API_KEY=your-key' >> ~/.grok/.env
echo 'ANTHROPIC_API_KEY=your-key' >> ~/.hermes/.env
echo 'OPENAI_API_KEY=your-key' >> ~/.hermes/.env
Add any provider keys you need (OpenRouter, Gemini, Groq, etc.) to ~/.hermes/.env and optionally ~/.grok/.env.
Start the agent
# terminal-only session
grok
# headless (API server)
grok --headless
# desktop UI (in another terminal)
hermes-desktop