The forge that shapes software. One tool. Twelve gates. Deterministic at the core.
Forge is a self-hosted LLM-powered execution framework built on a deliberate design: a single tool (forge) that compiles, executes, and destroys code across 12 language & logic gates, paired with an LLM orchestration layer. Generation and execution are strictly separated — the LLM brain writes code, the forge runs it, and the verdict feeds back.
The core philosophy is determinism by construction: the LLM is a live, statistical system that reasons in real time and can drift; the body is a deterministic program that enforces, verifies, and bails out. Every capability flows through one tool, so there are no hidden hooks and no magic.
- Single-tool architecture — every capability flows through one
forgetool; generated code is compiled, executed, and destroyed on the spot - 12 tool gates — python / go / sh / node / math / logic / regex / knowledge / tcm / browser / chain / self
- LLM brain + code body — the agent reasons in real time while the body stays deterministic;
chainorchestrates multi-gate pipelines,selflets the agent modify its own source (with approval) - Defense in depth — integrity guard, review gate, baseline checks
- Robust memory — atomic store (tmp + rename), fold/recall engine, event log
- Streaming LLM client — 3-tier reasoning effort, smart routing, provider config via
.env - Cross-platform — Windows first-class; platform files isolate OS specifics
git clone https://github.com/jinguanghai/forge.git
cd forge
cp .env.example .env # set DEEPSEEK_API_KEY (any OpenAI-compatible provider)
go build -o forge .
./forge| Gate | Engine | Purpose |
|---|---|---|
python |
Python 3 | general scripting, data & file processing (default) |
go |
Go | compiled execution |
sh |
shell | system commands |
node |
Node | JS/TS execution |
math |
CAS | symbolic computation & verification |
logic |
SMT solver | prove / equivalence / consistency checks |
regex |
regex engine | validation with fullmatch semantics |
knowledge |
KB query | knowledge-base retrieval |
tcm |
domain query | traditional Chinese medicine herb-pair lookup |
browser |
headless | web browsing (direct, no proxy) |
chain |
orchestrator | conditional multi-gate pipelines |
self |
hot-rewrite | modify its own source (requires approval) |
The body is a small Go program: agent.go orchestrates the LLM loop, forge.go implements the gates, llm.go streams from the provider, config.go owns configuration, ux.go renders the terminal. Session stats and display helpers live in their own files (stats.go, style.go) to keep responsibilities separated.
MIT