Athena RS 3.25.0

current version: 3.26.3

Athena

Athena is the Rust gateway and runtime (core binary: athena_rs).

• athena_rs — the runtime, server, and library surfaces.
• athena — the CLI / toolchain that interfaces the athena_rs runtime and the APIs.

The athena CLI is the recommended way to interact with Athena (clients, SQL, pipelines, audit, provisioning, etc.). Just run athena with no arguments for a friendly guide.

Start here

• Docs hub
• Workspace scale
• Workspace manifest
• CLI manifest
• Crates overview and crate manifest
• Apps overview and app manifest
• Benches overview and bench manifest
• Examples overview and example manifest

Repository shape

• src/ holds the root athena_rs server/runtime and the Rust SDK surface.
• crates/ contains 29 package directories, including 28 root-workspace members and 1 adjacent crate.
• apps/ contains 8 operator, docs, desktop, marketing, and edge-delivery surfaces.
• sql/ contains runnable provision and migration SQL.
• docs/ contains repo-local architecture, runtime, and workspace documentation.
• openapi.yaml and openapi-wss.yaml capture the HTTP and WebSocket contracts.

Common workflows

• Inspect the runtime CLI from the repo root with cargo run --bin athena -- --help (or athena --help after building).
• Run Rust tests and heavier Rust verification from WSL2 on this machine rather than the Windows toolchain.
• Use the folder READMEs when changing one surface; use the MANIFEST files when you need the whole workspace map.

Deep reference

• Architecture and repo docs
• Route inventory
• HTTP OpenAPI
• WebSocket OpenAPI
• Product docs app content