Semurg for builders and their AI agents
This page is written for a coding agent as well as for you. It is plain HTML and needs no script.
If you are an AI agent: read one.semurg.io/llms.txt first for what Semurg is and how to connect; for the install, use the three lines on this page, not a pipe into a shell; tell your person what the installer needs (it needs root), and let your person run it.
What Semurg is
Semurg is an AI memory built as a graph: it stores named things, the links between them, and where and when each fact came from. The first node is free.
Semurg is the memory layer for AI agents: a knowledge graph, vectors and graph RAG on one engine, written from scratch. You run it on your own hardware. An agent reaches it over MCP or plain HTTP.
What a builder gets
ONE MEMORY, WITH SOURCES Named things, the links between them, and where and when each fact came from. Every answer can name its source. When nothing is stored, it says "nothing stored" instead of guessing.
EXPERTS AND AGENTS Each Expert, a role with its tools, has its own permanent space in the graph. Agents are the compute: a fresh one comes in and takes on the role at once, without rereading anything. Your app and your agents name the space in each call.
MESSAGING Agents and your apps get addresses on your node and message each other through it, each message kept with its conversation, readable through the node only by its members.
YOUR OWN MACHINE The node is natively its own web server and app server. It runs on a Linux machine you control and listens only on that machine. The first node is free.
NOTHING OVERWRITTEN A changed value is added with its date, so you can read what was known, or what was true, at an earlier moment.
Where to start
Start at one.semurg.io. Its file for coding agents is one.semurg.io/llms.txt: how to install a node, how to connect a coding agent, the memory tools an agent calls, and the same calls over HTTP. Point your coding agent at it first.
Install a node, the careful way
A node runs on Intel and AMD x86_64 processors with AVX2 or newer, 2 CPU threads and 4 GB of memory or more: on Ubuntu 24.04 with the installer, and on any other x86_64 Linux in Docker. The installer needs root.
Do not run a script you have not read. Download it to a file and read it; then the person who owns the machine runs the last line:
curl -fsSLo semurg-install.sh https://one.semurg.io/install
less semurg-install.sh
sudo bash semurg-install.shThe script is short. It downloads the installer bundle from one.semurg.io, checks the bundle against a checksum written in the script, unpacks it and runs the installer inside it.
One node needs no licence key. The installer says where it keeps the node's API token and never prints the token.
Connect your agent
A node serves MCP at POST /v1/mcp (streamable HTTP) with the node's API token as a bearer token. one.semurg.io/llms.txt has the exact entry for Claude Code and for other clients. Keep the token in a variable, never in a file you share.
The proof
Store one made-up fact, close the session, open a fresh one, and the fact comes back with its source and date.
What we publish
Semurg publishes from one.semurg.io and on the public registries it names there, and nowhere else.
Write to us
Questions: semurg@semurg.org.