Aicademy CLI

Practice CKA, CKAD, and CKS exam scenarios locally — powered by KIND + Aicademy API.

Installation

Using pip

pip install aicademy

Using uv (recommended)

uv tool install aicademy

Using pipx

pipx install aicademy

Quick Start

# 1. Login to Aicademy
aicademy login

# 2. Check / install prerequisites
aicademy install-tool all --check
aicademy install-tool all

# 3. Start a practice question (creates KIND cluster automatically)
aicademy question start cka-01

# 4. Read the full task instructions in your terminal
aicademy question instructions

# 5. Solve the scenario using kubectl, helm, etc.

# 6. Verify your solution
aicademy verify

# 7. Clean up the cluster
aicademy question clear

Command Reference

Command	Description
`aicademy login`	Authenticate (browser flow or direct token)
`aicademy logout`	Clear stored credentials
`aicademy auth whoami`	Verify token validity
`aicademy question start <id>`	Start question environment (creates KIND cluster)
`aicademy question instructions [id]`	Show full task instructions in terminal
`aicademy question instructions [id] --web`	Open question page in browser
`aicademy question clear [id]`	Delete KIND cluster and clear session
`aicademy verify [id]`	Run verify.sh and report result
`aicademy install-tool <name>`	Install kubectl / kind / docker / all
`aicademy install-tool <name> --check`	Check if tool is installed (no install)
`aicademy install-tool <name> --dry-run`	Preview install commands

Prerequisites

Tool	Purpose	Install
Docker	Runs KIND nodes	`aicademy install-tool docker`
kubectl	Kubernetes CLI	`aicademy install-tool kubectl`
kind	Local K8s cluster	`aicademy install-tool kind`

OS Support

OS	Package Manager
Windows	winget
macOS	Homebrew
Linux	Official shell scripts

Exam	Slug	Questions	Free
Certified Kubernetes Administrator	`cka`	20	10
Certified Kubernetes Application Developer	`ckad`	20	10
Certified Kubernetes Security Specialist	`cks`	20	10

Development

Project Structure

The codebase is organized modularly:

aicademy_cli/main.py: The entry point and top-level Typer application.
aicademy_cli/commands/: All user-facing Typer CLI groups (auth, question, tools, verify).
aicademy_cli/api.py: Centralized HTTP requests and error handling.
aicademy_cli/core/: Internal logic like cluster management (kind.py) and helper methods (utils.py).

Using uv

# Clone and install in dev mode
git clone https://github.com/devcrypted/aicademy-cli
cd aicademy-cli
uv sync

# Run against local dev server
AICADEMY_API_URL=http://localhost:5173 uv run aicademy login

# Run tests
uv run pytest

# Lint
uv run ruff check .
uv run mypy aicademy_cli/

Publishing to PyPI

Publishing is 100% automated via GitHub Actions (ci.yml) using Trusted Publishing.

To release a new version:

Update the version in pyproject.toml (e.g., version = "0.1.2").
Commit and push the change to the main branch.
The CI pipeline will automatically run tests, build the package, publish it to PyPI, and create a GitHub Release with the corresponding vX.X.X tag.

Security

CLI tokens stored in ~/.aicademy/config.json
Tokens expire after 7 days — run aicademy login to renew
Question tasks and scenarios only delivered when you have an active session (anti-scraping)
Revoke all tokens with aicademy logout

License

MIT © Aicademy

Metadata

Release files for aicademy 0.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aicademy 0.5.3
File	Size	Uploaded
aicademy-0.5.3.tar.gz	255.4 kB	Aug 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aicademy 0.5.3
File	Interpreter	ABI	Platform	Reset
aicademy-0.5.3-py3-none-any.whl 61.5 kB Aug 30, 2026	Python 3	none	any	Details

Total release size: 316.9 kB

Release files / aicademy-0.5.3.tar.gz

Download URL	aicademy-0.5.3.tar.gz
Size	255.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`e933904469af2fd830d79d81d084e91f4eea1e68b2f117144ccb4a75ad38e2fc`
BLAKE2b-256 checksum How to use checksums	`5eb6ee3be3731e2c0212708b0c7565b9f154a1ea802e26f80a69fef6e04a764e`
Upload date	Aug 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/devcrypted/aicademy-cli
Publishing commit: github.com/devcrypted/aicademy-cli/tree/d3c042dca47714b858d935e5fdae1caf1ada419d

Workflow

Publishing configuration: github.com/devcrypted/aicademy-cli/blob/d3c042dca47714b858d935e5fdae1caf1ada419d/.github/workflows/publish.yml
Publishing logs: github.com/devcrypted/aicademy-cli/actions/runs/33310485796/attempts/1

Artifact

Subject: aicademy-0.5.3.tar.gz
SHA-256 checksum: e933904469af2fd830d79d81d084e91f4eea1e68b2f117144ccb4a75ad38e2fc Verifying attestations

Release files / aicademy-0.5.3-py3-none-any.whl

Download URL	aicademy-0.5.3-py3-none-any.whl
Size	61.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5717eb7da5b3ab4204bb5bd9a270bd5ccafb8c830ffe27c14b1a21f180da1394`
BLAKE2b-256 checksum How to use checksums	`a56493e9277b83398f5089720d9891551d06a47780ed65637df25619260db9a0`
Upload date	Aug 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/devcrypted/aicademy-cli
Publishing commit: github.com/devcrypted/aicademy-cli/tree/d3c042dca47714b858d935e5fdae1caf1ada419d

Workflow

Publishing configuration: github.com/devcrypted/aicademy-cli/blob/d3c042dca47714b858d935e5fdae1caf1ada419d/.github/workflows/publish.yml
Publishing logs: github.com/devcrypted/aicademy-cli/actions/runs/33310485796/attempts/1

Artifact

Subject: aicademy-0.5.3-py3-none-any.whl
SHA-256 checksum: 5717eb7da5b3ab4204bb5bd9a270bd5ccafb8c830ffe27c14b1a21f180da1394 Verifying attestations