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.2

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.2
File	Size	Uploaded
aicademy-0.5.2.tar.gz	254.5 kB	Aug 11, 2026	Details

Built distribution (wheel)

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

Total release size: 315.9 kB

Release files / aicademy-0.5.2.tar.gz

Download URL	aicademy-0.5.2.tar.gz
Size	254.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`f089fccd02e1db5069bf1e9b37361de27bedca9b1b121920ff51f0e7ae8042cc`
BLAKE2b-256 checksum How to use checksums	`6dbc62787ac5b05dac5999aa1c529c271fa9bd7ca15e2ae2d9236d009579f5ac`
Upload date	Aug 11, 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/b2abf97f81eef0c8b1aa20d2a40ffdefa75633d1

Workflow

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

Artifact

Subject: aicademy-0.5.2.tar.gz
SHA-256 checksum: f089fccd02e1db5069bf1e9b37361de27bedca9b1b121920ff51f0e7ae8042cc Verifying attestations

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

Download URL	aicademy-0.5.2-py3-none-any.whl
Size	61.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b237e8fcfefbdd48ca30f07d20c0817e23fa7902233aeddc82ddb213bf61afc5`
BLAKE2b-256 checksum How to use checksums	`f494154c64e2a06662538ae9898258f8b1ea024c142b2e0a17142441c9374bc5`
Upload date	Aug 11, 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/b2abf97f81eef0c8b1aa20d2a40ffdefa75633d1

Workflow

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

Artifact

Subject: aicademy-0.5.2-py3-none-any.whl
SHA-256 checksum: b237e8fcfefbdd48ca30f07d20c0817e23fa7902233aeddc82ddb213bf61afc5 Verifying attestations