Graph-powered code intelligence — multi-agent coding with codebase-aware AI
$git clone https://github.com/proxysoul/soulforgeInstalls into the current project.
Install soulforge by running `git clone https://github.com/proxysoul/soulforge`, then use it for the current task and follow its documentation at https://github.com/proxysoul/soulforge.
| 1 | <div align="center"> |
| 2 | |
| 3 | <img src="assets/empryo-mark.png" width="150" alt="Empryo" /> |
| 4 | |
| 5 | # Empryo |
| 6 | |
| 7 | <sub>previously **SoulForge**</sub> |
| 8 | |
| 9 | **Graph-powered code intelligence — multi-agent coding with codebase-aware AI.** |
| 10 | |
| 11 | [Website](https://empryo.com) · [Download](https://empryo.com/download) · [Changelog](https://empryo.com/changelog) · [Discussions](https://github.com/proxysoul/soulforge/discussions) · [Discord](https://discord.gg/fX4H7GYSMJ) |
| 12 | |
| 13 | <img alt="Empryo terminal UI" src="assets/TUI-1.png" width="880" /> |
| 14 | |
| 15 | </div> |
| 16 | |
| 17 | --- |
| 18 | |
| 19 | **SoulForge is now Empryo** — the same symbol-level, graph-powered agent, rebuilt with a desktop app, a faster engine, and a composable core. Development continues on Empryo; this repository is its home for issues and discussions. |
| 20 | |
| 21 | ## What is Empryo? |
| 22 | |
| 23 | Empryo understands your codebase as a **graph**, not a pile of text. It parses your repo with tree-sitter, ranks symbols with PageRank and git co-change, and edits code at the **symbol level** — so it reads what matters and changes exactly what it means to. |
| 24 | |
| 25 | It runs in a fast terminal UI, a native desktop app, and a scriptable headless mode. **Free to use** — bring your own provider key, or run fully local with Ollama. Your code never leaves your machine. |
| 26 | |
| 27 | <div align="center"> |
| 28 | <img alt="Empryo desktop app" src="assets/desktop-2.png" width="880" /> |
| 29 | </div> |
| 30 | |
| 31 | | | | |
| 32 | |---|---| |
| 33 | | **Live code graph** | tree-sitter parse, PageRank + git co-change, blast-radius tags, FTS5 + trigram search | |
| 34 | | **Symbol-level editing** | AST edits via ts-morph (65+ ops, atomic batches) + structural edits across 30+ languages | |
| 35 | | **Multi-agent** | parallel explore/edit agents with a shared I/O cache | |
| 36 | | **Task router** | route each slot to a different model per tab — cheap to explore, strong to code | |
| 37 | | **Time machine** | every prompt is a checkpoint with a git tag; rewind and redo conversation *and* files | |
| 38 | | **22 providers** | Anthropic, OpenAI, Google, Groq, DeepSeek, Bedrock, Ollama, LM Studio … + any OpenAI-compatible | |
| 39 | | **Desktop app** | native window, embedded browser, and the full agent | |
| 40 | | **LSP + MCP** | 576+ language servers via Mason, any MCP server, 13 lifecycle hooks | |
| 41 | |
| 42 | Runs on **macOS, Linux, and Windows**. |
| 43 | |
| 44 | ## Install |
| 45 | |
| 46 | ```bash |
| 47 | # macOS / Linux |
| 48 | curl -fsSL https://empryo.com/install.sh | bash |
| 49 | |
| 50 | # Windows (PowerShell) |
| 51 | irm https://empryo.com/install.ps1 | iex |
| 52 | ``` |
| 53 | |
| 54 | ```bash |
| 55 | brew install proxysoul/tap/empryo |
| 56 | winget install ProxySoul.Empryo |
| 57 | ``` |
| 58 | |
| 59 | Desktop app and prebuilt binaries: [empryo.com/download](https://empryo.com/download). |
| 60 | |
| 61 | ```bash |
| 62 | empryo --set-key anthropic sk-ant-... # or run local with Ollama, no key |
| 63 | cd your-project |
| 64 | empryo |
| 65 | ``` |
| 66 | |
| 67 | ## Benchmarks |
| 68 | |
| 69 | Same models, same repo, same tasks — Empryo's graph does more with less. |
| 70 | |
| 71 | | | Empryo | Pi | |
| 72 | |---|:---:|:---:| |
| 73 | | Bugs fixed | **8 / 9** | 7 / 9 | |
| 74 | | Cost | **$1.13** | $1.58 | |
| 75 | | Wall-clock | **4m 16s** | 10m 0s | |
| 76 | | Input tokens | **1.09M** | 6.21M | |
| 77 | |
| 78 | Empryo navigates by symbols and call hierarchies instead of grep-and-read, so it takes fewer steps and burns fewer tokens. Full methodology and transcripts: [empryo.com/benchmarks](https://empryo.com/benchmarks) · reproduce it at [proxysoul/pi-vs-empryo-bench](https://github.com/proxysoul/pi-vs-empryo-bench). |
| 79 | |
| 80 | ## SoulForge |
| 81 | |
| 82 | SoulForge remains available to download and install, and we'll keep fixing bugs and critical issues. New features and active development move to Empryo. |
| 83 | |
| 84 | ```bash |
| 85 | brew tap proxysoul/tap && brew install soulforge |
| 86 | # or |
| 87 | bun install -g @proxysoul/soulforge |
| 88 | ``` |
| 89 | |
| 90 | ## This repository |
| 91 | |
| 92 | - **[Issues](https://github.com/proxysoul/soulforge/issues)** and **[Discussions](https://github.com/proxysoul/soulforge/discussions)** — the home for Empryo bug reports, questions, and ideas. |
| 93 | - The SoulForge source stays archived here under its existing license (see [`LICENSE`](LICENSE)). |
| 94 | |
| 95 | ## Sponsors |
| 96 | |
| 97 | <div align="center"> |
| 98 | |
| 99 | <a href="https://llmgateway.io/dashboard?ref=6tjJR2H3X4E9RmVQiQwK" title="LLM Gateway"> |
| 100 | <picture> |
| 101 | <source media="(prefers-color-scheme: dark)" srcset="assets/llmg-white.svg" |