Skip to content

Gormes Documentation

Install, configure, and operate Gormes from one Go-native runtime.

Use the fast path when you want first success. Use the section map when you need platform details, gateway workflows, exact reference, or contributor evidence.

Linux, macOS, WSL2, and Termux:

Terminal window
curl -fsSL https://gormes.ai/install.sh | bash
gormes doctor --offline
gormes setup
gormes chat

Prefer another path?

PathStart here
Windows PowerShellInstall on Windows
Termux on AndroidInstall on Termux
Inspect-first Unix installLinux and macOS install
Source buildBuild from source

Prefer the full terminal UI? Run gormes after setup. Need a scriptable one-shot turn? Use gormes chat -q "hello from Gormes".

I want to…Go to
Install and run my first turnQuickstart
Understand supported install pathsInstall
Configure providers, models, agents, workspaces, profiles, and bindings from the CLIConfigure
Run local chat, gateways, profiles, memory, and dashboardsOperate
Separate state by named profileProfiles and workspaces
Diagnose broken stateTroubleshoot
Look up commands, config, env vars, paths, status, or termsReference
Understand the runtime modelConcepts
Contribute to Gormes itselfBuild Gormes
Read upstream/source backgroundArchive & Research
  • Runtime-ready: CLI and offline TUI
  • Runtime-ready: provider-backed chat
  • Runtime-ready: SQLite memory and sessions
  • Runtime-ready: local dashboard
  • Runtime-ready: Telegram, Discord, and Slack gateways
  • More Hermes compatibility
  • Voice/TTS
  • MCP/plugin support
  • Package-manager installs
  • More gateways

See Status & Roadmap for the public readiness view. Deep implementation progress remains under Build Gormes.

The docs separate public readiness from implementation progress.

AreaAudienceUse it for
Quickstart, Install, Configure, Operate, TroubleshootUsers and operatorsFirst success, setup, day-two workflows, and diagnosis.
ReferenceOperators and contributorsExact commands, config keys, env vars, paths, status labels, and glossary terms.
ConceptsOperators and buildersStable mental models for runtime, memory, tools, gateways, and Hermes compatibility.
Build GormesContributors and agentsRoadmap, parity workflow, progress rows, generated queues, and architecture evidence.
Archive & ResearchResearchers and maintainersUpstream Hermes docs and agent-system research; not Gormes setup instructions.