archi-kb
Archi automates operations for scientific computing. It builds a knowledge graph from what a facility already writes down, such as documentation, meetings, tickets, wikis, catalogs, monitoring and code. Agents answer from that graph and cite the records they used. Automations read the same graph and propose actions. A person approves each action, and only then does the automation runtime, a separate process, carry it out. No agent holds a credential that can change an external system.
This package is Archi. You import it as archi. Do not install archi from
PyPI: that name belongs to an unrelated package.
Install
You need Python 3.12, docker or podman (with compose), and git.
Archi runs on the okg graph engine, which is not on PyPI, so it is
installed from its release file. In a virtual environment:
pip install "okg @ https://github.com/mitdbg/akmon/releases/download/v0.4.0/okg-0.4.0-py3-none-any.whl#sha256=18ccec94040e23bccae9b51274b6aafb5bfbb9d512dc6c37506d27fac31c1abc" archi-kb==3.0.1
First instance
archi init myteam --bundle cern-team # creates ./myteam and publishes a first graph
cd myteam
archi up # starts the graph, the MCP server and the chat
archi doctor # checks the instance; each failure names its fix
archi up prints the chat address, the admin login and the MCP endpoint.
MCP (Model Context Protocol) is how agents call the graph's tools.
- Chat needs a language model.
archi upuses an ollama running on the same host, or the one you name with--ollama-url. You can also add a model under Settings > Admin > Connections in the chat. - Agents such as Claude Code bring their own model. In the instance
directory, run
archi connect claude-code --write, then exportOKG_CHAT_MCP_TOKENfrom the instance's.envin the shell that starts the agent.
Bundles
| Bundle | For |
|---|---|
cern-team |
Any CERN team: documentation and meetings, with no credentials needed to start. |
cms-physics |
CMS physics: cern-team plus analysis notes, CDS records and physics TWiki pages. Needs CERN credentials. |
cms-comp-ops |
CMS computing operations: cern-team plus sites, storage, datasets, workflows and past incidents. Needs CERN credentials. |
cluster-manager |
Any cluster operator: documentation, tickets, and optionally Slurm, HTCondor and ServiceNow. |
Automations are optional packs. For example, --with ticket-triage adds
cited ticket triage to cms-comp-ops or cluster-manager. They run in an
okg runtime worker that you start yourself, as the documentation describes.
Documentation
Archi is released under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for archi-kb 3.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| archi_kb-3.0.1-py3-none-any.whl | Python 3 | none | any | Details for archi_kb-3.0.1-py3-none-any.whl |
Release files / archi_kb-3.0.1-py3-none-any.whl
| Download URL | archi_kb-3.0.1-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5d4b997126b9a4b78ddefc66d147a163d412c2a268b518f08bdfa3034807fa6b
|
|
BLAKE2b-256 checksum How to use checksums |
1524db1e06e38e0dd0c638f428ba5f0c4c7cc6a7629997f85ccfaa996fa4dc36
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.
Transparency logSecurity for archi-kb 3.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
1 file in this release has been uploaded with provenance metadata.
Attestation for archi_kb-3.0.1-py3-none-any.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
