Glaux

Getting started

Requirements

  • Python 3.10+
  • A Rust toolchain — the ledger kernel and vector store are native crates built during install (rustup.rs)
  • AthenaDB, cloned as a sibling directory — the memory layers and the skill library are built on it, so the server does not start without it. install.sh checks for it before doing any work.
  • Node.js 18+ — to build the dashboard. Ubuntu's default nodejs package is older than this; install a current Node with nvm or NodeSource if the dashboard is skipped. The API and CLI work without it.

Install

Clone both repos side by side, then install from glaux:

git clone https://github.com/aniketshukla1/athenadb
git clone https://github.com/aniketshukla1/glaux && cd glaux
./install.sh

install.sh creates a virtualenv, installs dependencies, builds the native ledger kernel with maturin, installs the glaux command, and builds the dashboard.

To check the whole path on a pristine machine — the exact thing a new user hits — scripts/clean_install_test.sh runs it end to end in a clean container and verifies a signed ledger at the other side.

First run

./venv/bin/glaux up          # starts the server → http://127.0.0.1:8000

Open the dashboard, create an account (the first account is yours), and give it a goal. Or stay in the terminal:

glaux run "explain how a bloom filter works"
glaux chat                    # interactive session

Glaux works offline out of the box using the bundled demo backend. For real work, point it at a model:

glaux models                                   # what's available
glaux models --set ollama:qwen2.5:7b-instruct  # fully local
glaux models --set anthropic                   # needs ANTHROPIC_API_KEY

Prove it worked

Every step the swarm took was signed. Verify the chain:

glaux verify
# ✓ chain verified   ·   1,382 signed blocks

Turn on the capabilities you want

Glaux ships conservative. Enable what you need:

glaux workspace on     # let agents create real files in a jailed directory
glaux playbooks on     # expose authored playbooks to the swarm
glaux cache on         # semantic answer cache (skips repeat work)

Useful next steps

glaux status           # model, safety, ledger size, capabilities
glaux skills           # what it has learned to do
glaux evolution        # how it has improved its own routing
glaux --help           # everything

Where things live

State lives in GLAUX_HOME (default ~/.glaux): the ledger, memory, skills, workspace, playbooks, and logs. Delete it to start clean.

Next