AquinLabs

Install

Aquin ships as the aq CLI (TypeScript) plus a Python kernel. Needs Node ≥ 18, npm, and python3. After install run aq help, then aq doctor.

PrerequisiteNode ≥ 18 · npm · python3 · curl/tar for the release install

curl -fsSL https://github.com/Aquinf03/aq/releases/latest/download/install.sh | bash

Install the team release. Downloads aq-latestv.tar.gz into ~/.local/share/aquin-framework, runs npm install && npm link, and sets up the kernel venv.

FlagDescription
AQUIN_INSTALL_DIR Override install location (default ~/.local/share/aquin-framework).
AQUIN_RELEASE_URL Override the release tarball URL.
AQUIN_NO_RELEASE Skip the release download and use a local/source tree.
example
$curl -fsSL https://github.com/Aquinf03/aq/releases/latest/download/install.sh | bash

python3 -m venv aq/kernel/.venv

Create the kernel virtualenv in a checkout install.

example
$python3 -m venv aq/kernel/.venv
example
$aq/kernel/.venv/bin/pip install -r aq/kernel/requirements.txt

aq help

Short Unix-style help for the aq CLI.

example
$aq help

axi doctor

Health check: node, python, kernel, provider, train folder, skills, MCP. Exits 1 if any check fails.

FlagDescription
[dir] Optional train directory to validate.
example
$axi doctor

aq login

Sign in via the auth portal (or paste a token). Account tokens live in ~/.aquin/config.json. Provider API keys are separate under ~/.axi/config.json.

FlagDescription
--token aq-… Install an existing CLI token.
--check Print who is signed in.
example
$aq login
example
$aq login --token aq-…
example
$aq login --check
example
$aq logout
example
$aq switch

axi provider

Configure LLM providers for axi (openai, anthropic, grok, ollama). Keys in ~/.axi/config.json.

FlagDescription
axi provider <name> Save key and select provider.
axi provider use <name> Switch active provider.
example
$axi provider
example
$axi provider openai
example
$axi provider use anthropic