Skip to content

Add CLI binary for model inspection and tooling #105

@noahgift

Description

@noahgift

Summary

Add a CLI binary (aprender) for model inspection, conversion, and quality checking. This mirrors the alimentar CLI for data tooling.

Motivation

Currently aprender is library-only. Users need to write Rust code to inspect models. A CLI would enable:

  • Quick model inspection without code
  • CI/CD integration for model validation
  • Parity with alimentar data tooling CLI

Proposed Commands

aprender <COMMAND>

Commands:
  info      Display model information (architecture, params, size)
  convert   Convert between formats (apr, safetensors, gguf)
  inspect   Inspect layer weights and activations
  validate  Validate model integrity (no NaN, architecture valid)
  score     Quality score with letter grade (see #104)
  export    Export to deployment formats
  help      Print help

Examples

# Model info
aprender info model.apr
# Architecture: MLP [784, 128, 10]
# Parameters: 101,770
# Size: 407 KB
# Format: APR v1.2

# Convert formats
aprender convert model.apr --to safetensors -o model.safetensors

# Validate model
aprender validate model.apr
# ✓ Model loads successfully
# ✓ No NaN/Inf values
# ✓ Architecture valid

# Quality score (from #104)
aprender score model.apr --suggest

Implementation Notes

  • Add [[bin]] target in Cargo.toml
  • Use clap for argument parsing (like alimentar)
  • Reuse existing library functions for inspection/conversion

Acceptance Criteria

Related


🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions