Metadata-Version: 2.4
Name: apheris-foundry-sdk
Version: 0.2.0
Summary: Reference Python SDK for Apheris Foundry per-module CLIs.
Author: Apheris
License-Expression: LicenseRef-Apheris-Foundry-Software-License
Project-URL: License, https://www.apheris.com/docs/hub/hub-license.html
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.1
Requires-Dist: pydantic<3,>=2.4.0
Requires-Dist: pyyaml>=6
Dynamic: license-file

# Apheris Foundry SDK

Reference Python SDK for building Apheris Foundry per-module CLIs.

## Usage

Declare a task — a plain function plus a pydantic config model — and foundry
builds a typed CLI for it. See the [usage guide](docs/usage.md) to get started.

## Development

This project uses [pixi](https://pixi.sh) to manage the toolchain and environments.

```bash
pixi run install-dev   # install the git hooks (pre-commit + commit-msg)
pixi run test          # run the test suite
pixi run lint          # check formatting and lint with ruff
pixi run fix           # auto-fix formatting and lint issues
pixi run build         # build the wheel and sdist
```

Commits follow [Conventional Commits](https://www.conventionalcommits.org/); the
commit-msg hook enforces this via commitizen.

## Project structure

```text
src/apheris_foundry_sdk/   # SDK package
tests/         # test suite
docs/          # usage guide
```

## License

This package is licensed under the [Apheris Foundry Software License](https://www.apheris.com/docs/hub/hub-license.html). The full license text is also included in every published distribution as `LICENSE`.

## Support

Contact [support@apheris.com](mailto:support@apheris.com) for access and deployment assistance.
