Features Overview¶
apcore-toolkit is a collection of framework-agnostic utilities designed to help you extract, refine, and export metadata from your existing codebase, making it "AI-Perceivable". Available for both Python and TypeScript.
Core Capabilities¶
| Feature | Description |
|---|---|
| Smart Scanning | Abstract base classes and utilities for framework-specific scanners. |
| OpenAPI Integration | Extract JSON Schemas directly from OpenAPI operation objects. |
| Schema Utilities | Flatten complex models (Pydantic / Zod) for easier AI interaction. |
| Output Writers | Export metadata to YAML bindings, Python wrappers, or direct Registry registration. |
| Formatting | Convert data structures into beautiful, human-readable Markdown. |
| AI Enhancement | Use local SLMs to automatically fill in missing metadata. |
Design Philosophy¶
- Framework Agnostic: The core logic has no dependency on specific web frameworks (Django, Flask, FastAPI).
- Separation of Concerns: Scanning (extraction), Schema Utilities (refinement), and Writers (export) are kept distinct.
- Developer First: Focuses on automating the tedious tasks of writing
apcore.yamlor@moduledecorators. - AI-Native: Built with the assumption that the ultimate consumer of this metadata is a Large Language Model (LLM) or AI agent.