Quickstart
From an empty machine to a cited answer from your team's knowledge graph,
with the cern-team bundle: five user commands, the same ones the nightly
build runs (the cd is not counted, and the fifth is a check).
You need: docker or podman (with compose), Python 3.12 (CI tests 3.12; akmon 0.6.0 does not install on 3.14),
and git. No account, key or root access.
With rootless podman, container health checks run from systemd user timers.
Where there is no systemd user session (inside a container, or on some
shared hosts), the checks may never run, and then archi up waits with no time limit.
Use docker there, or log in to a session with a systemd user manager.
pip install archi-kb==3.0.2
archi init myteam --bundle cern-team
cd myteam
archi up
archi doctor --json
python "$ARCHI_CHECKOUT/python/tests/cli/mcp_cited_answer.py" "What is the Knowledge Bases and Agents for CERN workshop?"
What each command does:
- Install.
okgis the knowledge-graph engine; its PyPI package isakmon.archi-kbis Archi. The import name isarchi. Both come from PyPI: installingarchi-kbinstalls a matchingakmon(0.6.x). Do notpip install archi: that name on PyPI is an unrelated package. Use a new virtual environment: one that still has the oldokgpackage needspip uninstall okgfirst, because both install the same files. archi init myteam --bundle cern-teamcreates./myteamas a git repository. It writes the settings, generates every secret into.env, starts the graph database and publishes a first graph. The default packs need no credential. (cd myteamthen moves into it.)archi upstarts the stack: graph database, chat database, MCP server and Open WebUI. It prints the chat address and the MCP endpoint.archi doctor --jsonruns every check and prints one JSON object. Each failure carries a fix line. Leave out--jsonfor plain lines.- The last command asks a question over MCP and succeeds only when the
answer cites graph records. The script is in the Archi repository, so set
ARCHI_CHECKOUTto a clone of this release (git clone --branch v3.0.2 https://github.com/archi-physics/archi). It needs themcpPython package. In daily use you ask in the chat instead, or connect an agent.
Check the result
archi doctorexits 0 when no check failed.- The last command prints the question, the record ids it cited and the source that wrote them.
- The nightly build runs these same commands on an empty runner and reports how long the whole path took (the target is 15 minutes). A test keeps this page and that build in step.
Where next
- What each command does, including a local model and a remote host.
- Connect an agent such as Claude Code.
- Add a source.
- Operate the instance.