Metadata-Version: 2.4
Name: holix-sdk
Version: 0.1.0
Summary: Stable public API for Holix extensions and host integrations
Project-URL: Homepage, https://holix-agent.ru
Project-URL: Repository, https://github.com/javded-itres/holix-sdk
Project-URL: Documentation, https://github.com/javded-itres/holix-sdk/blob/main/docs/en/EXTENSIONS.md
Project-URL: Issues, https://github.com/javded-itres/holix-sdk/issues
Author: Pavel Lukyanov
License-Expression: MIT
License-File: LICENSE
Keywords: agent,extensions,holix,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.12
Requires-Dist: holix>=0.1.21
Description-Content-Type: text/markdown

# holix-sdk

[![CI](https://github.com/javded-itres/holix-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/javded-itres/holix-sdk/actions/workflows/ci.yml)

**Separate installable package** — stable public API for [Holix](https://github.com/javded-itres/Holix) extension authors.

Holix core (`core.*`, `cli.*`) is internal. Extension packages import **only** `holix_sdk`.

## Install

```bash
pip install holix-sdk Holix
```

Requires [Holix](https://pypi.org/project/Holix/) `>=0.1.21` on PyPI.

## API version

```python
from holix_sdk import __api_version__
# Currently: 1
```

Breaking changes to the extension API happen only in major releases of `holix-sdk`.

## Quick example

```python
from holix_sdk import ExtensionBase, CAPABILITY_CLI
from holix_sdk.agent import AgentExtensionBase, SlashCommandSpec
from holix_sdk.host import AgentCommands
```

## Documentation

| Language | Guide |
|----------|-------|
| English | [docs/en/EXTENSIONS.md](docs/en/EXTENSIONS.md) |
| Russian | [docs/ru/EXTENSIONS.md](docs/ru/EXTENSIONS.md) |

## Development

```bash
git clone git@github.com:javded-itres/holix-sdk.git
cd holix-sdk
uv sync --group dev
uv run pytest -q
```

## Publish

Automated via GitHub Actions on tag `v*` — see [docs/PYPI.md](docs/PYPI.md).

```bash
# bump pyproject.toml + holix_sdk/version.py, then:
git tag v0.1.0 && git push origin v0.1.0
```

Local check:

```bash
uv build && uv run twine check dist/*
```

PyPI package name: `holix-sdk`.

## License

MIT — see [LICENSE](LICENSE).