Skip to content
Yggdrasil0.1.0-alpha.23

Docs

Yggdrasil is a local control plane. You install it, pick a model, and talk to it. The rest of this page is the part worth knowing before the first chat.

Install

Download the package for your computer. On a Mac, open the app. macOS builds are Developer ID signed and notarized. Windows builds are unsigned, so Windows may ask you to keep the file. On Linux, unpack the archive and run the app beside yggdrasil-daemon.

The first launch can offer a model that fits the machine. Chat waits until one is installed.

Chat

Replies stream in Markdown. Lists, links, and code render instead of showing the source. The window follows the newest line. Scroll up and it stays put until you jump back with Latest.

If the assistant needs the web, a file, or a command, you see a short status such as “Searching the web…”. The raw call stays out of the transcript. Afterward, “Used N tools” can be opened for the name, a short summary, and how long it took.

A ring beside Send shows how full the model’s window is for this chat. Open it for instructions, tools, the conversation, and tool results. Switching chats clears that readout. It is not saved with the conversation.

Capabilities

The General Assistant can use four groups. Turning one on lets the model use those tools without another prompt.

  • Internet searches the public web and can open a page. It uses DuckDuckGo. There is no separate weather service.
  • Files can find, read, and write files in the workspace.
  • Shell can run a command on this computer.
  • Git can inspect the repo, commit, and push.

A profile you already set to Ask or Deny keeps that choice. Profiles are the advanced way to change this. Most chats never need that screen. If Internet is off, the prompt does not mention the web, and the reply will say live web access is unavailable.

Models

Run on Automatic prefers a model that can call Yggdrasil tools when the question needs current information. Choosing This computer keeps the model you picked. A model that cannot call tools still cannot browse.

Local models run with an 8.2K token window, or a smaller one when the model itself is smaller. The context ring uses that running window, not a larger number printed on a model card.

Computers

Pair other computers on your network when you want a role to run somewhere else. That is how a heavier job can use a machine you already have plugged in.

A server without a desktop

The headless package is the daemon and the web UI, with no graphical shell.

tar -xzf yggdrasil-*-linux-amd64-headless.tar.gz
cd yggdrasil-*-linux-amd64-headless
./yggdrasil-daemon

Open http://127.0.0.1:7331 on that machine. The same port serves the local API.

Bugs and feature requests

Report a bug or ask for a feature on the releases repository. That repository also holds the installers.

Docs · Yggdrasil