The Path › Chapter 1 of 9
Install awdk
one command, then proof it worked
Teach
What you are installing
awdk — Aither World Dev Kit — is one program with many verbs. Everything in this guide runs through it: starting a brain (adk quickstart-local), chatting (adk chat), building an agent (adk init), installing packs (adk install). One install, and the rest of the chapters are verbs of the same command.
The command is called adk. Short for agent dev kit; it is the same thing.
What "pip" is
Most of the kit is written in Python, and pip is Python's installer — the way apt installs on Ubuntu or the App Store installs on a phone. pip install awdk downloads the kit from PyPI (the public Python package index) and puts adk on your PATH, which is the list of folders your terminal searches when you type a command.
That last part matters: a terminal reads PATH when it opens. If adk is "not found" right after installing, the window you are in is simply older than the install. Open a new one.
What the wizard does
adk wizard asks a handful of questions and writes one small config folder in your home directory, ~/.aither/. Pressing Enter accepts every default, and the defaults are right for this guide. It changes nothing else on your machine.
What the doctor does
adk doctor is a list of checks, one per line, each ending in OK, WARN or FAIL. It does not guess; it tries the thing and reports. Any time something is odd later in the guide, this is the first command to run. A WARN about not being logged in is expected — we do that in chapter 3, and only if you want to.
Do
Type each line, press Enter, and compare with what you should see.
pip install awdk
You should see: Successfully installed awdk
If not: If pip is not found, install Python from python.org first (tick 'Add to PATH'), then open a NEW terminal and try again - or use one of the two one-liners below, which install Python for you.
curl -fsSL https://aitherium.com/install.sh | sh
You should see: macOS / Linux only - the installer walks through Python, the kit and a first check
If not: Skip this if pip install awdk already worked; it is the same kit.
irm https://aitherium.com/install.ps1 | iex
You should see: Windows only (PowerShell) - the same installer
If not: Skip this if pip install awdk already worked.
adk wizard
You should see: a short questionnaire; answer with Enter to accept the defaults
If not: If adk is not found, close the terminal and open a new one - the install changed your PATH and the old window does not know.
adk doctor
You should see: every line ends in OK (a WARN about a cloud login is fine - we have not logged in yet)
If not: Read the first line that is not OK; it names the fix. Nothing below it matters until that one is green.
Check you are done
adk doctor
You should see: no FAIL lines
What you learned
- pip installs Python programs; awdk is one.
- The wizard writes a small config in your home folder (~/.aither/). Nothing else changes.
adk doctoris the question you ask whenever something is odd: it checks, it does not guess.