AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing aduermael/herm in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Overview (README excerpt)
Crawler viewherm A coding agent CLI that's containerized by default. Every command runs inside a Docker container, nothing touches your host. No approval prompts, no "are you sure?" dialogs. Just let it work. Why herm? **Containerized by default** — The agent runs inside Docker containers with full control: installing packages, editing files, running builds. Your host machine stays untouched. No permission prompts, ever. **Multi-provider** — Use Anthropic, OpenAI, Gemini, or Grok. Switch models on the fly. **Self-building dev environments** — Need Python but it's not installed? herm extends its own container by writing Dockerfiles dynamically. Dev environments are scoped per project (git repo) and survive container restarts — the rebuilt image persists across sessions. **100% open-source** — Everything is open, including the system prompts. No hidden instructions, no black boxes. Read them, fork them, change them. Requirements • macOS (only platform tested so far — Linux should work but hasn't been verified yet) • Docker installed and running Install Quick install Homebrew From source Requires Go 1.24+. Quick Start You'll need an API key for at least one provider (Anthropic, OpenAI, Grok, or Gemini) — add it via the CLI on first run. Roadmap • OCI container support without Docker, using Apple's Containerization framework • Test and verify Linux support • Test and verify Windows support (WSL2 + Docker Desktop) Project Structure Test FAQ How is it different from Claude Code? > Claude Code runs directly on your host and needs your approval for every potentially dangerous action. herm runs everything in containers, so the agent can act freely without risking your system. herm also supports multiple model providers and ships its system prompts in the open. How is it different from OpenCode? > OpenCode is a great terminal AI assistant, but it runs on your host like most coding agents. herm's core idea is that containerization should be the default — not an afterthought. If the agent can't break anything, you don't need permission prompts. How is it different from Pi Coding Agent? > Pi focuses on extensibility through TypeScript plugins and a large ecosystem of community packages. herm takes a different bet: safety through containerization. Instead of asking users to manage permissions, herm sandboxes everything by default so the agent can operate autonomously. What is the logo supposed to represent? > It's an hermit crab called Herm, short for Herman. It represents the hermetic nature of the agent — everything sealed inside its shell. Dependencies herm is built on top of langdag, a Go library for managing LLM conversations as directed acyclic graphs with multi-provider support. This project originally started as a way to dogfood langdag. License MIT