Metadata-Version: 2.4
Name: khipu-x1
Version: 0.1.1
Summary: FPGA-first governed LLM accelerator software reference
License: Apache-2.0
Project-URL: Homepage, https://github.com/szl-holdings/khipu-x1
Project-URL: Source, https://github.com/szl-holdings/khipu-x1
Project-URL: Issues, https://github.com/szl-holdings/khipu-x1/issues
Project-URL: Changelog, https://github.com/szl-holdings/khipu-x1/releases
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE_POLICY.md
License-File: NOTICE
Requires-Dist: numpy>=1.26
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Dynamic: license-file

# KHIPU-X1

[![PyPI](https://img.shields.io/pypi/v/khipu-x1)](https://pypi.org/project/khipu-x1/) [![Python](https://img.shields.io/pypi/pyversions/khipu-x1)](https://pypi.org/project/khipu-x1/)

**FPGA-first governed LLM accelerator reference.**

This repository is a software reference and future hardware workspace. It is not
a fabricated chip and does not claim performance superiority.

Current implemented lane:

- KIDS v0.1 descriptor draft;
- deterministic NumPy simulator;
- minimal explicit graph lowering;
- safe `.khipu` package builder/verifier;
- SHA3-256 execution receipt chain;
- RC1 authorization-state emulator;
- conformance tests.

Current hardware status: **UNAVAILABLE — target FPGA not selected**.

## Quick start

```bash
python -m venv .venv
# Windows: .venv\Scripts\activate
# Linux/macOS: source .venv/bin/activate
python -m pip install -e ".[dev]"
pytest -q
khipu-x1 demo --out ./demo-output
```

Or without installing:

```bash
PYTHONPATH=src python scripts/demo.py --out ./demo-output
```

## Truth labels

- `SCAFFOLDED`: interface/document exists.
- `SOFTWARE_EMULATED`: reference code executed.
- `FPGA_MEASURED`: only after exact bitstream/device tests.
- `BLOCKED`: attempted path refused with evidence.
- `UNAVAILABLE`: capability does not exist or was not measured.

## Program boundary

One owner prototype only. No production tooling, mass-production order or ASIC
tapeout is authorized by this repository.
